.. highlightlang:: us

.. _auto_xyz_createpowermap:

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

.. index:: auto_xyz_CreatePowermap

.. us.tag  auto_xyz_CreatePowermap NOTREADYENGLISH auto_xyz

:ref:`auto_xyz_CreatePowermap` creates a power map (power hyperbola).

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

.. us.return

**Return Value**

*hDataNew* is TRUE (1) if the function was successful, otherwise FALSE (0).

.. us.params

**Parameters**

.. uparam:: hData

   *hData* is the handle of a 3D dataset. The x
   coordinates of the dataset must be revolutions per minute and the y
   coordinates must be torque in Nm.

.. uparam:: rsPowerDelta

   specifies the power curve distance.

.. uparam:: rvRange

   *rvRange* specifies the range of the
   power map. *rvRange* is a vector with four elements:

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

   * - Value
     - Meaning
   * - rvRange[1]
     - minimum revolution per minute [1/min]
   * - rvRange[2]
     - minimum torque [Nm]
   * - rvRange[3]
     - maximum revolution per minute [1/min]
   * - rvRange[4]
     - maximum torque [Nm]

.. uparam:: rmXYS

   *rmXYS* is a matrix with three columns which is
   return by the function :ref:`XYZGetHullData`.

.. us.comment

**Comment**

The matrix has 50 Columns and 50 Rows.

.. seealso::
   :ref:`overview-automation`

:sub:`id-554249`