.. highlightlang:: us

.. index:: auto_xy_LinearInterpolation

.. _auto_xy_linearinterpolation:

auto_xy_LinearInterpolation
===========================

.. us.tag  auto_xy_LinearInterpolation NOTREADYGERMAN auto_xy New300

:ref:`auto_xy_LinearInterpolation` berechnet durch lineare
Interpolation neue Datenpunkte für eine gegeben Kurve. Die x-Daten
müssen aufsteigend sortiert sein.

.. function::  hDataNew = auto_xy_LinearInterpolation(hData_Layer, bNewDataset, nType, rvPoints)

.. us.return

**Returnwert**

*hDataNew* ist die Zugriffsnummer (Handle) des neu erzeugten
Datensatzes.

.. us.params

**Parameter**

.. uparam:: hData_Layer

   *hData_Layer* ist entweder die
   Zugriffsnummer (Handle) des Datensatzes (*hData*) auf den die
   Funktion angewendet werden soll oder ein Vektor mit den
   Zugriffsnummern des Datensatzes und eines Diagramms ([hData, hLayer]).
   Wird nur ein Datensatzhandle *hData* übergeben, wird der erzeugte
   Datensatz dem Diagramm zugefügt, in dem sich *hData* befindet.
   Beim Aufruf mit [*hData*, *hLayer*] wird der neue Datensatz
   dem Diagramm *hLayer* zugefügt.

.. uparam:: bNewDataset

   *bNewDataset*

.. uparam:: nType

   *nType* = 1 oder 2, siehe *rvPoints*

.. uparam:: rvPoints

   *rvPoints* ist die Anzahl der Datenpunkte, die gleichmäßig
   über den x-Koordinatenbereich verteilt werden sollen, wenn *nType* gleich 1 ist.
   Wenn *nType* gleich 2 wird der Parameter als Vektor mit
   X-Koordinaten verarbeitet.

.. us.comment

**Kommentar**

Der Datensatz mit dem Handle *hData* muss in jedem Fall einem
Diagramm zugeordnet sein, ansonsten geben alle ``auto_xy_``-Funktionen den
Wert 0 (Datensatz konnte nicht erzeugt werden) zurück.

.. us.example

**Beispiel**

Erzeugt einen Datensatz mit 100 Punkten, die gleichmäßig über
den x-Koordinatenbereich verteilt sind:

::

   auto_xy_LinearInterpolation(hData_Layer, TRUE, 1, 100)

Erzeugt einen neuen Datensatz mit den x-Koordinaten 1.5, 2.0 und 2.5:

::

   auto_xy_LinearInterpolation(hData_Layer, TRUE, 2, [1.5,2,2.5])

.. seealso::
   :ref:`uberblick-automatisierung-der-diagrammerstellung`,
   :ref:`auto_LoadTemplate`,
   :ref:`auto_LoadDataset`,
   :ref:`auto_xy_SortX`

:sub:`id-2035060`