.. highlightlang:: us

.. index:: auto_LoadCompressorMap

.. _auto_LoadCompressorMap:

auto_LoadCompressorMap
======================

.. us.tag  auto_LoadCompressorMap GERMAN New5506

:ref:`auto_LoadCompressorMap` lädt aus einer Datendatei, die mit der Funktion
:ref:`auto_ImportData` geöffnet wurde, ein Kompressorkennfeld.

.. function::  hvData = auto_LoadCompressorMap(ssNCName, hLayer, svVarName)
    hvData = auto_LoadCompressorMap(ssNCName, hLayer, svVarName, svConfig)
    hvData = auto_LoadCompressorMap(ncid, hLayer, svVarName)
    hvData = auto_LoadCompressorMap(ncid, hLayer, svVarName, svConfig)

.. us.return

**Returnwert**

*hvData* ist ein Vektor mit den Zugriffsnummern der Datensätze. hvData[1] ist das
Kennfeld. hvData[2] ist die Kurve der Pumpgrenze, hvData[3] ist die Kurve
der Stopfgrenze. Alle weiteren Handle sind die Drehzhahllinien. Im Fehlerfall
liefert die Funktion den Wert 0.

.. us.params

**Parameter**

.. uparam:: ssNCName, ncid

   *ssNCName* ist der Dateiname einer NC-Datei oder eine gültige ncid, siehe
   :ref:`nc_open`.

.. uparam:: hLayer

   *hLayer* ist der Handle eines Diagramms

.. uparam:: svVarName

   *svVarName* ist ein Stringvektor mit 4 Kanalnamen. Die ersten drei Namen 
   definieren das Kennfeld. Der 4. Name ist der Kanal mit den Drehzahlwerten.
   Beispiel: ``["MassFlowRate", "PressureRatio", "Efficiency", "Speed"]``.

.. uparam:: svConfig

   *svConfig* ist ein Stringvektor mit 5 Elementen: 

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

      * - Wert
        - Bedeutung
      * - ``"0"`` or ``"1"``
        - Pumpgrenze anzeigen
      * - ``"0"`` or ``"1"``
        - Stopfgrenze anzeigen
      * - ``"0"`` or ``"1"``
        - Maximale Wirkungsgrad-Kurve anzeigen
      * - ``"0"`` or ``"1"``
        - Kennfeld mit Farbverlauf
      * - ``"0"`` or ``"1"``
        - Drehzahlbeschriftungen rechts (``"1"``), Drehzahlbeschriftungen links (``"0"``)

.. us.comment

**Kommentar**

Erzeug ein Kompressorkennfeld mit Drehzahllinien konstanter Drehzahl.

.. us.example

**Beispiel**

::

   <hDoc, hPage> = _UT_CreateEmptyPage();
   hLayer = LayerCreate();
   PageAddLayer(hPage, hLayer);
   ssDataFile = GetRootDirectory() + "\\samples\\compressor.xls";
   ssNC = auto_ImportData(ssDataFile);
   svVar = ["MassFlowRate", "PressureRatio", "Efficiency", "Speed"];
   svConfig = ["1", "1", "1", "1", "1"];
   auto_LoadCompressorMap(ssNC, hLayer, svVar, svConfig);
   LayerAutoScale(hLayer);
   PageUpdateFields(hPage);
   PageReplot(hPage);

.. us.history

**History**

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

   * - Version
     - Beschreibung
   * - R2013.6
     - Neu.

.. seealso::
   :ref:`uberblick-automatisierung-der-diagrammerstellung`,
   :ref:`auto_LoadTemplate`,
   :ref:`auto_SetTemplate`,
   :ref:`auto_ImportData`,
   :ref:`PageGetLayerHandle`,

:sub:`id-1813023`