.. highlightlang:: us

.. index:: DS_SetDataSource

.. _ds_setdatasource:

DS_SetDataSource
================

.. us.tag DS_SetDataSource NOTREADYGERMAN DataSource New5200

:ref:`DS_SetDataSource` schreibt den Datendateinamen und die Kanalnamen eines
Datensatzes in die "Datasource"-Map des Datensatzes.

.. function:: hMap = DS_SetDataSource(hData, ssNetCDFName, svChannels)
    hMap = DS_SetDataSource(hData, ssNetCDFName, svChannels, options)

.. us.return

**Returnwert**

Die "Datasource"-Map des Datensatzes oder 0, wenn ein Fehler aufgetreten
ist.

.. us.params

**Parameter**

.. uparam:: hData

   *hData* ist die Zugriffsnummer eines Datensatzes.

.. uparam:: ssNetCDFName

   *ssNetCDFName* ist der vollständige Name einer vorhandenen UniPlot-Datendatei
   (.nc oder .nc2).

.. uparam:: svChannels

   *svChannels* ist ein Vektor mit Kanalnamen.

.. uparam:: options

   *options* ist ein optionales Objekt.

.. us.comment

**Kommentar**

Falls die Funktion mit 3 Parametern aufgerufen wurde, werden folgende Items
erzeugt:

.. list-table::
   :header-rows: 0

   * - NCFile
   * - DatasetType
   * - Channel

Falls *ssNetCDFName* geöffnet werden kann, werden zusätzlich folgende Items 
erzeugt:

.. list-table::
   :header-rows: 0

   * - NCFileTime
     -
   * - Origin
     -
   * - OriginTime
     -
   * - units
     -
   * - CycleInfo 
     - Falls in der NC-Datei vorhanden.
   * - NumberOfPointsSource
     -
   * - DataFilter
     -

Falls die Funktion mit 4 Parametern aufgerufen wurde und *options.ncid* ungleich
-1 ist, wird diese *ncid* zum Zugriff auf die netCDF-Datei verwendet.

Falls *options* weitere Items enthält, werden Sie in die Datensatz-Map
geschrieben. Es werden dabei die aus der netCDF-Datei gelesenen Attribute 
überschrieben.

Folgende Items können bei Bedarf gesetzt werden:

.. list-table::
   :header-rows: 0

   * - FirstPoint
   * - NumberOfPoints
   * - AutoReload
   * - XSort

.. us.example

**Beispiel**

.. include:: ../include/test_DS_SetDataSource.ic

.. us.history

**History**

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

   * - Version
     - Beschreibung
   * - 5.20
     - Neu.

.. seealso::
   :ref:`overview-data-file-informations-for-datasets`,
   :ref:`XYCreate`,
   :ref:`DS_SetValue`,
   :ref:`DS_RemoveValue`,
   :ref:`XYReload`,
   :ref:`XYClip`

:sub:`id-1238667`