.. highlightlang:: us

.. _xyzsetdata:

XYZSetData
==========

.. index:: XYZSetData

.. us.tag  XYZSetData ENGLISH XYZSet_data New500

:ref:`XYZSetData` sets the xyz-coordinates of a dataset.

.. function::  bool = XYZSetData(hData, rvX, rvY, rvZ)
    bool = XYZSetData(hData, rvX, rvY, rvZ, svWOT)

.. us.return

**Return Value**

*bool* 

.. us.params

**Parameters**

.. uparam:: hData

   A handle for a dataset created with :ref:`XYZCreate`.

.. uparam:: rvX

   *rvX* is a vector with x-coordinates.

.. uparam:: rvY

   *rvY* is a vector with y-coordinates.

.. uparam:: rvZ

   *rvZ* is a vector with z-coordinates.

.. uparam:: svWOT

   *svWOT* is a string vector that sets the Full Load Line (WOT).
   Each vector element contains a symbol and can have one of the following values
   ``"a"``, ``"e"``, ``"v"``, ``"A"``, ``"E"``, ``"V"``, ``""``.
   The symbols have the following meanings:

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

   * - Value
     - Meaning
   * - ``"a"``
     - Start of the Full Load Line (WOT) without labels.
   * - ``"e"``
     - End of the Full Load Line (WOT) without labels.
   * - ``"v"``
     - Point belongs to Full Load Line (WOT) and will not be labelled.
   * - ``"A"``
     - Start of the Full Load Line (WOT) with labels.
   * - ``"E"``
     - End of the Full Load Line (WOT) with labels.
   * - ``"V"``
     - Point belongs to Full Load Line (WOT) and will be labelled.
   * - ``""``
     - (empty string) Point does not belong to Full Load Line (WOT).

.. us.history

**History**

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

   * - Version
     - Description
   * - 5.0.0
     - New

.. seealso::
   :ref:`overview-xyz-datasets`,
   :ref:`XYZCreate`,
   :ref:`XYZGetMatrix`,
   :ref:`XYZGetData`

:sub:`id-1531937`