.. highlightlang:: us

.. index:: auto_xy_SortX

.. _auto_xy_sortx:

auto_xy_SortX
=============

.. us.tag  auto_xy_SortX NOTREADYENGLISH auto_xy

The function is obsolete. New scripts should use the :ref:`XYSetFilterFunctions` 
function.

:ref:`auto_xy_SortX` sorts the data of the given 2D dataset in ascending order.

.. function::  hDataNew = auto_xy_SortX(hData_Layer)

.. us.return

**Return Value**

*hDataNew* is the handle of the new dataset.

.. us.params

**Parameters**

.. uparam:: hData_Layer

   *hData_Layer* is a vector with one or two elements:

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

      * - Value
        - Meaning
      * - hData_Layer[1]
        - Handle of a dataset. The new dataset is added to the diagram to which the dataset hData_Layer[1] belongs.
      * - hData_Layer[1, 2]
        - The first element is the handle of a dataset and the second element is the handle of diagram (layer). The new dataset is added to the diagram with the handle hData_Layer[2].

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

:sub:`id-2023311`