.. highlightlang:: us

.. index:: TYCreate

.. _tycreate:

TYCreate
========

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

:ref:`TYCreate` creates a new y/t datasets (1D dataset).

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

.. us.return

**Return Value**

If the function succeeds, the return value is the handle of the newly created
1D dataset. If the function fails, the return value is 0.

.. us.params

**Parameters**

.. uparam:: ssName

   *ssName* is the name for the dataset.

.. uparam:: rvY

   *rvY* is a vector with y-coordinates.The vector must contain at least
   2 elements.

.. uparam:: hDoc

   *hDoc* is the handle of a document which will hold the created dataset.
   Beginning with UniPlot 5.3 this parameter is ignored.

.. us.comment

**Comment**

*TYCreate* creates a 2D dataset with delta x equal 1 and the first x-coordinate
equal 0. These values can be changed with the :ref:`TYSetMinAndDelta` function.
The XY...-functions can be used to modify the dataset.

A function call without data creates an empty dataset.

.. us.example

**Example**

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

.. us.history

**History**

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

   * - Version
     - Description
   * - 5.3.0
     - Parameter *hDoc* is ignored

.. seealso::
   :ref:`overview-xy-datasets`,
   :ref:`LayerCreate`,
   :ref:`TYSetMinAndDelta`,
   :ref:`TYSetData`,
   :ref:`TYAddData`,
   :ref:`XYIsTYDataset`,
   :ref:`XYCreate`

:sub:`id-824057`