.. highlightlang:: us

.. _auto_xy_correlate:

auto_xy_Correlate
=================

.. index:: auto_xy_Correlate

.. us.tag  auto_xy_Correlate NOTREADYGERMAN auto_xy

Erzeugt einen neuen Datensatz, wobei die
y-Koordinaten des ersten Datensates die x-Koordinaten und die
y-Koordinaten des zweiten Datensatzes die y-Koordinaten des neuen
Datensatzes bilden.

.. function::  hDataNew = auto_xy_Correlate(hData, hData2)
    hDataNew = auto_xy_Correlate(hData_Layer, hData2)

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

   *hData2* ist die Zugriffsnummer eines weiteren 2D-Datensatzes.

.. us.comment

**Kommentar**

Die x-Koordinaten aller Datensätze müssen monoton aufsteigend
sein. Die Stützstellen (x-Koordinaten) der Datensätz müssen nicht
identisch sein.

Der neue Datensatz wird wie folgt erzeugt:

*  Es wird der Überlappungsbereich der x-Koordinaten bestimmt.

* Innerhalb dieses Bereichs wird ein neuer
  Stützstellen-Vektor xs berechnet, der die Stützstellen aller
  Datensätze enthält.

* Für jeden Datensatz werden für den neuen
  Stützstellen-Vektor die y-Koordinaten durch lineare Interpolation
  berechnet.

* Die interpolierten y-Koordinaten des ersten Datensatzes werden über die
  x-Achse und die y-Koordinaten des zweiten Datensatzes über die Y-Achse aufgetragen
  (xKorr = Y1, yKorr = Y2).

*  Der neue Datensatz wird erzeugt (xKorr, yKorr).

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

:sub:`id-1547845`