ak.argsort
----------

Defined in `awkward.operations.structure <https://github.com/scikit-hep/awkward-1.0/blob/80bbef0738a6b7928333d7c705ee1b359991de5b/src/awkward/operations/structure.py>`__ on `line 2622 <https://github.com/scikit-hep/awkward-1.0/blob/80bbef0738a6b7928333d7c705ee1b359991de5b/src/awkward/operations/structure.py#L2622>`__.

.. py:function:: ak.argsort(array, axis=-1, ascending=True, stable=True, highlevel=True, behavior=None)


    :param array: Data for which to get a sorting index, possibly within nested
              lists.
    :param axis: The dimension at which this operation is applied. The
             outermost dimension is ``0``, followed by ``1``, etc., and negative
             values count backward from the innermost: ``-1`` is the innermost
             dimension, ``-2`` is the next level up, etc.
    :type axis: int
    :param ascending: If True, the first value in each sorted group
                  will be smallest, the last value largest; if False, the order
                  is from largest to smallest.
    :type ascending: bool
    :param stable: If True, use a stable sorting algorithm (introsort:
               a hybrid of quicksort, heapsort, and insertion sort); if False,
               use a sorting algorithm that is not guaranteed to be stable
               (heapsort).
    :type stable: bool
    :param highlevel: If True, return an :py:obj:`ak.Array`; otherwise, return
                  a low-level :py:obj:`ak.layout.Content` subclass.
    :type highlevel: bool
    :param behavior: Custom :py:obj:`ak.behavior` for the output array, if
                 high-level.
    :type behavior: None or dict

For example,

.. code-block:: python


    >>> ak.argsort(ak.Array([[7.7, 5.5, 7.7], [], [2.2], [8.8, 2.2]]))
    <Array [[1, 0, 2], [], [0], [1, 0]] type='4 * var * int64'>

The result of this function can be used to index other arrays with the
same shape:

.. code-block:: python


    >>> data = ak.Array([[7, 5, 7], [], [2], [8, 2]])
    >>> index = ak.argsort(index)
    >>> index
    <Array [[1, 0, 2], [], [0], [1, 0]] type='4 * var * int64'>
    >>> data[index]
    <Array [[5, 7, 7], [], [2], [2, 8]] type='4 * var * int64'>

