.. highlightlang:: us

.. index:: NC_plotcategory

.. _nc_plotcategory:

NC_plotcategory
===============

.. us.tag  NC_plotcategory GERMAN

:ref:`NC_plotcategory` erzeugt einen Kategorie-Plot mit gruppierten 
Balken-Datensätzen. Ruft die Funktion :ref:`plotcategory` auf.

.. function::  rvData = NC_plotcategory(ssNCFile, ssLabelChannel, svChannel)
    rvData = NC_plotcategory(ssNCFile, ssLabelChannel, svChannel, oParameter)
    rvData = NC_plotcategory(ncid, ssLabelChannel, svChannel)
    rvData = NC_plotcategory(ncid, ssLabelChannel, svChannel, oParameter)

.. us.return

**Returnwert**

*rvData* ist ein Vektor mit den Zugriffsnummern der erzeugten Datensätze.

.. us.params

**Parameter**

.. uparam:: ssNCFile

   *ssNCFile* ist der Name einer NC-Datei mit Daten mit mehreren Zyklen.

.. uparam:: ncid

   *ncid* ist die Zugriffsnummer einer NC-Datei, die von einem
   erfolgreichen Aufruf der Funktionen :ref:`nc_create` oder :ref:`nc_open`
   geliefert wurde. Die Datei muss mit Schreibzugriff geöffnet sein.

.. uparam:: ssLabelChannel

   *ssLabelChannel* ist der Name des Kanals für die Beschrifung der 
   Rubrikenachse. Kann leer sein.

.. uparam:: svChannel

   *svChannel* ist ein Vektor mit den Kanalnamen für die Balkendatensätze.

.. uparam:: oParameter

   *oParameter* ist ein Objekt mit optionalen Parametern. Siehe :ref:`plotcategory`
   für eine Liste der Parameter. Extra Objekt Elemente für  :ref:`NC_plotcategory`: 

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

      * - Element Name
        - Beschreibung
        - Default-Wert
      * - bAutoAxisTitle
        - Setze die Achsentitel automatisch.
        - 1

.. us.example

**Beispiel**

::

   obj = [. color_scale = "Blues", bAutoAxisTitle = 1];
   obj.yTitle = "Power in kW";
   ssNCFile = auto_ImportData(GetRootDirectory() + "samples\\energie.asc";
   NC_plotcategory(ssNCFile, "Drehzahl", ["Nutzleistung", "Oelenergie", "Abgasenergie"], obj)

.. seealso::
   :ref:`DocCreate`,
   :ref:`PageCreate`,
   :ref:`PageGetParentDocument`,
   :ref:`LayerCreate`,
   :ref:`XYCreate`,
   :ref:`GetParent`,
   :ref:`plotcategory`,
   :ref:`ColorScale_GetColors`

:sub:`id-1900742`