Skip to content

Comments

Add forward velocity gating to curriculum advancement#71

Merged
kuds merged 4 commits intomainfrom
claude/review-test-integration-IBvKl
Feb 22, 2026
Merged

Add forward velocity gating to curriculum advancement#71
kuds merged 4 commits intomainfrom
claude/review-test-integration-IBvKl

Conversation

@kuds
Copy link
Owner

@kuds kuds commented Feb 22, 2026

This pull request adds a new curriculum threshold for minimum average forward velocity to support more robust gating of locomotion training stages. It updates the curriculum logic, configuration, and tests to ensure that stage advancement now requires meeting this velocity threshold when specified.

Curriculum logic improvements:

  • Added min_avg_forward_vel as a new field in the StageThreshold class and updated its default value handling. [1] [2]
  • Modified the record_eval and should_advance methods to accept and process per-episode forward velocity data, and to enforce the forward velocity threshold when set. [1] [2] [3] [4] [5]
  • Updated the evaluation callback to collect forward velocity statistics from environment info and pass them to the curriculum manager.

Configuration changes:

  • Added min_avg_forward_vel to the Velociraptor locomotion stage config file and ensured it is parsed from config files into curriculum thresholds. [1] [2]

Testing enhancements:

  • Expanded curriculum tests to cover default and custom values for the new velocity threshold, including cases where advancement should be blocked or allowed based on forward velocity data. [1] [2]

Documentation updates:

  • Updated the project README.md to clarify the organization of training result files and to reference the new results directory for GIFs. [1] [2]

…ooks

Organize training results by species and algorithm in results/<species>/<algo>/
with GIFs and machine-readable summary.json files. Move existing GIFs from
Images/ into the new structure. Each notebook now calls save_results_json()
at the end of training to automatically persist metrics.

https://claude.ai/code/session_01VN2X7mivN5EPYq69rw1BqA
Replace ppo_apex.gif with the raptor balance GIF on the homepage
simulation preview. Also fix the mislabeled "SAC Stage 2" caption
to correctly read "PPO Stage 1 — Balance".

https://claude.ai/code/session_01VN2X7mivN5EPYq69rw1BqA
Prevent the raptor from passing stage 2 (locomotion) by simply standing
still and accumulating alive_bonus. Adds min_avg_forward_vel = 0.5 m/s
threshold that must be met alongside reward and episode length checks.

- Add min_avg_forward_vel field to StageThreshold dataclass
- Update should_advance() and record_eval() to track forward velocities
- Update CurriculumCallback to collect forward_vel from step infos
- Update thresholds_from_configs() to extract new field from TOML
- Add velocity gate to velociraptor notebook eval and stage summary
- Add 3 new tests for forward velocity gating scenarios

https://claude.ai/code/session_01VN2X7mivN5EPYq69rw1BqA
Split pytest, pytest-cov, and scipy out of [dev] into a new [test] extra
so CI and contributors can run tests with `pip install -e ".[test]"` without
pulling in linting/formatting tools. [dev] now includes [test] so existing
workflows are unaffected.

https://claude.ai/code/session_01V5ikATv6o1bCq5sfNy21yS
@kuds kuds merged commit 43150f9 into main Feb 22, 2026
6 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants