lightning-pose icon indicating copy to clipboard operation
lightning-pose copied to clipboard

Proposed config file changes for "project spec v1"

Open ksikka opened this issue 2 months ago • 0 comments

The context is aligning app / CLI directory structure.

To summarize the major changes:

  • No more paths to label files (csv_path) or video directory (videos_dir).
  • Ability to reference a TXT file of unsupervised training sessions.
  • Ability to reference CSV files that override default Session -> calibration and bbox mapping.
  • All paths are relative to data_dir.
  • data_dir remains an absolute path, but I plan to make it overrideable at runtime.

Field Mapping

  • videos_dir $\rightarrow$ unsup_sessions_list
    • Note: Videos are now always looked up from data_dir/videos
    • If an alternative storage location is required, users can use a symlink.
  • csv_file $\rightarrow$ label_file_key
  • bbox_file $\rightarrow$ use_bboxes AND session_bbox_file
  • camera_params_file $\rightarrow$ session_calibration_file

The new fields are described in their config file comments


This design is more flexible than my original proposal; it allows overriding default locations of calibration files and bboxes.

Added these doc sections which describe this PR's proposal.

calibrations: https://docs.google.com/document/d/1H9OCIRxlA5JggStAVtLR9RoW358I9ESojLeaepKqcsA/edit?disco=AAABuJdUFkM bboxes: https://docs.google.com/document/d/1H9OCIRxlA5JggStAVtLR9RoW358I9ESojLeaepKqcsA/edit?disco=AAABuJdUFkg

ksikka avatar Nov 10 '25 18:11 ksikka