Releases: AnyBody/ammr
AMMR v.3.1.4
AMMR 3.1.4 (2025-09-03)
🩹 Fixed:
- Refactored references in the hand model so BVH MoCap models can share the same
marker protocol regardless of whether the detailed or simple hand is enabled. - Updated the subscapularis insertion to the lesser tuberosity, improving its
moment arms during humerus internal rotation. Special thanks to researcher
Margaux Peixoto (Laboratoire d'Innovation ETS, Montreal) for contributing this
enhancement to the shoulder model. - Fixed contact thresholds in the Leg Press Machine example to ensure contact with all nodes.
- The `joint strength evaluation models now
use the "MinMaxAux" muscle recruitment solver, improving robustness without
changing results.
➕ Added:
- Refactored the implementation of the pelvis rotation vector measure in the
interface folder to allow overriding the global reference frame.
AMMR v.3.1.3
AMMR 3.1.3 (2025-06-16)
🩹 Fixed:
- Fixed a regression in the
VideoLookAtCameraVideoTool that prevented
animated GIFs from being created when the video source was not an.mp4
file. It now supports any video format compatible with the ffmpeg library.
🔧 Changed:
- The intermediate joint angle files used in MoCap models now have headers
which reflect the original output measure instead of the variable name in
the output class. This is useful if the files are used for anything other
than transferring the joint angles from marker tracking to inverse dynamics.
➕ Added:
-
Two new outputs have been added to the
JointAngleOutputsfolder in the
MarkerTracking study in MoCap models:JointAngleOutputs.AllDoFs.ValuesJointAngleOutputs.AllDoFs.Names
These variables contain the values and names of all joint angle variables
saved during marker tracking. They provide an alternative way to access the
same intermediate joint angle values that AnyBody writes to files when
running marker tracking.
AMMR v.3.1.2
AMMR 3.1.2 (2025-06-02)
This release of AMMR contains an important fix to the robustness of the MoCap models.
If you experienced problems with kinematic errors when running inverse dynamics then
please update to this version.
🩹 Fixed:
-
Improved how kinematics calculated in marker tracking is applied
to inverse dynamics MoCap models. The previous
method for applying joint angles from marker tracking could sometimes
struggle with complex rotations (gimbal lock situations). The updated
implementation enhances the stability of the kinematic solver, particularly
for numerically large pelvis rotations, leading to more reliable motion analysis.TL;DR: The implementation was previously using
AnyKinMeasureLinCombto
enable adding a pelvis offset. This had the side effect that the kinematic
engine had to assume small angles, and thus, had difficulties handling
large rotational quantities (e.g. +/- pi, 2pi) for pelvis rotations.
The new implementation only includes the 3 pelvis positions in the
AnyKinMeasureLinCombinstead of all trunk angles. This makes the kinematic
solution more robust for large rotational quantities, which typically may arise
for pelvic's global orientation.
AMMR v.3.1.0
AMMR 3.1.0 (2025-03-31)
🔧 Changed:
- Modified the Human-Ground residual implementation in MoCap models to use
rotational measures configured for angular velocities. This change enhances
the robustness of the residuals and makes the residual output easier to
interpret geometrically, without affecting the results. - Updated the insertion and origin points of the Gluteus Medius to ensure
correct moment arms for external rotation in specific postures. The posterior
Gluteus Medius now twists inside the anterior part and attaches more
anteriorly on the femoral trochanter. - The wrapping surface for muscles at the wrist has been changed from a cylinder
to an ellipsoid. This lowers the risk of muscle via points penetrating the
wrapping surface in postures involving both flexion/extension and
abduction/adduction at the wrist. - Excluded force plates from the parameter identification study, as they were
unnecessary. This change may slightly speed up the parameter identification
process. - The coordinate system used when scaling the shank segment has been aligned
with same reference frame used when scaling the thigh segment, instead of
using the anatomical frame of the shank. Now both segments use the direction
given by the femoral epicondyles as the lateral direction. This change
ensures consistent scaling across the knee joint.
➕ Added:
- Introduced a new class template,
CreateCoMRefNode,
for generating a reference node at the center of mass of a segment, aligned
with its principal axes of inertia. - Added the
TRI(N)macro to create a lower triangular (NxN) matrix. - Added the
TOTAL_POLYLINE_LENGTH(P)macro to compute the total length of a
polyline defined by a set of points.
🩹 Fixed:
- Corrected the PelvisGround rotation drivers in the {ref}
Free Posture Static example<example_freeposture>. The X and Z rotation drivers were previously
mixed up and are now properly assigned. - Resolved an issue that prevented disabling the drawing of marker arrows in
CreateMarkerDriverClasswithin MoCap models. The search string in
Main.ModelSetup.Views.All_MarkerArrows.Objectshas been updated to correctly
identify the arrow drawing objects. - Fixed a spelling typo in the disc stiffness BM control statements. The
BM_TRUNK_*_DISC_STIFNESSparameters have been renamed toBM_TRUNK_*_DISC_STIFFNESS.
The misspelled parameter names have been deprecated. - The data points for the femoral epicondyles with respect to the shank in the
neutral posture have been corrected. These values were not updated when the
knee axis in shank was redefined in TLEM 2.2 and AMMR 3. This change has no
influence on the default AnyBody Models, but it fixes an issue if the model
was configured to use the {bm_constant}special 'bony landmark' defined <_JOINT_TYPE_BONY_LANDMARK_>
joint axis configuration.
Removed:
- Removed the python hooks to check for modified AMMR folder. This feature was
not used and has been removed to simplify the AMMR codebase.
AMMR v.3.0.4
AMMR v.3.0.3
AMMR 3.0.3 (2024-06-10)
This is a minor release of the AnyBody Managed Model Repository.
🩹 Fixed:
- Fixed a penetration warning for the pectoralis muscles when the thoracic
segments are scaled very non-uniformly. The fix involves a small (5 deg)
adjustment to the orientation of the pectoralis wrapping surface. - Fixed default limits in Range of Motion limits
class template. The default limits for PelvisThoraxExtension, PelvisThoraxLateralBending,
Right/LeftWristFlexion had the upper and lower limits flipped. This is now fixed and a
check is added in the class template to catch this kind of error. - Fixed an issue where blinking Windows would appear when loading models stored
in git repositories. This issue was caused by a python subprocess that queried
the git repository for branch information. - Updated the foot marker position in the Xsens protocol to accommodate the
changes made to the foot anatomical frame in the TLEM 2.2 leg model. The
R/LTOE and R/LTOE2 markers have been moved upwards by 1.5 cm.
AMMR v.3.0.1
This minor release of AMMR contains no updates to the models compared to the major AMMR 3.0.0 released the previous month. It only has a few minor changes to the documentation and new tolerances in the FDK models.
🔧 Changed:
- Finer FDK tolerances for the
Knee Simulator example, to take advantage of the improved robustness of the
AnyBody FDK solver in version 8.0.1.
AMMR v.3.0.0
See the changelog for information on what is included in the release.
✨ Highlights:
- Integrated pelvis, lumbar, and thorax models into a consistent trunk model in preparation for a full thoracic model in AMMR 4.
- Updated the leg model (TLEM 2.2) with improvements to the ankle complex, shank orientation, and alignment of the patella tendon.
- Added new wrapping surfaces to the Achilles tendon around the ankle in the TLEM 2.2 leg model.
- Made numerous improvements and fixes to the Body models, MoCap models, and application examples.
AMMR v.2.4.4
See the changelog for information on what is included in the release
AMMR v.2.4.3
See the changelog for information on what is included in the release