.. highlightlang:: us

.. index:: units_get_scale

.. _units_get_scale:

units_get_scale
===============

.. us.tag units_get_scale NOTREADYGERMAN units New5511

:ref:`units_get_scale` liefert den Faktor und den Offset um eine Einheit in eine 
andere Einheit umzurechnen.

.. function:: rvScale = units_get_scale(oUnit, ssFrom)
              rvScale = units_get_scale(oUnit, ssFrom, ssTo)

.. us.return

**Returnwert**

*rvScale* ist ein Vektor mit 2 Elementen. *rvScale[1]* ist ein Faktor und 
*rvScale[2]* der Offset. Falls eine der Einheite ungültig ist (nicht in der 
Tabelle vorhanden) liefert die Funktion den Wert ``[0,0]`` zurück.

.. us.params

**Parameter**

.. uparam:: oUnit

   Ist das von :ref:`units` erzeugte Einheiten-Umrechner-Objekt.

.. uparam:: ssFrom

   *ssFrom* ist eine Einheit aus der Unit-Tabelle oder der Alias-Tabelle (siehe
   :ref:`overview-units`). Falls ein leerer String übergeben wird, wird die zu
   *ssTo* gehörende SI Einheit verwendet.

.. uparam:: ssTo

   *ssTo* ist die Zieleinheit. Wird sie nicht angegeben, wird die SI-Einheit von 
   *ssFrom* verwendet.

.. us.comment

**Kommentar**

Die Funktion ``units_get_scale(oUnit, ssFrom, ssTo)`` kann auch in der Form 
``oUnit.scale(ssFrom, ssTo)`` aufgerufen werden.

.. us.example

**Beispiel**

::

   u = units();
   rvScale = units_get_scale(u, "PS")
   rvScale
       735.4987     0.0000 
   P_ps = 100
   P_watt = rvScale[1] * P_ps + rvScale[2];
      73549.8749 
   rvScale = u.scale("PS", "kW")
   P_kW = rvScale[1] * P_ps + rvScale[2]
   P_kW
      73.5499 
 
.. us.history

**History**

.. list-table::
   :header-rows: 1

   * - Version
     - Beschreibung
   * - R2013.11
     - Neu.

.. seealso::
   :ref:`overview-units`,
   :ref:`units`

:sub:`id-1218826`