.. highlightlang:: us

.. index:: NC_plotcategory

.. _nc_plotcategory:

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

.. us.tag  NC_plotcategory ENGLISH New5600

:ref:`NC_plotcategory` plots a category plot with grouped bars.
Invokes :ref:`plotcategory` to create the plot.

.. 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

**Return Value**

*rvData* is a vector with dataset handles.

.. us.params

**Parameters**

.. uparam:: ssNCFile

   *ssNCFile* is the name of an NC file with the source data.

.. uparam:: ncid

   *ncid* is the handle of an NC file, returned by :ref:`nc_create` or
   :ref:`nc_open`. The file must be opened with write access.

.. uparam:: ssLabelChannel

   *ssLabelChannel* is a channel name for category labels. Real values will 
   be converted to strings

.. uparam:: svChannel

   *svChannel* is string vector with channel names.

.. uparam:: oParameter

   *oParameter* is an object with optional parameters. See :ref:`plotcategory`
   for a list of parameters. Extra object elements can be specified: 

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

      * - Element Name
        - Description
        - Default Value
      * - bAutoAxisTitle
        - Set the axis title.
        - 1

.. us.example

**Example**

::

   obj = [. color_scale = "Blues", bAutoAxisTitle = 1];
   obj.yTitle = "Power in kW";
   obj.bLabel = 0;
   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`