Data organisation

Where Go2Kin puts things.

Note

The staging behaviour is changing (Pose2Sim staging is planned to move from processing time to recording time) — keep this page in step with the code.

The data root

Set via data_root in go2kin_config.json. Everything you record lives under it:

[data_root]/
  [project]/
    sessions/
      [session]/
        [trial]/
          video/            # raw downloads from each camera
            synced/         # trimmed, start-aligned MP4s + sync diagnostics
          processed/        # Pose2Sim staging + pipeline outputs
          trial.json        # calibration file name, participant, synced/processed flags

🚧 TODO: confirm the exact tree (where participant records live, trial subfolders) and document the trial.json fields.

The repo config/ folder

• config/calibration/ — charuco config and calibration results (calibration.json, plus the auto-exported camera_array_go2kin.toml).
• config/camera_profiles/ — per-camera settings that persist across sessions.
• config/settings_references/ — generated by the settings discovery tool.

Housekeeping

🚧 TODO: what's safe to delete (raw vs synced videos — automatic cleanup after a sync "pass" is on the roadmap), expected per-trial sizes, and backup guidance.