.. highlightlang:: us

.. index:: nc_convert_units

.. _nc_convert_units:

nc_convert_units
================

.. us.tag nc_convert_units NOTREADYGERMAN nc.tools New5511

:ref:`nc_convert_units` konvertiert die Kanäle einer NC2-Datei in SI-Einheiten
oder gebräuchliche Einheiten.

.. function:: bool = nc_convert_units(ssFilename, bSIUnits)
              bool = nc_convert_units(ncid, bSIUnits)

.. us.return

**Returnwert**

*bool* ist TRUE (1), wenn die Funktion erfolgreich war und sonst FALSE (0).

.. us.params

**Parameter**

.. uparam:: ssFilename

   *ssFilename* ist der Name einer netCDF-Datei.

.. uparam:: ncid

   *ncid* ist die Zugriffsnummer einer UniPlot-Datendatei (siehe :ref:`nc_open`
   oder :ref:`nc_create`). Die Datei muss mit :ref:`nc_close` wieder geschlossen
   werden. *ncid* kann alternativ zu *ssFilename* angegeben werden.

.. uparam:: bSIUnits

   *bSIUnits* ist TRUE (1), wenn die Kanäle in SI-Einheiten konvertiert werden
   sollen und FALSE (0), wenn die Kanäle in gebräuchliche Einheiten konvertiert
   werden sollen. 

.. us.comment

**Kommentar**

Es werden nur Kanäle konvertiert, deren Einheiten in der Einheitentabelle
definiert sind. Um einen Kanal von einer SI-Einheit in eine gebräuchliche Einheit
zu konvertieren muss der Kanalname mit der gewünschten Einheit in der 
Einheitentabelle in der Tabelle ``channel`` eingetragen sein oder es wird die
bevorzugte Einheit für die entsprechende SI-Einheit verwendet. Falls die Einheit
in der  Einheitentabelle nicht gefunden wird, wird der Kanal nicht konvertiert.
Siehe auch :ref:`unit-converter`.

.. us.example

**Beispiel**

::

   * ssFile = auto_ImportData(GetRootDirectory() + "samples/test1.xls")
   * nc_convert_units(ssFile, TRUE);

.. us.history

**History**

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

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

.. seealso::
   :ref:`uberblick-netcdf-dateien`,
   :ref:`unit-converter`,
   :ref:`nc_from_obj`,
   :ref:`NC_Edit`,
   :ref:`NC_GetVarNames`

:sub:`id-1039787`