Skip to content

GaitPilot Web Applications Guide

Welcome to GaitPilot! Our platform provides two distinct web applications, each designed to give you a different perspective on your biomechanical data.

Here is a quick overview of what each tool does and how to best use them.

📺 1. The Tactical Field Dashboard (The "Macro" View)

Tactical Field Dashboard (To display this image, save a screenshot of the Google TV dashboard as web-tactical-dashboard.png in the docs/assets/ folder) What it is: A high-level mission and routing dashboard.

Best used for: Reviewing where you went and how you performed along the route. It plots the athlete’s exact GPS path on a map alongside their real-time telemetry (speed, acceleration, video overlays).

Why it matters: It allows coaches to look at a 5-mile run and say, "Your pace dropped significantly on this specific hill at mile 3, let's look at the data to see why."

How to use it:

  • Navigation: Click on the interactive map to see exactly where you were at a specific timestamp.
  • Playback: Use the timeline at the bottom to "play" through the session. You will see the marker move along the map in sync with your speed and acceleration graphs.
  • Analysis: Look for correlations. Did your acceleration drop at the same time your GPS shows you climbing a steep elevation?

🔬 2. The Biomechanical Review Station (The "Micro" View)

Biomechanical Review Station (To display this image, save a screenshot of the 3D avatar dashboard as web-biomechanical-review.png in the docs/assets/ folder) What it is: A clinical, 3D skeletal analysis tool.

Best used for: Diagnosing how your body moved. It strips away the map and focuses entirely on high-frequency (100Hz) joint and posture data to animate a 3D avatar. It tracks micro-movements like pelvic tilt, left-vs-right foot clearance, and step symmetry.

Why it matters: It answers the questions the map can't. A clinician can look at the avatar and say, "Your pace dropped on that hill because your right foot clearance was 15% lower than your left, indicating an antalgic limp or hip flexor fatigue."

How to use it:

Left Panel (Activity & Coaching Modes)

This panel lets you configure the AI's diagnostic strictness and visual heuristics by selecting your specific use case. * ⚡ Race Walk Mode: Hyper-focused on pelvic tilt and sacral obliquity. It strictly monitors flight-phase rules to ensure competitive race walkers aren't disqualified for lifting or bent knees. * 🩺 Clinical Rehab Mode: Highly sensitive to step symmetry, stance/swing ratio, and foot clearance. Best for diagnosing an antalgic limp, Trendelenburg sign, or uneven weight distribution after an injury. * 🛡️ Occupational / Tactical Mode: Focuses on truncal forward lean and high-impact heel strike braking. Ideal for military/police carrying heavy loadouts. * 🏃 General Fitness Mode: A balanced biomechanical overview prioritizing stride efficiency and energy expenditure. * Heatmap Legend: Shows the color coding used by the system (Green = Optimal > 95% Symmetry, Yellow = Minor Asymmetry, Red = Pathological Deviation < 85%).

Center Panel (The Avatar & Playback)

  • The Avatar: You will see a 3D stick-figure avatar recreating your exact body movements.
  • Views: Click the buttons below the avatar to switch between Posterior (Behind), Sagittal (Side), and Transverse (Top) views to spot bad posture from different angles.
  • Playback Controls: Use the scrubber to rewind, slow down to 0.25x speed, or pause at the exact moment a symptom occurs.

Right Panel (Live Telemetry & Diagnostics)

  • Telemetry Readout: Watch the live gauges for Pelvic Tilt, Yaw, and Foot Clearance. If the bars turn red, you have exited the "Optimal Symmetry" threshold.
  • Diagnostic Feed: At the bottom right, the AI coach outputs timestamped text alerts whenever it notices a pathological deviation.

How to Access Them

Both tools are hosted from your GaitPilot Local Server. Ensure your device is on the same WiFi network as the server PC, and enter the server's IP address into your browser: * The Tactical Field Dashboard: http://<SERVER_IP>:5173 * The Biomechanical Review Station: http://<SERVER_IP>:8000/dashboard