:nosearch:

.. _op_ai_onnx_Range-11:

Range - version 11
==================

This page documents version **11** of operator **Range**. See :doc:`Range` for the latest version (since version 27).

- **Domain**: ``ai.onnx``
- **Since version**: 11

Generate a tensor containing a sequence of numbers that begin at ``start`` and extends by increments of ``delta``
up to ``limit`` (exclusive).

The number of elements in the output of range is computed as below:

.. code-block::

    number_of_elements = max( ceil( (limit - start) / delta ) , 0 )


The pseudocode determining the contents of the output is shown below:

.. code-block::

    for(int i=0; i<number_of_elements; ++i) {
      output[i] =  start + (i * delta);
    }


Example 1

.. code-block::

    Inputs: start = 3, limit = 9, delta = 3
    Output: [3, 6]


Example 2

.. code-block::

    Inputs: start = 10, limit = 4, delta = -2
    Output: [10, 8, 6]


**Inputs**

- **start** (*T*): Scalar. First entry for the range of output values.
- **limit** (*T*): Scalar. Exclusive upper limit for the range of output values.
- **delta** (*T*): Scalar. Value to step by.

**Outputs**

- **output** (*T*): A 1-D tensor with same type as the inputs containing generated range of values.

**Type Constraints**

- **T**: Constrain input types to common numeric type tensors.
  Allowed types: tensor(double), tensor(float), tensor(int16), tensor(int32), tensor(int64).

Examples
--------

**test_range_float_type_positive_delta**

.. code-block:: text

    Node:
      Range(start, limit, delta) -> (output)

.. code-block:: text

    Inputs:
      start: shape=(), dtype=float32
        1.
      limit: shape=(), dtype=float32
        5.
      delta: shape=(), dtype=float32
        2.

    Outputs:
      output: shape=(2,), dtype=float32
        [1., 3.]

**test_range_int32_type_negative_delta**

.. code-block:: text

    Node:
      Range(start, limit, delta) -> (output)

.. code-block:: text

    Inputs:
      start: shape=(), dtype=int32
        10
      limit: shape=(), dtype=int32
        6
      delta: shape=(), dtype=int32
        -3

    Outputs:
      output: shape=(2,), dtype=int32
        [10,  7]