*********************
Geared motor
*********************
*Introduced in MORe v4.2*

Represents a geared motor. Models rotor and gear inertia including gear reduction.

------------------
Block diagram
------------------
   .. image:: media/gearmotor.png
      :alt: Equivalent Mass Block Diagram
      :scale: 50 %

==============  ==============================================================
Signal          Description
==============  ==============================================================
:math:`u_f`     Filter output
:math:`u_v`     Coupling link velocity
:math:`u_x`     Coupling link position
:math:`v_{fb}`  Motor velocity. Can be used as feedback in architecture.
:math:`x_{fb}`  Motor position. Can be used as feedback in architecture.
:math:`y`       Motor output. Force acting on coupling link.
==============  ==============================================================

------------------
Parameter
------------------

==============  ====================  =================  ==============================================================
Variable        Units linear          Units rotary       Description
==============  ====================  =================  ==============================================================
Gear ratio      :math:`-`             :math:`-`          Gear ratio
Stiffness       :math:`N/m`           :math:`Nm/rad`     Stiffness of gear
Damping         :math:`N s/m`         :math:`Nm s/rad`   Damping of gear
Inertia         :math:`kg`            :math:`kg m^2`     Gear and motor inertia
Spindle pitch   :math:`-`             :math:`m`          Ballscrew spindle pitch. Used for setpoint animation.
==============  ====================  =================  ==============================================================

--------
Coupling
--------
Link selection to represent the motor. The controller output (force/torque) will be applied to the selected link.