diff --git a/doc/APIreference.rst b/doc/APIreference.rst index f5711c6f..f8d9fe5c 100644 --- a/doc/APIreference.rst +++ b/doc/APIreference.rst @@ -1505,6 +1505,7 @@ mjModel mjtNum* geom_friction; // friction for (slide, spin, roll) (ngeom x 3) mjtNum* geom_margin; // detect contact if dist` is disabled for the parent body. +:at:`fluidcoef`: :at-val:`real(5), "0.5 0.25 1.5 1.0 1.0"` + Dimensionless coefficients of fluid interaction model, as follows. + + +.. table:: + :align: left + + +--------+-----------------------------+----------+ + | Index | Description | Default | + +========+=============================+==========+ + | 0 | Blunt drag coefficient. | 0.5 | + +--------+-----------------------------+----------+ + | 1 | Slender drag coeficient. | 0.25 | + +--------+-----------------------------+----------+ + | 2 | Angular drag coefficient. | 1.5 | + +--------+-----------------------------+----------+ + | 3 | Kutta lift coeficient. | 1.0 | + +--------+-----------------------------+----------+ + | 4 | Magnus lift coeficient. | 1.0 | + +--------+-----------------------------+----------+ + :at:`user`: :at-val:`real(nuser_geom), "0 0 ..."` See :ref:`CUser`. diff --git a/doc/changelog.rst b/doc/changelog.rst index bbf55035..d8e9e766 100644 --- a/doc/changelog.rst +++ b/doc/changelog.rst @@ -2,8 +2,8 @@ Changelog ========= -Version 2.1.2 (Date TBD, 2022) ------------------------------- +Version 2.1.2 (Mar. 15, 2022) +----------------------------- New modules ^^^^^^^^^^^ @@ -64,10 +64,16 @@ General perspective of C and C++, this is a non-change since array types in function signatures decay to pointer types. However, it allows autogenerated code to be aware of expected input shapes. +#. Experimental stateless fluid interaction model. As described :ref:`here `, fluid forces use sizes computed + from body inertia. While sometimes convenient, this is very rarely a good approximation. In the new model forces act + on geoms, rather than bodies, and have a several user-settable parameters. The model is activated by setting a new + attribute: ````. The parameters are described succinctly :ref:`here`, but we + leave a full description or the model and its parameters to when this feature leaves experimental status. + Bug Fixes ^^^^^^^^^ -15. ``mj_loadXML`` and ``mj_saveLastXML`` are now locale-independent. The Unity plugin should now work correctly for +16. ``mj_loadXML`` and ``mj_saveLastXML`` are now locale-independent. The Unity plugin should now work correctly for users whose system locales use commas as decimal separators. #. XML assets in VFS no longer need to end in a null character. Instead, the file size is determined by the size parameter of the corresponding VFS entry. @@ -77,7 +83,7 @@ Bug Fixes Binary build ^^^^^^^^^^^^ -18. Windows binaries are now built with Clang. +20. Windows binaries are now built with Clang. Version 2.1.1 (Dec. 16, 2021) -----------------------------