Jiminy-py

pid_kd = [3.0e-3, 3.0e-3, 3.0e-3, 3.0e-3, 3.0e-3, 3.0e-3, 3.0e-3, 3.0e-3, 3.0e-3, 3.0e-3, 3.0e-3, 3.0e-3]
[blocks_config.wrapper_kwargs]
augment_observation = true

Partially stack observation frames
[[blocks_config]]
wrapper_class = "gym_jiminy.common.wrappers.StackedJiminyEnv"
[blocks_config.wrapper_kwargs]
nested_fields_list = [
["t"],
["sensors", "ImuSensor"],
["targets"],
]
num_stack = 3


New features:
[gym] Add 'load_pipeline' utility to load pipeline from file.

Miscellaneous:
[gym] Use folder architecture for clarity and maintainability.

The environment pipeline design has been streamlined. It is not only more versatile and faster but also less buggy. It should be ready now to be used for real-world applications.

New features

* [gym_jiminy/common] Add 'AdaptLayoutObservation' that generalizes 'FilterObservation'. (835)
* [gym_jiminy/common] Add 'QuantityObserver' block. (838)
* [gym_jiminy/common] Enable env composition to augment the observation space with trajectory reference. (838)
* [gym_jiminy/common] Add 'ScaleObservation', 'ScaleAction' env pipeline wrapper blocks. (839)

Improvements

* [python/dynamics] Take into account stride offset when trajectory time is wrapping. (838)
* [python|gym_jiminy] More natural figure layout to improve readability. (837)
* [gym_jiminy/common] Do not permanently alter original simulation options with enabling debug and/or evaluation modes. (832)
* [gym_jiminy/common] Rewrite binary log file automatically when calling 'BaseJiminyEnv.stop' in debug or evaluation mode. (832)
* [gym_jiminy/common] Add previous action as input argument for evaluation policy callback. (832)
* [gym_jiminy/common] Automatic environment pipeline update. (832)
* [gym_jiminy/common] Improve numerical stability and speed of 'swing_from_vector'. (834)
* [gym_jiminy/common] Add support of 'none' in pipeline config files. (834)
* [gym_jiminy/common] Add 'ignore_unbounded' optional argument to flatten obs/act wrappers. (834)
* [gym_jiminy/common] Add 'compute_rpy' optional argument to mahony observer. (837)
* [gym_jiminy/common] Add 'compute_rpy' optional argument to deformation estimator. (837)
* [gym_jiminy/common] Add locking mechanism to trajectory databaset. (838)
* [gym_jiminy/common] More robust pipeline registration mechanism. (838)
* [gym_jiminy/common] Support string representation of enums in pipeline config. (838)
* [gym_jiminy/common] Faster env pipeline. (841) (842)
* [gym_jiminy/toolbox] Add support of arbitrarily nested task-settable env. (832)
* [gym_jiminy/envs] Add mirror mat to obs/action spaces. (832)

Patches and bug fixes

* [core] Fix symbol visibility issues for some classes on windows. (836)
* [core] Fix bindings and serialization of convex geometry meshes. (836)
* [core] Fix 'array_copyto' helper. (841)
* [python/viewer] Fix 'add_camera'. (831)
* [python/viewer] Use firefox instead of chromium for offscreen rendering with meshcat to fix rendering on MacOS VM. (832)
* [python/viewer] Fix support of '-' in robot name. (834)
* [python/viewer] Fix conversion of 'hppfcl.Convex' to Panda3D. (836)
* [gym_jiminy/common] Disallow switch between evaluation and training mode when a simulation is running. (832)
* [gym_jiminy/common] Fix replay if no simulation is running. (832)
* [gym_jiminy/common] Fix composed reward computation. (832)
* [gym_jiminy/common] Use metaclass instead of inheritence for abstract classes. (832)
* [gym_jiminy/common] Enable typing of the obs and action spaces for 'gym.Env'. (832)
* [gym_jiminy/common] Fix nested gym space helpers. (832)
* [gym_jiminy/common] Fix missing final state when writing eval/debug log. (834)
* [gym_jiminy/common] Fix 'quat_multiply' to support in-place operation. (834)
* [gym_jiminy/common] Add twist estimate in internal mahony state if estimated. (834)
* [gym_jiminy/common] Fix mahony filter leaky integration for very small time constant. (834)
* [gym_jiminy/common] Check IMU and flex frames not empty when adding Mahony filter. (834)
* [gym_jiminy/common] Fix base 'BaseJiminyEnv.stop' not called in pipeline. (834)
* [gym_jiminy/common] Support pipelines without any layer. (834)
* [gym_jiminy/common] Make sure that the initial PD controller state is within bounds. (835)
* [gym_jiminy/common] Fix trajectory file never closed if loading fails. (838)
* [gym_jiminy/common] Add composition wrapper before observer-controller blocks. (838)
* [gym_jiminy/common] Fix 'AdditiveMixtureReward' for 'order=inf'. (838)
* [gym_jiminy/common] Fix partially broken 'spaces.build_reduce'. (839)
* [gym_jiminy/rllib] Full refactoring to support ray-rllib 2.38. (832)
* [misc] Drop support of Python<3.10. (831)

