.. highlightlang:: us

.. index:: auto_xy_CreateErrorDataset 
.. index:: auto_xy_CreateErrorDatasetEx

.. _auto_xy_CreateErrorDataset: 

auto_xy_CreateErrorDataset 
==========================

.. us.tag  auto_xy_CreateErrorDataset GERMAN auto_xy New6001

:ref:`auto_xy_CreateErrorDataset` erzeugt einen neuen 2D-Datensatz mit
Fehlerbalken.

.. function::  hData = auto_xy_CreateErrorDataset(hLayer, ssName, rvX, rvY, rvMinusError, rvPlusError)
               hData = auto_xy_CreateErrorDatasetEx(hLayer, ncid, svVarName)
               hData = auto_xy_CreateErrorDatasetEx(hLayer, ncid, svVarName, oParameter)
               hData = auto_xy_CreateErrorDatasetEx(hLayer, ssNCName, svVarName)
               hData = auto_xy_CreateErrorDatasetEx(hLayer, ssNCName, svVarName, oParameter)

.. us.return

**Returnwert**

*hData* ist die Zugriffsnummer (Handle) des neu erstellten Datensatzes oder 0
im Falle eines Fehlers.

.. us.params

**Parameter**

.. uparam:: hLayer

   *hLayer* ist die Zugriffsnummer des Diagramms, in das der Datensatz
   ausgegeben werden soll (siehe :ref:`PageGetLayerHandle`). 

.. uparam:: ssName

   *ssName* ist der Name des Datensatzes der mit :ref:`XYCreate` erstellt
   wird.

.. uparam:: rvX

   *rvX* ist ein Vektor mit x-Koordianten.

.. uparam:: rvY

   *rvY* ist ein Vektor mit y-Koordinaten.

.. uparam:: rvMinusError

  *rvMinusError* ist ein Vektor mit den negativen Fehler-Balken.

.. uparam:: rvPlusError

  *rvPlusError* ist ein Vektor mit den positiven Fehler-Balken. Die Anzahl der
  Werte muss mit der Anzahl an Werten in *rvMinusError* und der Anzahl der
  x-/y-Koordinaten übereinstimmen.
   
.. uparam:: ncid

   *ncid* ist die Zugriffsnummer (Handle) einer NC-Datei, die von einem
   erfolgreichen Aufruf von :ref:`nc_create` zurückgeliefert wurde.

.. uparam:: ssNCFile

   *ssNCFile* ist der Dateiname einer NC-Datei.
   
.. uparam:: svVarName

  *svVarName* ist ein Vektor von String-Werten mit 4 Kanalnamen: ``["x", "y",
  "minusError", "plusError"]``. Die Werte für x, y, Minus- und Plus-Fehler
  werden aus diesen Kanälen gelesen

.. uparam:: oParameter

   *oParameter* ist ein Objekt mit optionalen Parametern, zum Beispiel
   ``[. bXSort = TRUE ]``.

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

      * - Element Name
        - Beschreibung
        - Default-Wert
      * - ``bXSort``
        - Nach x sortieren.
        - ``FALSE``

.. us.comment

**Kommentar**

The positive error values are added to the data point and the minus error
values are subtracted from the data value. An error value of 0 is not
displayed. The number of data points is limited to 200,000. The number of
error points must match the number of data points in the dataset.

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

**History**

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

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

.. seealso::
   :ref:`overview-automation`,
   :ref:`XYSetErrorData`,

:sub:`id-999724`