.. highlightlang:: us

.. index:: auto_xy_Integral

.. _auto_xy_integral:

auto_xy_Integral
================

.. us.tag  auto_xy_Integral GERMAN auto_xy

Diese Funktion ist veraltet. Neue Scripte sollten die Funktion
:ref:`XYSetFilterFunctions` verwenden.

:ref:`auto_xy_Integral` berechnet die Integral-Kurve eines Datensatzes.

.. function::  hDataNew = auto_xy_Integral(hData_Layer)

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

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

Alt:

::

   hPage = auto_LoadTemplate("tpl_ger", "2 Diagramme");
   auto_ImportData(GetRootDirectory() + "samples/vollast.asc");
   hData = auto_LoadDataset("Diagramm 1", "N", "PME");
   hLayer = PageGetLayerHandle(hPage, "Diagramm 2");
   auto_xy_Integral([hData, hLayer]);
   auto_ScaleAxes();
   auto_UpdatePage();

**Beispiel**

Neu:

::

   hPage = auto_LoadTemplate("tpl_ger", "2 Diagramme");
   auto_ImportData(GetRootDirectory() + "samples/vollast.asc");
   hData = auto_LoadDataset("Diagramm 1", "N", "PME");
   hLayer = PageGetLayerHandle(hPage, "Diagramm 2");
   hDataNew = XYCopy(hData);
   XYSetFilterFunctions(hDataNew, "integrate()");
   LayerAddDataset(hLayer, hDataNew);
   auto_ScaleAxes();
   auto_UpdatePage();

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

:sub:`id-831577`