.. highlightlang:: us

.. _auto_xy_histogram:

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

.. index:: auto_xy_histogram

.. us.tag  auto_xy_histogram NOTREADYENGLISH auto_xy Changed5507

Creates a histogram for the given 2D dataset.

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

**Return Value**

*hDataNew* is the handle of the new 2D dataset.

.. us.params

**Parameters**

.. uparam:: hData

   *hData* is the handle of a 2D dataset. The new
   dataset *hDataNew* will be added to the layer (diagram) in which the
   dataset *hData* is located.

.. uparam:: hData_Layer

   *hData_Layer* is a vector with two elements.
   The first element is a handle of a 2D dataset and the second element is
   a handle of a layer (diagram) to which the new dataset should be
   added.

.. uparam:: nType

   Is one of the following values:

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

   * - Value
     - Description
   * - 1
     - Absolute Frequency
   * - 2
     - Relative Frequency in %
   * - 3
     - Absolute Cumulativ Frequency
   * - 4
     - Relative Cumulativ Frequency in %

.. uparam:: rsClassMin

   Lower class limit.

.. uparam:: rsClassMax

   Upper class limit

.. uparam:: rsClassWidth

   Is the bin width. The number of bins is 
   ``nClass = (rsClassMax - rsClassMin) / rsClassWidth``.

.. uparam:: bShowNormalDistribution

   For *nType* = 1 a normal distribution curve can be displayed. Default 
   value 0.

.. seealso::
   :ref:`overview-automation`,
   :ref:`PageGetLayerHandle`

:sub:`id-449393`