Results Analysis Guide

← Back to Home

# Results Analysis

Post-process tracking data, calculate kinematics (velocity/acceleration), analyze noise, and export results.

## 1. Loading Data

- Project Directory: Select the root folder of your project.
- Load Tracks: Reads the `ConvergeTrack` output files (CSV). Large datasets may take a few seconds to load.

## 2. Processing & Kinematics

Compute smooth derivatives for velocity and acceleration.

- Frame Rate: Set the recording FPS (e.g., 3000 Hz).
- Filter Width (Sigma): Gaussian kernel width for position smoothing (default 1.0).
- Acc Filter Width: Kernel width for acceleration smoothing.
- Calculate Kinematics: Runs the differentiation pipeline. Must be done before visualization or export.

## 3. Noise Analysis

### Optimize Filter Width

Click Analyze Noise Curve to automatically determine the optimal Gaussian filter width.

- Velocity/Acc Noise Tabs: Shows the "L-curve" of noise vs. filter width.
  The optimal point (red dot) identifies the Inflection Point. This represents the threshold where further filtering continues to degrade the real signal without significantly reducing the noise.
- Signal Check Tabs:
  - Pos Check: Compares Raw vs. Filtered trajectory.
  - Vel/Acc Check: Compares derived quantities against raw differencing.

## 4. Visualization

### 3D Plotting

- Color By:
  - Uniform: Single color (fastest).
  - Velocity/Acceleration Magnitude: Colors particles by speed or force (Jet colormap).
  - Track ID: Unique color per track.
- Show Top N Tracks: Slider to limit display to the longest tracks (reduces clutter).
- Visualize: Renders the 3D plot. Use mouse to rotate, scroll to zoom, right-click to pan.

## 5. Export

- Export to .mat: Saves the processed tracks, including position, velocity, and acceleration, to a MATLAB-compatible `.mat` file in the project's Results folder.