.. highlightlang:: us

.. index:: TYCreate

.. _tycreate:

TYCreate
========

.. us.tag  TYCreate GERMAN ty.data Changed400 Changed530

:ref:`TYCreate` erzeugt einen y/t Datensatz (1D-Datensatz).

.. function::  hData = TYCreate(ssName)
    hData = TYCreate(ssName, rvY)
    hData = TYCreate(ssName, rvY, hDoc)

.. us.return

**Returnwert**

*hData* ist die Zugriffsnummer (Handle) mit der auf den Datensatz zugegriffen
werden kann. Falls der Datensatz nicht erzeugt werden kann, ist *hData* gleich 0.

.. us.params

**Parameter**

.. uparam:: ssName

   *ssName* ist ein skalarer String mit maximal 40 Zeichen.

.. uparam:: rvY

   *rvY* ist ein Vektor mit den Y-Koordinaten. Der Vektor muss mindestens eine
   Koordinate enthalten.

.. uparam:: hDoc

   *hDoc* ist die Zugriffsnummer des Dokuments, dem der Datensatz
   zugeordnet werden soll. Ab UniPlot 5.3 wird dieser Parameter ignoriert.

.. us.comment

**Kommentar**

*TYCreate* erzeugt einen 2D-Datensatz mit Delta-X gleich 1 und
der ersten X-Koordinate gleich 0. Diese Werte können mit der Funktion
:ref:`TYSetMinAndDelta` geändert werden. Auf den Datensatz können alle
XY...-Funktionen angewendet werden.

Beim Aufruf ohne Daten wird ein leerer Datensatz erzeugt. 

.. us.example

**Beispiel**

.. include:: ../include/test_TYCreate.ic

.. us.history

**History**

.. list-table::
   :header-rows: 1

   * - Version
     - Beschreibung
   * - 5.3.0
     - *hDoc* ist nicht mehr erforderlich. Der Parameter wird ignoriert.

.. seealso::
   :ref:`uberblick-xy-datensatze`,
   :ref:`LayerCreate`,
   :ref:`TYSetMinAndDelta`,
   :ref:`TYSetData`,
   :ref:`TYAddData`,
   :ref:`XYIsTYDataset`,
   :ref:`XYCreate`

:sub:`id-824057`