This release introduces composition of termination conditions via a first-class abstraction, in the same way as generic quantities and reward components. Apart from that, the viewer now supports adding extra camera to the scene, including depth map. In the later case, the implementation has been heavily optimised for speed. It takes about 400us on a laptop with intel integrated chipset to render a 128 x 128 depth map. One last new important feature is the support of smooth random ground generation through 2D Perlin processes. Querying the ground height at multiple locations in a LIDAR fashion has also been optimised for speed. It takes about 5us for 100 points. Finally, some critical components has been sped up, notably quantity management and evaluation is now one order of magnitude faster (10% to 25% overhead compare to physics evaluation for a full set of about 20 reward and termination conditions), and the viewer should be about twice faster for both onscreen and offscreen rendering with Panda3D.



New features

* [core] All random processes are now differentiable. (799)
* [core] Add Perlin ground generators. (799) (823) (825)
* [python/viewer] Add support of user-specified extra cameras (rgb and depth). (826)
* [gym/common] Add multi-ary operator quantity. (814)
* [gym/common] Add termination condition abstraction. (812)
* [gym/common] Add support of termination composition in pipeline environments. (812)
* [gym/common] Add quantity shift and drift tracking termination conditions. (812)
* [gym/common] Add base roll/pitch termination condition. (813)
* [gym/common] Add base relative height termination condition. (813)
* [gym/common] Add foot collision termination condition. (813)
* [gym/common] Add safety limits termination condition. (814)
* [gym/common] Add robot flying termination condition. (815)
* [gym/common] Add power consumption termination condition. (816)
* [gym/common] Add ground impact force termination condition. (816)
* [gym/common] Add base odometry pose drift tracking termination condition. (817)
* [gym/common] Add motor positions shift tracking termination condition. (817)
* [gym/common] Add relative foot odometry pose shift tracking termination conditions. (820)

Improvements

* [core] Make all Perlin processes faster and copy-able. (799) (824)
* [python/viewer] Significantly speed-up both offscreen and onscreen rendering for Panda3D. (826)
* [gym/common] More generic stacking quantity. (812)
* [gym/common] More generic actuated joint kinematic quantity. (814)
* [gym/common] Add 'order' option to 'AdditiveReward'. (821)
* [gym/common] Refactor quantity management to dramatically improve its performance. (821)

Patches and bug fixes

* [core] Fix robot serialization issue. (821)
* [core] Fix negative time support for all existing random processes. (799)
* [python/tree] Fix 'tree.unflatten_as' mixing up key order for 'gym.spaces.Dict'. (819)
* [python/simulator] Consistent keyword arguments between 'Simulator.build' and 'Simulator.add_robot'. (821)
* [python/viewer] Fix MacOS support. (822)
* [gym/common] Fix quantity hash collision issue in quantity manager. (821)

The previous release populates the quantities and reward component toolboxes recently introduced with generic and commonly used building blocks of a complete learning pipeline. Various bugs attributed to the early stage development of this toolbox has been fixed and now its core is expected to be significantly more mature.

New features

* [core] Add option to log constraint lambda multipliers. (809)
* [python|gym] Add contraint lambda multipliers to state and extracted trajectory. (809)
* [gym/common] Add 'log3|6', 'exp3|6', '(xyz)quat_difference', and 'quat_apply' vectorized math utils. (807)
* [gym/common] Add unary operator quantity. (803)
* [gym/common] Add odometry pose quantity. (803)
* [gym/common] Add mean quaternion quantity. (804)
* [gym/common] Add foot odometry pose quantity. (804)
* [gym/common] Add relative foot poses quantity. (805)
* [gym/common] Add foot vertical forces quantity. (810)
* [gym/common] Add base angular momentum quantity and reward. (807)
* [gym/common] Add relative foot positions and orientations tracking reward. (807)
* [gym/common] Add actuated joint tracking reward. (803)
* [gym/common] Add tracking base height reward. (803)
* [gym/common] Add foot pose tracking reward. (806)
* [gym/common] Add cature point quantity and capture point tracking reward. (803)
* [gym/common] Add angular momentum minimisation reward. (808)
* [gym/common] Add projected support polygon zmp stability margin maximisation reward. (808)
* [gym/common] Add ground contact friction minimisation reward. (808)
* [gym/common] Add foot force distribution reward. (810)

Improvements

* [gym/common] Add support of multi-frame quantities. (804)
* [gym/common] Unify all frame orientation representations as one quantity. (805)

Patches and bug fixes

* [core] Allow integer reduction ratio at motor level for unbounded revolute joints. (803)
* [core] Make sure no constraint is added/removed if simulation is running. (809)
* [python/dynamics] Fix trajectory interpolation preferring t+ over t-. (809)
* [gym/common] Robust deletion of quantities in control flow. (803)
* [gym/common] Fix reset of automatically refreshed quantities. (803)
* [gym/common] Fix quantity eval mode handling. (803)
* [gym/common] Fix reward deletion cleanup. (803)
* [gym/common] Fix env action not cleanup at reset. (803)
* [gym/common] Refresh state quantities only if needed. (809)

