.. highlightlang:: us

.. _auto_xyz_createpowermap:

auto_xyz_CreatePowermap
=======================

.. index:: auto_xyz_CreatePowermap

.. us.tag  auto_xyz_CreatePowermap NOTREADYGERMAN auto_xyz

:ref:`auto_xyz_CreatePowermap` erzeugt ein Leistungskennfeld
(Leistungshyperbeln).

.. function::  hDataNew = auto_xyz_CreatePowermap(hData, rsPowerDelta)
    hDataNew = auto_xyz_CreatePowermap(ssName, hLayer, rvRange, rsPowerDelta, rmXYS)

.. us.return

**Returnwert**

*hDataNew* ist TRUE (1), wenn die Funktion erfolgreich war und
sonst FALSE (0).

.. us.params

**Parameter**

.. uparam:: hData

   *hData* ist die Zugriffsnummer eines 3D-Datensatzes.
   Der Datensatz muss als X-Koordinate die Drehzahl [1/min] und als
   Y-Koordiante das Drehmoment [Nm] darstellen. Die neue Matrix wird dem
   Diagramm zugeordnet, in dem sich der Datensatz mit der Zugriffsnummer
   *hData* befindet. Falls *hData* noch keinem Diagramm zugeordnet
   wurde, kann kein Leistungs-Kennfeld berechnet werden.

.. uparam:: rsPowerDelta

   legt den Abstand in kW von benachbarten
   Leistungshyperbeln fest.

.. uparam:: rvRange

   *rvRange* legt fest, in welchem Bereich das
   Leistungskennfeld berechnet werden soll.  *rvRange* ist ein Vektor
   mit vier Elementen:

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

   * - Wert
     - Bedeutung
   * - rvRange[1]
     - Kleinste Drehzahl [1/min]
   * - rvRange[2]
     - Kleinstes Moment [Nm]
   * - rvRange[3]
     - Größte Drehzahl [1/min]
   * - rvRange[4]
     - Größtes Moment [Nm]

.. uparam:: rmXYS

   *rmXYS* ist eine dreispaltige Matrix, wie sie die
   Funktion :ref:`XYZGetHullData` zurück liefert.

.. us.comment

**Kommentar**

Die berechnete Matrix hat 50 Spalten und 50 Zeilen.

.. seealso::
   :ref:`uberblick-automatisierung-der-diagrammerstellung`

:sub:`id-554249`