.. highlightlang:: us

.. index:: plotcategory

.. _plotcategory:

plotcategory
============

.. us.tag  plotcategory GERMAN New5600

:ref:`plotcategory` erzeugt einen Kategorie-Plot mit gruppierten 
Balken-Datensätzen.

.. function::  rvData = plotcategory(svCategoryLabel, rmData)
    rvData = plotcategory(svCategoryLabel, rmData, oParameter)

.. us.return

**Returnwert**

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

.. us.params

**Parameter**

.. uparam:: svCategoryLabel

   *svCategoryLabel* ist ein Vektor mit den Texten für die Rubrikenachse. 
   Falls *svCategoryLabel* ein leerer String ist, wird die Rubrikenachse
   nicht geändert.

.. uparam:: rmData

   *rmData* ist eine reelle Matrix. Von jeder Spalte wird ein Datensatz 
   erzeugt. Die Anzahl der Zeilen sollte mit der Anzahl der Elemetne von
   *svCategoryLabel* übereinstimmen.

.. uparam:: oParameter

   *oParameter* ist ein Objekt mit optionalen Parametern.

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

      * - Element Name
        - Beschreibung 
        - Default Wert
      * - hLayer
        - Layer-Handle. 0: Erzeugt ein neues Diagramm
        - 0
      * - rvStacked = [0,1,1,0]
        - Reeller Vektor mit den Werten 0 oder 1. 0 (Gruppiert), 1 (Gestapelt).
          Die Anzahl der Elemente sollte mit der Anzahl der Datensätze 
          übereinstimmen.
        - 0: grouped
      * - gapwidth
        - Lückse zwischen den Rubriken im Bereich 0 bis 5 
          (0 bis 500 Prozent der Balkenbreite).
        - 1.0
      * - overlap
        - Balkenüberlappung im Bereich -1 bis 1 (-100 bis 100 Prozent der
          Balkenbreite).
        - -0.2
      * - bAutoscale
        - Autoskalierung der Achsen.
        - 1
      * - bReplot
        - Neuzeichnen der Seite.
        - 1
      * - b100percent
        - Gestapelte Balken auf 100 Prozenz skalieren.
        - 0
      * - xTitle
        - X-Achsentitel
        - "" (do not modify title)
      * - yTitle
        - Y-Achsentitel
        - "" (do not modify title)
      * - color_scale
        - Name der Farbfolge. Siehe :ref:`ColorScale_GetNames`
          Beispiel: ``color_scale = 'Blues'``
        - Purples
      * - bLabel
        - Anzeigen oder Verstecken der Balkenbeschriftung
        - 1 (show label)
      * - nLabelPosition
        - Label position: 1: Innen Unten, 2: Innen Mitte, 3: Innen Oben, 
          4: Außen Oben
        - 3 (Innen Oben)

.. us.example

**Beispiel**

Das folgende Beispiel erzeugt einen Kategorieplot mit Zufallswerten. 
6 Datensätze mit jeweils 4 Punkten

::

   svCategoryLabel = "";
   rmData = rand(4,6);
   o = [. rvStacked = [1,1,1,0,1,1], xTitle = "Period", yTitle = "Value in %"];
   plotcategory(svCategoryLabel, rmData, o)

.. seealso::
   :ref:`DocCreate`,
   :ref:`PageCreate`,
   :ref:`PageGetParentDocument`,
   :ref:`LayerCreate`,
   :ref:`XYCreate`,
   :ref:`NC_plotcategory`,
   :ref:`GetParent`,
   :ref:`ColorScale_GetNames`

:sub:`id-2043309`