.. highlightlang:: us

.. index:: Überblick XYZ-Datensätze, XYZ-Datensätze 

.. _uberblick-xyz-datensatze:

Überblick XYZ-Datensätze
========================

Am einfachsten können die Eigenschaften eines Datensatzes mit der Funktion
:ref:`XYZSetProps` gesetzt werden (ab UniPlot 4.0.3).

.. us.indexlist ErzeugenundZerstörenXYZCreateXYZDestroyX,Erzeugen und Zerstören,XYZCreate,XYZDestroy,XYZCreateFromMatrix,

.. include:: ../ftab/ErzeugenundZerstörenXYZCreateXYZDestroyX.ftab

.. us.makeindex   XYZSet_data, Daten und Interpolation (Setzen)

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

.. us.makeindex   XYZGet_data, Daten und Interpolation (Erfragen)

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

**Isolinien**

Für die Isolinien verwendet UniPlot intern eine Tabelle mit 100 Plätzen. Die
Tabelle legt die Werte der Isolinien, die Farbfüllung zwischen 2 Isolinienwerten
sowie die Zeichenstifte für die Isolinien fest.

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

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

Der Tabelleneintrag mit dem Index 0 legt die Farbe für die Fläche die kleiner als
der Isolinienwert mit dem Index 1 ist fest (:ref:`XYZSetFillMinColor`).

Die Spalte Iso-Wert kann mit den Funktionen :ref:`XYZAddIsoValues`, :ref:`XYZSetIsoValues`
und :ref:`XYZDeleteIsoValues` geändert werden. Über die Funktion
:ref:`XYZGetNumberOfIsoValues` kann erfragt werden, wieviele der 99 Plätze verwendet
werden. 

Die Spalte Iso-Color wird mit der Funktion :ref:`XYZSetFillColors` geändert und die
Spalte Iso-Pen mit der Funktion :ref:`XYZSetPens`.

Beispiele (der Pfeil in der ersten Spalte zeigt die Zahl, die die Funktion 
:ref:`XYZGetNumberOfIsoValues` zurück geben würde an):

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

   * - Index
     - Iso-Wert
     - Iso-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])

ändert die Tabelle in

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

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

::

   XYZAddIsoValues(hData, [250,350])

ändert die Tabelle in

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

   * - Index
     - Iso-Wert
     - Iso-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_iso, Isolinien (Setzen)

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

.. us.makeindex   XYZGet_iso, Isolinien  (Erfragen)

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

.. us.makeindex   XYZSet_label, Isolinien-Beschriftungen (Setzen)

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

.. us.makeindex   XYZGet_label, Isolinien-Beschriftungen  (Erfragen)

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

.. us.makeindex   XYZSet_hull, Hülle (Setzen)

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

.. us.makeindex   XYZGet_hull, Hülle (Erfragen)

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

.. us.makeindex   XYZSet_scatter, Streuplot (Setzen)

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

.. us.makeindex   XYZGet_scatter, Streuplot (Erfragen)

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

.. us.makeindex   XYZSet_3d, Oberflächenplot (Setzen)

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

.. us.makeindex   XYZGet_3d, Oberflächenplot (Erfragen)

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

.. us.makeindex   XYZSet, Sonstiges (Setzen)

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

.. us.makeindex   XYZGet, Sonstiges (Erfragen)

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

.. seealso::
   :ref:`funktionen-eingeteilt-in-kategorien`

:sub:`id-893074`