Open source & building
RodentLimb is open source under the GNU AGPL-3.0. The app, every analysis and this manual are in one public repository:
github.com/seesaw-earth/RodentLimb
Where things are in the code
| Topic | Manual page | Source file |
|---|---|---|
| Pose inference, decoding, video reading | Pose model | PoseEngine.swift, PoseDecoder.swift |
| Cleaning, body length, signal tools | Pose model | PoseSeries.swift |
| Tail suspension | Tail suspension | TSTAnalyzer.swift |
| Cylinder test | Cylinder test | CylinderAnalyzer.swift |
| Gait | Gait analysis | GaitAnalyzer.swift |
| Parameters and defaults | Parameters | AnalysisModels.swift |
| Exports and methods text | Files & exports | Exporter.swift |
| Validation scripts | Validation | Tools/validation/ |
| English and Chinese text | — | L("English", "中文") calls in every view; L10n.swift |
Build from source
You need a Mac with Xcode 16 or later and an iPhone with iOS 17 or later. There are no third-party Swift packages.
bash
git clone https://github.com/seesaw-earth/RodentLimb.git
cd RodentLimb
python3 Tools/install_model.py --v2 /path/to/CylinderMousePoseV2.mlpackage.zip
open RodentLimb.xcodeprojIn Xcode, choose your signing team and run on an iPhone. The model weights are not in the repository; see MODEL_PROVENANCE.md.
Build this manual
bash
npm install
npm run docs:dev # live preview at http://localhost:5173/RodentLimb/
npm run docs:build # static site in docs/.vitepress/distPushing changes under docs/ to main publishes the site through GitHub Actions.
