Add entry to Migration guide about the updated auto-inertia behavior (#…

…1528) * add entry to migration guide about the updated auto-inertia behavior --------- Signed-off-by: Ian Chen <[email protected]> Co-authored-by: Steve Peters <[email protected]>
gazebosim · Jan 16, 2025 · 2b583cb · 2b583cb
1 parent fd0292a
commit 2b583cb
Showing 1 changed file with 14 additions and 0 deletions.
diff --git a/Migration.md b/Migration.md
@@ -12,6 +12,20 @@ forward programmatically.
 This document aims to contain similar information to those files
 but with improved human-readability..
 
+
+## libsdformat 15.1.1 to 15.2.0
+
+1. Inertial parameters can now be automatically calculated with a specified
+mass. Previously when the `//inertial/@auto` attribute is set to true, the
+`//inertial/mass` value is ignored and the mass, center of mass location, and
+inertia matrix are computed based on the collision geometries and densities.
+The new behavior is that if `//inertial/mass` is specified, the inertial values
+will be computed to preserve the specified mass. This is done by first
+calculating inertial parameters from all collisions using density as usual,
+calculating the ratio between user-specified mass and the auto-computed mass,
+and rescaling the computed mass and moment of inertia by that mass ratio so
+that the resulting mass matches the specified mass.
+
 ## libsdformat 14.x to 15.x
 
 ### Additions