gait_analysis.sourceFiles.readPoseFile

Inputs

filepath

Scalar path to a MAT file containing one current `labkitProject` envelope produced by Video Marker payload version 2. The reader loads only that named variable and never reopens the video.

Outputs

pose

Normalized scalar structure. coords is F-by-P-by-2 [x y] image coordinates; pointNames and skeleton preserve the Video Marker order; frameIndex is 1:F; time is derived from embedded frameRate; annotation status/source, calibration, video metadata, and units are preserved.

Errors

labkit_GaitAnalysis_app:PoseFileNotFound

filepath does not exist.

labkit_GaitAnalysis_app:UnsupportedPoseFile

filepath is not MAT.

labkit_GaitAnalysis_app:InvalidMarkerProject

The file is not a current Video Marker project or its coordinate/skeleton shapes disagree.

labkit_GaitAnalysis_app:MissingVideoMetadata

Embedded timing metadata is absent, invalid, or has a nonpositive frame rate.

Description

Video Marker MAT is the sole file-input contract for Gait Analysis. CSV, arbitrary workspace MAT variables, and legacy marker payloads are rejected because they do not jointly own timing, skeleton, calibration, and frame provenance. `computeGait` remains callable with an in-memory normalized pose for deterministic tests and GUI-free calculations.

Typical Call

pose = gait_analysis.sourceFiles.readPoseFile("walk.video_marker.autosave.mat");
assert(pose.ok && pose.frameRate > 0)