.. highlightlang:: us

.. index:: auto_xy_Statistic

.. _auto_xy_statistic:

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

.. us.tag  auto_xy_Statistic NOTREADYENGLISH auto_xy

:ref:`auto_xy_Statistic` calculates some
statistical values and returns them as a string.

.. function::  ssText = auto_xy_Statistic(hData)

.. us.return

**Return Value**

*ssText* is a string with statistical numbers of the
given dataset: Minimum, maximum, arith. mean, mean deviation,
variance, standard deviation.

.. us.params

**Parameters**

.. uparam:: hData

   *hData* is the handle of a 2D-dataset.

.. us.example

**Example**

::

   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:`overview-automation`,
   :ref:`auto_LoadTemplate`,
   :ref:`auto_LoadDataset`,
   :ref:`auto_ReplaceText`

:sub:`id-725218`