.. highlightlang:: us

.. index:: XYGetErrorData

.. _xygeterrordata:

XYGetErrorData
==============

.. us.tag  XYGetErrorData GERMAN xy.data New6001

:ref:`XYGetErrorData` gibt die Fehlerwerte zurück. Die
Fehlerwerte werden für die Ausgabe der Fehlerbalken
verwendet.

.. function::  rmError = XYGetErrorData(hData, ssXY)

.. us.return

**Returnwert**

*rmError* ist eine zweispaltige Matrix der Fehlerwerte. ``rmError[;1]`` sind die
negativen Fehler und ``rmError[;2]`` sind die positiven Fehler. Falls der 
Datensatz keine Fehlerwerte enthält, wird der skalare Wert 0 zurück gegeben.

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

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

**History**

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

   * - Version
     - Beschreibung
   * - 5.20.0
     - Die Behandlung des Parameters *nCount* geändert. Der Wert kann nun auch eine Maximalanzahl an gewünschten Werten enthalten.

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

:sub:`id-1771447`