.. highlightlang:: us

.. _auto_xy_createdataset:

auto_xy_CreateDataset
=====================

.. index:: auto_xy_CreateDataset

.. us.tag  auto_xy_CreateDataset GERMAN auto_xy

:ref:`auto_xy_CreateDataset` erzeugt
einen neuen Datensatz mit den angegebenen x- und y-Koordinaten.

.. function::  hDataNew = auto_xy_CreateDataset(hLayer, ssName, rvX, rvY)

.. us.return

**Returnwert**

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

.. us.params

**Parameter**

.. uparam:: hLayer

   *hLayer* ist Zugriffsnummer des Diagramms, in das
   der Datensatz eingefügt werden soll. Die Zugriffsnummer eines
   Diagramms kann mit der Funktion :ref:`PageGetLayerHandle` erfragt werden
   (siehe Beispiel).

.. uparam:: ssName

   *ssName* ist der Name des Datensatzes.

.. uparam:: rvX

   *rvX* ist ein reeller Vektor mit den x-Koordinaten des
   Datensatzes.

.. uparam:: rvY

   *rvY* ist ein reeller Vektor mit den y-Koordinaten des
   Datensatzes.

.. us.example

**Beispiel**

::

   hPage = auto_LoadTemplate("tpl_ger", "2 Diagramme");
   PageSetTitle(hPage, "Example");
   hLayer1 = PageGetLayerHandle(hPage, "Diagramm 1");
   hLayer2 = PageGetLayerHandle(hPage, "Diagramm 2");

   x = linspace(0,2*PI); y = sin(x);
   auto_xy_CreateDataset(hLayer1, "Sinus", x, y);
   y = cos(x);
   auto_xy_CreateDataset(hLayer2, "Cosinus", x, y);

   auto_ScaleAxes();
   auto_UpdatePage();
   auto_SaveDocumentAs("/Example.ipw")

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

:sub:`id-633405`