.. highlightlang:: us

.. index:: plot

.. _plot:

plot
====

.. us.tag  plot GERMAN

:ref:`plot` gibt eine x/y-Kurve aus.

.. function::  rvHandle = plot(rvX, rvY)
    rvHandle = plot(rvX, rvY, handle)

.. us.return

**Returnwert**

*rvHandle* ist ein Vektor mit Zugriffsnummern:

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

   * - Wert
     - Bedeutung
   * - rvHandle[1]
     - ist die Zugriffsnummer der Seite in das die Kurve gezeichnet wurde.
   * - rvHandle[2]
     - ist die Zugriffsnummer des Layers (Diagramms) in das die Kurve gezeichnet
       wurde.
   * - rvHandle[3]
     - ist die Zugriffsnummer der Kurve (des Datensatzes).

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

   *handle* ist entweder die Zugriffsnummer von einem Layer (Diagramm) oder von
   einer Seite. Falls die Zugriffsnummer von einem bestehenden Diagramm stammt,
   wird die neue Kurve in den Layer eingefügt. Falls die Zugriffsnummer von einer
   Dokument-Seite stammt, wird ein neues Diagramm mit der Kurve in der Seite
   ausgegeben.

.. us.example

**Beispiel**

Die folgenden Zeilen erzeugen ein Diagramm mit einer sinus- und
einer cosinus-Kurve

::

   x = linspace(0, 2*PI);
   y = sin(x);
   h1 = plot(x, y);
   y = cos(x)
   h2 = plot(x, y, h1[2]);

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

:sub:`id-1857435`