# `Nx.Tensor`
[🔗](https://github.com/elixir-nx/nx/blob/v0.12.0/nx/lib/nx/tensor.ex#L1)

The tensor struct and the behaviour for backends.

`Nx.Tensor` is a generic container for multidimensional data structures.
It contains the tensor type, shape, and names. The data itself is a
struct that points to a backend responsible for controlling the data.
The backend behaviour is described in `Nx.Backend`.

The tensor has the following fields:

  * `:data` - the tensor backend and its data
  * `:shape` - the tensor shape
  * `:type` - the tensor type
  * `:names` - the tensor names
  * `:vectorized_axes` - a tuple that encodes names and sizes for vectorization

In general it is discouraged to access those fields directly. Use
the functions in the `Nx` module instead. Backends have to access those
fields but it cannot update them, except for the `:data` field itself.

# `axes`

```elixir
@type axes() :: [axis()]
```

# `axis`

```elixir
@type axis() :: name() | integer()
```

# `data`

```elixir
@type data() :: Nx.Backend.t()
```

# `name`

```elixir
@type name() :: atom()
```

# `shape`

```elixir
@type shape() :: tuple()
```

# `t`

```elixir
@type t() :: %Nx.Tensor{
  data: data(),
  names: [name()],
  shape: shape(),
  type: type(),
  vectorized_axes: term()
}
```

# `t`

```elixir
@type t(data) :: %Nx.Tensor{
  data: data,
  names: [name()],
  shape: shape(),
  type: type(),
  vectorized_axes: term()
}
```

# `type`

```elixir
@type type() :: Nx.Type.t()
```

---

*Consult [api-reference.md](api-reference.md) for complete listing*