Update Main from Dev

CHANGELOG.md

@@ -9,6 +9,9 @@ v1.1
 - Added option for downloading pose pickle files. (#248)
 - Moved synchronization specific files to new module utilsSync.py. (PR #259)
 - Added main regression tests and sync unit tests. (PR #259)
+- Added tests for main pipeline regressions. (PR #290)
+- Added exhaustive calibration fallback. (PR #286)
+- Ensure utility file handles are closed. (#293)
 
 Previous Changes
 ================

README.md

@@ -39,3 +39,17 @@ These instructions are for Windows 10. The pipeline also runs on Ubuntu. Minimum
 ### Reproducing results from the paper 
 1) Data used in the OpenCap publication are available on [SimTK](https://simtk.org/projects/opencap). This dataset includes raw data (e.g., videos, motion capture, ground reaction forces, electromyography), and processed data (e.g., scaled OpenSim models, inverse kinematics, inverse dynamics, and dynamic simulation results).
 2) The scripts to process and plot the results are found in the `ReproducePaperResults` directory (see README.md in this folder for more details).
+
+# Tests
+
+The test suite validates core functionality of the OpenCap pipeline. To run the tests:
+
+### Prerequisites
+- OpenSim must be installed and accessible via `opensim-cmd` in your PATH
+- All submodules must be initialized and updated (`git submodule update --init --recursive`)
+- The conda environment must be activated
+
+### Running Tests
+Execute the following command from the root directory of the repository:
+```bash
+python -m pytest ./tests/

tests/conftest.py

@@ -0,0 +1,14 @@
+import os
+
+
+TESTS_DIR = os.path.dirname(os.path.realpath(__file__))
+REPO_DIR = os.path.abspath(os.path.join(TESTS_DIR, '../'))
+TEST_DATA_ROOT = os.path.join(TESTS_DIR, 'opencap-test-data')
+TEST_DATA_DIR = os.path.join(TEST_DATA_ROOT, 'Data')
+CALIBRATION_FIXTURE_DIR = os.path.join(TEST_DATA_DIR, 'calibration-fixtures')
+SYNC_2CAM_DIR = os.path.join(TEST_DATA_DIR, 'sync_2-cameras')
+LAB_5CAM_DIR = os.path.join(
+    TEST_DATA_DIR,
+    'labvalidation-fixtures',
+    'subject2_session0_5-cameras',
+)