.. highlightlang:: us

.. _xygetdatasource:

XYGetDataSource
===============

.. index:: XYGetDataSource

.. us.tag  XYGetDataSource ENGLISH xy.data

:ref:`XYGetDataSource` returns the dataset source.

.. function::  ssDataSource = XYGetDataSource(hData)

.. us.return

**Return Value**

*ssDataSource* is a string with the file name, optional
import options and a list with the variable names. Example:
``c:/data/test.asc{2,BTS} (Speed, Torque)``. The import options are
enclosed in ``{}`` and the variabale names are enclosed in ``()``. For
Excel Files the table name can follow the file name in ``[]``
brackets. Example: ``c:/data/test.asc [Table1]{2,BTS} (RPM, Torque)``

.. us.params

**Parameters**

.. uparam:: hData

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

.. seealso::
   :ref:`overview-xy-datasets`,
   :ref:`XYSetDataSource`

:sub:`id-540551`