Skip to main content
Glama
Ocular Microsaccade Rate & Fixational Fatigue Skill

Ocular Microsaccade Rate & Fixational Fatigue Skill

Official

Ocular Microsaccade Rate & Fixational Fatigue Skill

License: Apache-2.0 Python 3.10+ Zero Dependencies MCP Protocol Ready OpenClaw Certified

Zero-dependency sovereign personal agent skill for evaluating ocular fixational microsaccade rate (Hz), main sequence velocity kinetics, involuntary ocular drift, and mental vigilance fatigue.

flowchart TD
    GazeFixation["High-Resolution Visual Fixation Stream"] --> DetectMS["Microsaccade Detection (Amp 0.1-0.8 deg)"]
    DetectMS --> RateCalc["Microsaccade Rate (Hz = Count / Sec)"]
    DetectMS --> MainSeq["Main Sequence Ratio (Q = Vmax / Amp)"]
    GazeFixation --> DriftCalc["Involuntary Inter-Saccadic Slow Drift Velocity"]
    RateCalc & MainSeq & DriftCalc --> VigilanceEngine["Cognitive Alertness & Ocular Fatigue Engine"]
    VigilanceEngine --> Agent["OpenClaw / Hermes Personal Agent Intervention"]

Features

  • Deterministic Math: Pure Python standard library implementation with zero external dependencies.

  • Ocular Kinematics Standards: Implements validated equations for fixational microsaccade frequency, main sequence velocity scaling, and ocular drift velocity.

  • Mental Fatigue & Drowsiness Screening: Sensitive detection of central vigilance drops and microsleep risks during prolonged cognitive effort.

  • Model Context Protocol (MCP): Native JSON-RPC tool integration for LLMs and autonomous agents.

Related MCP server: ocular-tear-film

Quickstart

from client import OcularMicrosaccadeRateClient

client = OcularMicrosaccadeRateClient()
result = client.evaluate_microsaccade_dynamics(
    fixation_duration_sec=30.0,
    microsaccade_count=54,
    mean_amplitude_deg=0.35,
    mean_peak_velocity_deg_s=15.2,
    mean_drift_velocity_deg_s=0.32
)
print("Microsaccade Rate:", result["microsaccade_rate_hz"], "Hz")
print("Alertness Score:", result["fixational_alertness_score"])
print("Classification:", result["classification"])

License

Apache-2.0

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    B
    maintenance
    Enables deterministic analysis of accelerometer and gyroscope timeseries for 8–12 Hz microtremor spectral bands, postural stability, and central motor fatigue, returning stability scores and fatigue categorization for agent guidance.
    7
    MIT
  • A
    license
    Not graded
    quality
    B
    maintenance
    Enables agents to compute Ocular Protection Index and tear film breakup dynamics from NIBUT, blink rate, and incomplete blink data, producing digital asthenopia risk scores and ergonomic microbreak and blink-coaching guidance for extended screen work.
    7
    MIT
  • A
    license
    Not graded
    quality
    B
    maintenance
    Enables assessment of tear film breakup dynamics, Ocular Protection Index, blink behavior, and digital asthenopia risk during screen work, returning corneal exposure analysis and ergonomic microbreak/blink coaching recommendations.
    7
    MIT
  • A
    license
    Not graded
    quality
    B
    maintenance
    Enables LLMs and autonomous agents to compute validated pupillometric metrics—constriction velocity, amplitude percentage, and redilation rate—and assess autonomic balance and central nervous system alertness through deterministic JSON-RPC tools.
    7
    MIT