.. highlightlang:: us

.. _auto_xy_Peaks:

auto_xy_Peaks
=============

.. index:: auto_xy_Peaks

.. us.tag  auto_xy_Peaks NOTREADYGERMAN auto_xy New5500

Erzeugt für den gegebenen 2D-Datensatz einen Datensatz mit den lokalen
Minima und Maxima (Peaks). Siehe :ref:`detect_peaks`.

Der Datensatz wird automatisch aktualisiert, falls sich der Quelldatensatz
ändert, z. B. beim Datenaustausch.

.. function:: hDataNew = auto_xy_Peaks(hData, rsThreshold, nType, bAbs, bLabel);
    hDataNew = auto_xy_Peaks(hData_Layer, rsThreshold, nType, bAbs, bLabel);

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

   *rsThreshold* ist der Schwellwert. Es werden nur Peaks gefunden, deren Spannen
   (Differenz zwischen benachbarten Extremwerten) größer als der Schwellwert sind.

.. uparam:: nType

   Ist einer der folgenden Werte:

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

      * - Wert
        - Beschreibung
      * - 1
        - Lokale Maxima
      * - 2
        - Lokale Minima
      * - 3
        - Lokale Minima und Maxima

.. uparam:: bAbs

   Legt fest, ob *rsThreshold* absolut (*bAbs* = TRUE) oder relativ in Prozent 
   (*bAbs* = FALSE) gegeben ist. 

.. uparam:: bLabel

   Falls *bLabel* auf TRUE (1) gesetzt ist, werden lokale Minima und Maxima 
   mit Ihrem Wert beschriftet (maximal 50 Label).

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

:sub:`id-560446`