Correct mention of the implicit integrator in viscosity documentation.

PiperOrigin-RevId: 465763354
Change-Id: I605165c536de294c6d0981524d7dfab566da55aa
This commit is contained in:
Yuval Tassa
2022-08-06 07:53:26 -07:00
committed by Copybara-Service
parent 4d24d56c64
commit 83b30a6210
+5 -6
View File
@@ -1744,12 +1744,11 @@ adjust it properly through the XML.
:at:`viscosity`: :at-val:`real, "0"` :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 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. 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 <geIntegration>` handles damping Setting viscosity to 0 disables viscous forces. Note that the default Euler :ref:`integrator <geIntegration>` handles
in the joints implicitly - which improves stability and accuracy. It does not presently do this with body viscosity. damping in the joints implicitly – which improves stability and accuracy. It does not presently do this with body
Therefore, if the goal is merely to create a damped simulation (as opposed to modeling the specific effects of viscosity. Therefore, if the goal is merely to create a damped simulation (as opposed to modeling the specific
viscosity), we recommend using joint damping rather than body viscosity. There is a plan to develop an integrator effects of viscosity), we recommend using joint damping rather than body viscosity, or switching to the
that is fully implicit in velocity, which will make joint damping and body viscosity equally stable, but this feature :at:`implicit` integrator.
is not yet available.
:at:`o_margin`: :at-val:`real, "0"` :at:`o_margin`: :at-val:`real, "0"`
This attribute replaces the margin parameter of all active contact pairs when :ref:`Contact override <COverride>` is This attribute replaces the margin parameter of all active contact pairs when :ref:`Contact override <COverride>` is
enabled. Otherwise MuJoCo uses the element-specific margin attribute of :ref:`geom <geom>` or :ref:`pair <pair>` enabled. Otherwise MuJoCo uses the element-specific margin attribute of :ref:`geom <geom>` or :ref:`pair <pair>`