.. highlightlang:: us

.. _auto_xy_statistic:

auto_xy_Statistic
=================

.. index:: auto_xy_Statistic

.. us.tag  auto_xy_Statistic NOTREADYGERMAN auto_xy

:ref:`auto_xy_Statistic` berechnet einige
statistische Kennzahlen eines 2D-Datensatzes.

.. function::  ssText = auto_xy_Statistic(hData)

.. us.return

**Returnwert**

*ssText* ist eine Zeichenkette mit den statistische
Kennzahlen für die y-Koordinaten des gegebenen 2D-Datensatzes:
Minimum, Maximum, arithmetischer Mittelwert, Mittlere Abweichung,
Varianz und Standard-Abweichung. Der Text kann mit Hilfe der Funktion
:ref:`auto_ReplaceText` in die Vorlage eingetragen werden.

.. us.params

**Parameter**

.. uparam:: hData

   *hData* ist die Zugriffsnummer (Handle) des
   Datensatzes (*hData*) auf den die Funktion angewendet werden soll.

.. us.comment

**Kommentar**

Der Datensatz mit dem Handle *hData* muss in jedem Fall einem
Diagramm zugeordnet sein, ansonsten geben alle ``auto_xy_`` -
Funktionen den Wert 0 (Datensatz konnte nicht erzeugt werden) zurück.

.. us.example

**Beispiel**

::

   hPage = auto_LoadTemplate("Sample", "Sample 1");
   auto_ImportData(GetRootDirectory() + "samples/vollast.asc");
   hData = auto_LoadDataset("Diagramm 1", "N", "PME");

   ssText = auto_xy_Statistic(hData);
   hText = auto_ReplaceText("$STAT$", ssText)

   hFont = TBGetFont(hText)
   FontSetFaceName(hFont, "Courier New")
   TBSetFont(hText, hFont)
   rvRect = OBJGetPosSize(hText)
   tsize = TBGetTextExtend(hText);
   rvRect[3] = tsize[1];
   rvRect[4] = tsize[2];
   OBJSetPosSize(hText, rvRect);

   auto_ScaleAxes();
   auto_UpdatePage();

.. seealso::
   :ref:`uberblick-automatisierung-der-diagrammerstellung`,
   :ref:`auto_LoadTemplate`,
   :ref:`auto_LoadDataset`

:sub:`id-725218`