.. highlightlang:: us

.. index:: auto_xy_Interpolate

.. _auto_xy_interpolate:

auto_xy_Interpolate
===================

.. us.tag  auto_xy_Interpolate NOTREADYGERMAN auto_xy

Erzeugt für alle gegebenen 2D-Datensätze jeweils einen neuen Datensatz, der die
Stützstellen aller Datensätze enthält.

.. function::  hvDataNew = auto_xy_Interpolate(hData, hvData)
    hvDataNew = auto_xy_Interpolate(hData_Layer, hvData)

.. us.return

**Returnwert**

*hvDataNew* ist ein Vektor mit Zugriffsnummern der neu erzeugten 2D-Datensätze.

.. us.params

**Parameter**

.. uparam:: hData

   *hData* ist die Zugriffsnummer (Handle) des
   Datensatzes auf den die Funktion angewendet werden soll. Die neu
   erzeugten Datensätze werden 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 die neuen
   Datensätze zugefügt werden sollen.

.. uparam:: hvData

   *hvData* ist ein Vektor mit weiteren 2D Datensatz
   Zugriffsnummern.

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

Die neuen Datensätze werden 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 ys durch lineare Interpolation
  berechnet

* Für jeden Datensatz wird ein neuer Datensatz aus den
  interpolierten Daten xs, ys berechnet.

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

:sub:`id-652672`