.. highlightlang:: us

.. index:: ch

.. _ch:

ch
==

.. us.tag ch GERMAN formula New570 Changed5400 Changed5511

Die Funktion :ref:`ch` erfragt die Werte eines Kanals.

Die Funktion sollte nur innerhalb von Funktionen für den Formelinterpreter
verwendet werden. Die Funktion greift über die globale Variable ``_fi_ncid`` auf
die zum Schreiben geöffnete UniPlot Datendatei zu.

.. function::  values = ch(ssChannelName)
               values = ch(ssChannelName, ssBaseName)
               values = ch(ssChannelName, ssBaseName, bSIUnits)

.. us.return

**Returnwert**

Ist ein Zeilenvektor mit den Werten des angegebenen Kanals. Bei MDF-Dateien
sollte nur die Form mit zwei Parametern verwendet werden. Der zweite Parameter
bestimmt die Zeitgruppe, auf den der Kanal interpoliert wird.

.. us.params

**Parameter**

.. uparam:: ssChannelName

   *ssChannelName* ist der Name eines Kanals. 

.. uparam:: ssBaseName

   *ssBaseName* ist der Name eines Kanals. Falls sich bei MDF-Dateien der Kanal
   *ssChannelName* in einer anderen Zeitgruppe als der Kanal *ssBaseName*
   befindet, wird der Kanal über den Zeitkanal auf die  Auflösung des Kanals
   *ssChannelName* interpoliert.

   Falls der Parameter *ssBaseName* nicht angegeben ist, oder ein leerer String
   ("") ist, wird keine Interpolation durchgeführt.

.. uparam:: bSIUnits

   *bSIUnits* ist TRUE (1), wenn *ssChannelName* in SI-Einheiten umgerechnet
   werden soll. Falls *bSIUnits* nicht angegeben wird oder FALSE (0) ist, wird 
   keine Einheitenumrechnung durchgeführt.

.. us.example

**Beispiel**

::

   // Leistung in kW
   // M*2*PI*n
   // Drehzahl n in 1/min
   // Moment m in Nm
   def _fi_Power(bInfo)
   {
       ssChannels = "n_Motor, Md_Motor";
       if (bInfo) {
           return ["Power"; ..
               "kW"; ..
               "Leistung"; ..
               ssChannels];
       }
       n_Motor = ch("n_Motor");
       Md_Motor = ch("Md_Motor");
       Power = (n_Motor .* Md_Motor) ./ 9549.3;
       set_ch("Power", Power, ssChannels);
   }

.. us.history

**History**

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

   * - Version
     - Beschreibung
   * - R2013.11
     - Dritter Parameter zur Einheitenumrechnung.
   * - R2012 (5.40.0)
     - Neu dokumentiert.
   * - 5.7
     - Neu.

.. seealso::
   :ref:`formelinterpreter-1---einfuhrung`,
   :ref:`unit-converter`,
   :ref:`onformulastarteval`,
   :ref:`set_ch`,
   :ref:`get_ncid`

:sub:`id-1127067`