Miscellaneous

* [core] Enforce unique constraint name per registry not globally, then remove now irrelevant helpers. (809)
* [core] Replace constraint tree 'node' terminology by 'registry' for clarity. (809)
* [core] Rename 'runge_kutta_dopri5' in 'runge_kutta_dopri' for clarity. (810)
* [python/viewer] Fix support of 'matplotlib>=3.9.0'. (803)
* [gym/common] Remove error-prone, confusing and slow `__getattr__` fallback in pipelines. (808)
* [misc] Fix segfault on windows due to vcruntime conflicts. (808)

This main focus of this release is to introduce a new generic reward component toolbox. Defining new highly-optimised reward components is a breeze thanks to the dynamic computation graph capability of first-class quantities that was previously introduced and significantly extended here. The learning environment pipeline design has been extended to allow for specifying reward components and reference trajectories in configuration files. Regarding the physics engine, simple mechanical reductions are now fully supported, and handling of velocity bounds has been reworked to be physically grounded. For the record, the pre-defined learning environment for Atlas using PD controllers has a real time factor of 120 on a single core (Apple M3 Max).

New features

* [core] Add stairs terrain mwulfman (797)
* [core] Implement velocity limits at motor-level. (798)
* [core] Enable attaching encoders either on motor or joint side. (798)
* [core] Mechanical reduction is now fully supported. (798)
* [core] Add velocity-torque slope when approaching maximum torque. (798)
* [python] Introduce first-class trajectory object. (790)
* [gym/common] Add simulation vs trajectory quantity evaluation mode. (791) (792)
* [gym/common] Add more pre-defined computation graph quantities. (783) (784)
* [gym/common] Introduce reward component toolbox leveraging computation graph. (784) (786) (792)
* [gym/common] Support specifying reward in pipeline config. (787) (792)
* [gym/rllib] Add symmetry surrogate loss in PPO algorithm. mwulfman (780)

Improvements

* [core] Make 'jiminy::Model' and 'jiminy::Robot' copyable. (791)
* [core] Define position, velocity and effort limits at motor level. (798)
* [core] Allow direct access to all motors / sensors attached to a robot. (798)
* [core] Remove spring-damper position bounds dynamics to always use constraints. (798)
* [core] Remove damper velocity bounds dynamics. (798)
* [core] Define motor armature option at motor-side. (798)
* [core] Effort sensors now correctly measure motor effort before transmission. (801)

Patches and bug fixes

* [core] Fix adding flexibility frame on root joint of fixed-base robot. (798)
* [python/log] Fix trajectory and sensor data extraction and replay from log. (800)
* [python/plot] Get around tabbed figure hanging for 'matplotlib>=3.8'. (795)
* [gym/env] Update all robotic environment to avoid truncation under random actions. (800) (801)
* [gym/rllib] Fix checkpoint save location. mwulfman (788) (789)

Miscellaneous

* [core] Remove dedicated robot attributes for position, velocity and effort limits. (798)
* [core] Remove inefficient motor / sensor convenience helpers of 'Robot'. (798)
* [core] Log total joint effort instead of confusing motor effort on joint side. (798)
* [core] Move 'enable(Velocity|Effort)Limit' options from AbstractMotor to SimpleMotor. (798)
* [gym/common] Do NOT pass 'truncated' argument to 'compute_reward'. (783)
* [gym/common] Pass 'info' in argument of 'has_terminated' for consistency. (783)
* [gym/common] Remove BaseJiminyEnv 'enforce_bounded_spaces' option by lack of use-case. (783)
* [gym/common] Increase timeout ratio from 10 to 15 to avoid Mac OS CI failure. (786)
* [gym/common] Get around some memory alignment issue with Boost < 1.78. (794)
* [misc] Update install instructions on windows. (787)
* [misc] Improve documentation. (790)

Robots are now fully serialized in log files, including all their hardware but not their controller. This means that they can be used for running new simulation without any issue. Previously, they are only suitable for viewer replay. Apart from that, some outdated environment pipeline wrappers have been refactored to significantly improve their performance.

New features

* [core] Full support of serialization of 'Robot'. (770) (775)

Improvements

* [core] Log the acceleration both at the end and the beginning of a step if dynamics has changed. (779)
* [python/simulator] 'plot' now support multi-robot simulations. (770)
* [gym/common] Speedup 'PDController' env pipeline block. (770)
* [gym/common] Speedup 'StackedJiminyEnv' wrapper. (770)
* [gym/common] More generic 'FilterObservation', 'StackedJiminyEnv' wrappers. (770) (776)

Patches and bug fixes

* [core] Fix pessimistic step adjustment that could lead to undeserved integration failure.
* [core] Fix inconsistent acceleration after updating discrete-time controller command. (779)
* [gym/common] Improve 'Env.render_mode' support.
* [gym/rllib] Fix multi-GPU support using custom PPO (774)

Miscellaneous

* [gym/zoo] Cleanup and speedup toy model environments. (770)
* [misc] Add RL tutorial notebook.