.. highlightlang:: us

.. _auto_xy_createregion:

auto_xy_CreateRegion
====================

.. index:: auto_xy_CreateRegion

.. us.tag  auto_xy_CreateRegion NOTREADYENGLISH auto_xy

:ref:`auto_xy_CreateRegion` creates a new
dataset by concatenating two datasets. The second dataset will be
added to the first dataset in reverse order.

.. function::  hDataNew = auto_xy_CreateRegion(hData, hData2)
    hDataNew = auto_xy_CreateRegion(hData_Layer, hData2)

.. us.return

**Return Value**

*hDataNew* is the handle of the new dataset.

.. us.params

**Parameters**

.. uparam:: hData

   *hData* is the handle of a 2D dataset. The new
   dataset *hDataNew* will be added to the layer (diagram) in which the
   dataset *hData* is located.

.. 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:: hData2

   *hData2* is the handle of the second dataset which
   will be concatenate to the first dataset in reverse order.

.. us.comment

**Comment**

Both datasets must have increasing x-coordinates. The new
dataset can only be filled with a hatch if the number of datapoints is
lower than 1025 points.

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

:sub:`id-1360028`