.. highlightlang:: us

.. index:: auto_xy_Envelope

.. _auto_xy_envelope:

auto_xy_Envelope
================

.. us.tag  auto_xy_Envelope NOTREADYENGLISH auto_xy

:ref:`auto_xy_Envelope` creates an upper or lower envelope (hull, boundary).

.. function::  hDataNew = auto_xy_Envelope(hData_Layer, rsWidth, nType)

.. us.return

**Return Value**

*hDataNew* is the handle of the new dataset.

.. us.params

**Parameters**

.. uparam:: hData_Layer

   *hData_Layer* is a vector with two elements.
   The first element is a handle of a 2D dataset and the second element is
   a handle of a layer (diagram) to which the new dataset should be
   added.

.. uparam:: rsWidth

   *rsWidth* specifies the width of the window in
   percent (``%``). Valid values must be in the range 0.1 ``%`` to 100 ``%``. With
   smaller windows the hull curve will follow closer to the data of the
   dataset *hData* (Default value is 5 ``%``).

.. uparam:: nType

   *nType* specifies the hull type (Default value is 1):

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

      * - Value
        - Meaning
      * - 1
        - upper hull
      * - 2
        - lower hull

.. us.comment

**Comment**

The data must have increasing x-coordinates.

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

:sub:`id-162184`