.. highlightlang:: us

.. index:: Overview XYZ-Datasets, XYZ-Datasets 

.. _overview-xyz-datasets:

Overview XYZ-Datasets
=====================

.. us.indexlist CreateandDestroyXYZCreateXYZDestroyXYZCr,Create and Destroy,XYZCreate,XYZDestroy,XYZCreateFromMatrix,

.. include:: ../ftab/CreateandDestroyXYZCreateXYZDestroyXYZCr.ftab

A simple way to set attributes of a 3D dataset is using the :ref:`XYZSetProps` 
function (since UniPlot 4.0.3).

UniPlot uses for isolines a table for 100 isoline values. The table sets
the isoline value, fill color and line style.

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

   * - Index
     - Iso-Value
     - Fill-Color
     - Iso-Pen
   * - 0
     - ``-``
     - red
     - ``-``
   * - 1
     - 100
     - green
     - solid-1-black
   * - 2
     - 200
     - blue
     - solid-1-black
   * - 3
     - 
     - 
     - 
   * - ...
     - 
     - 
     - 
   * - 99
     - 
     - 
     - 

The entry with index 0 only sets the fill color (:ref:`XYZSetFillMinColor`).

The column Iso-Value can be modified with :ref:`XYZAddIsoValues`, :ref:`XYZSetIsoValues`
and :ref:`XYZDeleteIsoValues`.:ref:`XYZGetNumberOfIsoValues` returns the 
number of specified values.

The column Fill-Color can be modified with :ref:`XYZSetFillColors` and Iso-Pen
with :ref:`XYZSetPens`.

Example (The arrow in the first column shows the value:ref:`XYZGetNumberOfIsoValues` would
return):

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

   * - Index
     - Iso-Value
     - Fill-Color
     - Iso-Pen
   * - 0
     - ``-``
     - red
     - ``-``
   * - 1
     - 100
     - green
     - solid-1-black
   * - 2
     - 200
     - blue
     - solid-2-black
   * - 3
     - 300
     - white
     - solid-3-black
   * - ->4
     - 400
     - black
     - solid-4-black

::

   XYZSetIsoValues(hData, [200,300])

will modify the table to

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

   * - Index
     - Iso-Value
     - Fill-Color
     - Iso-Pen
   * - 0
     - ``-``
     - red
     - ``-``
   * - 1
     - 200
     - blue
     - solid-2-black
   * - ->2
     - 300
     - white
     - solid-3-black

::

   XYZAddIsoValues(hData, [250,350])

will modify the table to

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

   * - Index
     - Iso-Value
     - Fill-Color
     - Iso-Pen
   * - 0
     - ``-``
     - red
     - ``-``
   * - 1
     - 200
     - blue
     - solid-1-black
   * - 2
     - 250
     - blue
     - solid-1-black
   * - 3
     - 300
     - white
     - solid-3-black
   * - ->4
     - 350
     - white
     - solid-3-black

.. us.makeindex   XYZSet, Set

.. include:: ../ftab/XYZSet.ftab

.. us.makeindex   XYZGet, Get

.. include:: ../ftab/XYZGet.ftab

.. us.makeindex   XYZSet_iso, Isolines (Set)

.. include:: ../ftab/XYZSet_iso.ftab

.. us.makeindex   XYZGet_iso, Isolines  (Get)

.. include:: ../ftab/XYZGet_iso.ftab

.. us.makeindex   XYZSet_label, Isoline Label (Set)

.. include:: ../ftab/XYZSet_label.ftab

.. us.makeindex   XYZGet_label, Isoline Label (Get)

.. include:: ../ftab/XYZGet_label.ftab

.. us.makeindex   XYZSet_hull, Hull (Set)

.. include:: ../ftab/XYZSet_hull.ftab

.. us.makeindex   XYZGet_hull, Hull (Get)

.. include:: ../ftab/XYZGet_hull.ftab

.. us.makeindex   XYZSet_data, Data and Interpolation (Set)

.. include:: ../ftab/XYZSet_data.ftab

.. us.makeindex   XYZGet_data, Data and Interpolation (Get)

.. include:: ../ftab/XYZGet_data.ftab

.. us.makeindex   XYZSet_scatter, Scatter Plot (Set)

.. include:: ../ftab/XYZSet_scatter.ftab

.. us.makeindex   XYZGet_scatter, Scatter Plot (Get)

.. include:: ../ftab/XYZGet_scatter.ftab

.. us.makeindex   XYZSet_3d, Surface Plot (Set)

.. include:: ../ftab/XYZSet_3d.ftab

.. us.makeindex   XYZGet_3d, Surface Plot (Get)

.. include:: ../ftab/XYZGet_3d.ftab

.. us.makeindex   XYZSet, Miscellanies (Set)

.. include:: ../ftab/XYZSet.ftab

.. us.makeindex   XYZGet, Miscellanies (Get)

.. include:: ../ftab/XYZGet.ftab

.. seealso::
   :ref:`functions-by-categories`

:sub:`id-893074`