.. highlightlang:: us

.. index:: XYSetErrorData

.. _xyseterrordata:

XYSetErrorData
==============

.. us.tag  XYSetErrorData GERMAN xy.data New6001

:ref:`XYSetErrorData` setzt die Fehlerwerte. Die
Fehlerwerte werden für die Ausgabe der Fehlerbalken
verwendet.

.. function::  bool = XYSetErrorData(hData, ssXY, rvMinusError, rvPlusError)
               bool = XYSetErrorData(hData, ssXY)

.. us.return

**Returnwert**

*bool* ist TRUE (1), wenn die Werte gesetzt werden konnten und sonst FALSE (0).

.. us.params

**Parameter**

.. uparam:: hData

   *hData* ist die Zugriffsnummer (Handle) des Datensatzes, der mit :ref:`XYCreate`
   erzeugt wurde.

.. uparam:: ssXY

   *ssXY* ist "X" für die Fehler in x-Richtung und "Y" für die Fehler in
   y-Richtung.

.. uparam:: rvMinusError

  Vektor mit den negativen Fehlerwerten. Die Fehlerwerte müssen größer als 0 sein.
  Negative Fehler bzw. ein Fehler mit dem Wert 0 werden nicht ausgegeben.

.. uparam:: rvPlusError

  Vektor mit den positiven Fehlerwerten. Die Anzahl der Datenpunkte muss gleich
  der Anzahl der Datenpunkte in *rvMinusError* und der Datenpunkte im Datensatz
  sein.

.. us.comment

**Kommentar**

Die Fehlerwerte werden positiv eingegeben. Sie werden relativ zum Anzeigewert
definiert. Positive Fehler werden zum Anzeigewerte addiert und negative 
Fehler subtrahiert. Fehler mit dem Wert 0 werden nicht ausgegeben.
Die Anzahl der Datenpunkte ist auf 200.000 beschränkt.
Die Anzahl der Fehlerwerte muss genau mit der Anzahl der 
Datenpunkte im Datensatz übereinstimmen. Ansonsten werden 
keine Fehlerbalken angezeigt.

Beim Aufruf mit zwei Parametern werden die Fehlerwerte gelöscht.

.. us.example

**Beispiel**

::

   hDoc = DocCreate();
   hPage = PageCreate();
   hLayer = LayerCreate();
   DocAddPage(hDoc, hPage);
   PageAddLayer(hPage, hLayer);

   rvX = [1, 2, 3, 4, 5];
   rvY = [3, 5, 4, 6, 5];
   rvMErr = [0.3, 0.4, 0.5, 0, 0.7];  // minus error
   rvPErr = [0.2, 0.5, 0, 0.6, 0.3];  // plus error

   hData = auto_xy_CreateErrorDataset(hLayer, "Test", rvX, rvY, rvMErr, rvPErr);
   LayerAutoScale(hLayer);

   rvConfig = XYGetErrorbarConfig(hData, "Y");
   PenSetColor(rvConfig[1], [255,0,0]) // red
   PenSetWidth(rvConfig[1], 5) // line width
   rvConfig[2] = 5; // line width
   rvConfig[3] = 0.3; // width in cm
   XYSetErrorbarConfig(hData, "Y", rvConfig);
   PenDestroy(rvConfig[1]);  // Delete Pen

**History**

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

   * - Version
     - Beschreibung
   * - R2018.1
     - Neu

.. seealso::
   :ref:`uberblick-xy-datensatze`,
   :ref:`XYGetErrorData`,
   :ref:`XYGetErrorbarConfig`,
   :ref:`XYSetData`,
   :ref:`XYCreate`,
   :ref:`XYSetScaleOffset`,
   :ref:`XYSetGetOrgDataFlag`

:sub:`id-1820599`