.. highlightlang:: us

.. _auto_xy_histogram:

auto_xy_histogram
=================

.. index:: auto_xy_histogram

.. us.tag  auto_xy_histogram NOTREADYGERMAN auto_xy  Changed5507

Erzeugt für den gegebenen 2D-Datensatz ein Histogramm. Dazu werden die
y-Koordinaten klassiert.

.. function::  hDataNew = auto_xy_histogram(hData, nType, rsClassMin, rsClassMax, rsClassWidth)
    hDataNew = auto_xy_histogram(hData_Layer, nType, rsClassMin, rsClassMax, rsClassWidth)
    hDataNew = auto_xy_histogram(hData, nType, rsClassMin, rsClassMax, rsClassWidth, bShowNormalDistribution)
    hDataNew = auto_xy_histogram(hData_Layer, nType, rsClassMin, rsClassMax, rsClassWidth, bShowNormalDistribution)

.. us.return

**Returnwert**

*hDataNew* ist die Zugriffsnummer des neu erzeugten 2D-Datensatzes.

.. us.params

**Parameter**

.. uparam:: hData

   *hData* ist die Zugriffsnummer (Handle) des
   Datensatzes auf den die Funktion angewendet werden soll. Der neu
   erzeugte Datensatz wird dem Diagramm zugefügt, in dem sich *hData* befindet.

.. uparam:: hData_Layer

   *hData_Layer* ist ein Vektor von
   Zugriffsnummern. Das erste Element ist die Zugriffsnummer (Handle) des
   Datensatzes auf den die Funktion angewendet werden soll. Das zweite
   Element ist die Zugriffsnummer (Handle) des Diagramms, dem der neue
   Datensatz zugefügt werden soll.

.. uparam:: nType

   Ist einer der folgenden Werte:

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

   * - Werte
     - Beschreibung
   * - 1
     - Absolute Häufigkeit
   * - 2
     - Relative Häufigkeit in %
   * - 3
     - Kumulierte Häufigkeit
   * - 4
     - Relative Kumulierte Häufigkeit in %

.. uparam:: rsClassMin

   Untere Klassengrenze

.. uparam:: rsClassMax

   Obere Klassengrenze

.. uparam:: rsClassWidth

   Ist die Klassenbreite. Die Anzahl der Klassen ist
   ``nClass = (rsClassMax - rsClassMin) / rsClassWidth``.

.. uparam:: bShowNormalDistribution

   Für *nType* = 1 kann eine normierte Normalverteilung angezeigt werden.
   Defaultwert ist 0.

.. seealso::
   :ref:`uberblick-automatisierung-der-diagrammerstellung`,
   :ref:`PageGetLayerHandle`

:sub:`id-449393`