.. highlightlang:: us

.. index:: plotxyz

.. _plotxyz:

plotxyz
=======

.. us.tag  plotxyz GERMAN New520

:ref:`plotxyz` erzeugt einen 3D-Datensatz und gibt den Datensatz in einem
Diagramm aus. Die Daten können entweder als XYZ-Tripel oder als Matrix vorliegen.
Die XYZ-Tripel können beliebig in der XY-Ebene verteilt sein. Es sind mindestens
3 Koordinaten-Tripel erforderlich, um einen 3D-Datensatz erzeugen zu können. Aus
den XYZ-Tripeln wird durch Interpolation eine Z-Matrix berechnet.

.. function::  hData = plotxyz(rvX, rvY, rvZ)
    hData = plotxyz(rvX, rvY, rmZ)
    hData = plotxyz(rvX, rvY, rvZ, option)
    hData = plotxyz(rvX, rvY, rmZ, option)

.. us.return

**Returnwert**

.. 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:: rvX

   *rvX* ist ein reeller Vektor mit den x-Koordinaten.

.. uparam:: rvY

   *rvY* ist ein reeller Vektor mit den y-Koordinaten.

.. uparam:: rvZ

   *rvZ* ist ein reeller Vektor mit den Z-Koordinaten.

.. uparam:: rmZ

   *rmZ* ist eine Matrix mit den Z-Koordinaten. Falls die Abstände der
   Matrixspalten und -zeilen konstant sind, können die x/y-Koordinaten der Matrix
   über den Parameter *rvRect* festgelegt werden. Wenn die Abstände der Spalten
   oder Zeilen nicht konstant sind, werden die Koordinaten über die Parameter
   *rvX* und *rvY* festgelegt. In diesem Fall ist der Parameter *rvX*
   ein Vektor mit den X-Koordinaten der Matrixspalten und *rvY* ein Vektor mit
   den Y-Koordinaten der Matrixzeilen. In diesem Fall wird keine Interpolation
   durchgeführt.

.. uparam:: option

   Der Parameter *option*  ist ein Objekt, das Optionen enthalten kann.
   Der Parameter ist optional. Siehe Beispiel.
   Die folgenden Optionen werden ausgewertet:

.. list-table::
   :header-rows: 0

   * - xTitle
     - x-Achsen Titel, Default = "": Titel wird nicht geändert.
   * - yTitle
     - y-Achsen Titel, Default = "": Titel wird nicht geändert.
   * - zTitle
     - z-Achsen Titel, Default = "": Titel wird nicht geändert.
   * - name
     - Datensatz Name, wird über die Funktion :ref:`SetDataInfo` gesetzt.
   * - hLayer
     - Diagramm-Handle, in das der neue Datensatz eingefügt wird.
   * - autoscale
     - Falls autoscale den Wert 0 hat wird nicht automatisch skaliert.
   * - props
     - Optionale Parameter für die Darstellung, siehe :ref:`XYZSetProps` für mögliche Werte.
   * - hData
     - Datensatz-Handle eines 3D-Datensatzes, dessen Einstellung für den neuen Datensatz übernommen werden.
   * - Layer3D
     - Wenn Wert = 1 wird in 3D-Darstellung umgeschaltet,  Wert = 0: 2D-Darstellung. Wert -1 ändert die Darstellung nicht. Default=-1.

.. us.example

**Beispiel**

::

   nRC = 40
   xmin = 0.05-PI/2;
   xmax = 0.05+PI;
   ymin = -PI/2;
   ymax =  PI/2
   x = linspace(xmin, xmax, nRC);
   y = linspace(ymin, ymax, nRC);
   <xx, yy> = meshdom(x,y);
   zz = real(tan(xx + 1i * yy));
   /*
   option = [.]; // Create object
   option.name = "real(tan(xx + 1i * y))";
   option.autoscale = 1;
   option.props = "surface-type = '2'"; // STYLE_SURF_COLORGRADIENT
   option.Layer3D = 1;
   */
   // another syntax to create the option object
   option = [. name = "real(tan(xx + 1i * y))", autoscale = 1,
               props = "surface-type = '2'", Layer3D = 1];
   plotxyz(x, y, zz, option);

.. seealso::
   :ref:`DocCreate`,
   :ref:`PageCreate`,
   :ref:`PageGetParentDocument`,
   :ref:`LayerCreate`,
   :ref:`XYCreate`,
   :ref:`GetParent`,
   :ref:`XYZSetProps`

:sub:`id-839714`