.. highlightlang:: us

.. index:: auto_LoadDataset_CycleIndex
.. index:: auto_LoadDataset_CycleIndexEx

.. _auto_loaddataset_cycleindex:

auto_LoadDataset_CycleIndex
===========================

.. us.tag  auto_LoadDataset GERMAN Changed5514

:ref:`auto_LoadDataset` lädt aus einer Daten-Datei, die mit der Funktion
:ref:`auto_ImportData` geöffnet wurde, einen 1D-, 2D- oder 3D-Datensatz.

.. function:: hvData = auto_LoadDataset_CycleIndex(ssDiagram, ssXName, ssYName, ssIndexName, bXSort, rvIndex)
    hvData = auto_LoadDataset_CycleIndexEx(hLayer, ncid, ssXName, ssYName, ssIndexName, bXSort)
    hvData = auto_LoadDataset_CycleIndexEx(hLayer, ncid, ssXName, ssYName, ssIndexName, bXSort, rvIndex)

.. us.return

**Returnwert**

*hvData* ist ein Vektor mit den Zugriffsnummern der erzeugten Datensätze. Im 
Fehlerfall hat das erste Element den Wert 0.

.. us.params

**Parameter**

.. uparam:: ssDiagram

   *ssDiagram* ist der Name des Diagramms, in das der Datensatz ausgegeben werden
   soll.

.. uparam:: hLayer

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

.. uparam:: ssXName

   *ssXName* Name des Kanals mit den x-Koordinaten. Die Schreibweise sollte mit
   der Schreibweise in der NC-Datei übereinstimmen (siehe :ref:`dateidaten-importieren`).

.. uparam:: ssYName

   *ssYName* Name des Kanals mit den y-Koordinaten. Die Schreibweise sollte mit
   der Schreibweise in der NC-Datei übereinstimmen (siehe :ref:`dateidaten-importieren`).

.. uparam:: ssIndexName

   *ssIndexName* ist der Name des Kanals mit den Indexwerten. Die Funktion 
   erwartet ganze Zahlen größer als 0, z. B. 1, 2, 3, etc.  

   Falls *bXSort* TRUE (1)ist, werden die X-Koordinaten aufsteigend sortiert.

.. uparam:: rvIndex

   *rvIndex* ist ein Vektor mit den Indexwerten, die geladen werden sollen.
   Wenn der Wert 0 übergeben wird, werden alle Kurven geladen.

.. uparam:: ncid

   *ncid* ist die Zugriffsnummer, die von einem erfolgreichen Aufruf der
   Funktionen :ref:`nc_open` geliefert wurde.

.. us.comment

**Kommentar**

Die Funktion erzeugt für jeden Indexwert eine Kurve. Gültige Indexwerte
sind ganze Zahlen größer als 0. Beispiel [1,1,1,2,2,2,2,3,3]. Für diesen
Indexkanal können drei Datensätze (Kurven) erzeugt werden. Der erste
enthält  3 Punkte, der zweite Datensatz 4 Punkte und der letzte Datensatz
2 Punkte.

.. us.example

**Beispiel**

::

   hvData = auto_LoadDataset_CycleIndex("Diagramm 1", "CA", "p_cyl1", "Index", TRUE, [1,2,3])
   if (hvData[1] == 0) {
       MessageBoxError("Cannot create dataset '%s, %s, %s'", "CA", "p_cyl1", "Index");
       return TRUE;
   }

**Beispiel**

::

   auto_AddToUI("Examples", "Example 1: Cycle", "RS_Example_cycleindex");
   
   def RS_Example_cycleindex()
   {
       svFile = auto_GetFileNameDialog(1);
       if (svFile[1] == "DLG_CANCEL") {
           return;
       }
       auto_LoadTemplate(GetRootDirectory() + "samples/automate/Example.ipw");
       auto_SetImportOptions(2);
       auto_ImportData(svFile[1]);
       auto_LoadDataset_CycleIndex("Diagramm 1", "EngSpd", "SAETrq", "Index", TRUE, [1,2,3]);
       auto_LoadDataset_CycleIndex("Diagramm 2", "EngSpd", "SAEPwr", "Index", TRUE, 0);  // alle laden
       auto_ScaleAxes();
       auto_UpdatePage();
   } 

**History**

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

   * - Version
     - Beschreibung
   * - R2013.14
     - Neuer erster Parameter *hLayer*.

.. seealso::
   :ref:`uberblick-automatisierung-der-diagrammerstellung`,
   :ref:`auto_LoadTemplate`,
   :ref:`auto_SetTemplate`,
   :ref:`auto_LoadMatrixDataset`,
   :ref:`auto_LoadCompressorMap`,
   :ref:`PageGetLayerHandle`,
   :ref:`GetParent`

:sub:`id-1627322`