From 83b30a6210263dd066dddbd06352376699989006 Mon Sep 17 00:00:00 2001 From: Yuval Tassa Date: Sat, 6 Aug 2022 07:53:26 -0700 Subject: [PATCH] Correct mention of the implicit integrator in `viscosity` documentation. PiperOrigin-RevId: 465763354 Change-Id: I605165c536de294c6d0981524d7dfab566da55aa --- doc/XMLreference.rst | 11 +++++------ 1 file changed, 5 insertions(+), 6 deletions(-) diff --git a/doc/XMLreference.rst b/doc/XMLreference.rst index 4e46a45f..a93ce624 100644 --- a/doc/XMLreference.rst +++ b/doc/XMLreference.rst @@ -1744,12 +1744,11 @@ adjust it properly through the XML. :at:`viscosity`: :at-val:`real, "0"` Viscosity of the medium. This parameter is used to simulate viscous forces, which scale linearly with velocity. In SI units the viscosity of air is around 0.00002 while the viscosity of water is around 0.0009 depending on temperature. - Setting viscosity to 0 disables viscous forces. Note that the Euler :ref:`integrator ` handles damping - in the joints implicitly - which improves stability and accuracy. It does not presently do this with body viscosity. - Therefore, if the goal is merely to create a damped simulation (as opposed to modeling the specific effects of - viscosity), we recommend using joint damping rather than body viscosity. There is a plan to develop an integrator - that is fully implicit in velocity, which will make joint damping and body viscosity equally stable, but this feature - is not yet available. + Setting viscosity to 0 disables viscous forces. Note that the default Euler :ref:`integrator ` handles + damping in the joints implicitly – which improves stability and accuracy. It does not presently do this with body + viscosity. Therefore, if the goal is merely to create a damped simulation (as opposed to modeling the specific + effects of viscosity), we recommend using joint damping rather than body viscosity, or switching to the + :at:`implicit` integrator. :at:`o_margin`: :at-val:`real, "0"` This attribute replaces the margin parameter of all active contact pairs when :ref:`Contact override ` is enabled. Otherwise MuJoCo uses the element-specific margin attribute of :ref:`geom ` or :ref:`pair `