Tensors are mathematical objects that give generalizations of vectors and matrices. In the Wolfram System, a tensor is represented as a set of lists, nested to a certain number of levels. The nesting level is the rank of the tensor.

Interpretations of nested lists.

A tensor of rank k is essentially a k‐dimensional table of values. To be a true rank k tensor, it must be possible to arrange the elements in the table in a k‐dimensional cuboidal array. There can be no holes or protrusions in the cuboid.

The indices that specify a particular element in the tensor correspond to the coordinates in the cuboid. The dimensions of the tensor correspond to the side lengths of the cuboid.

One simple way that a rank k tensor can arise is in giving a table of values for a function of k variables. In physics, the tensors that occur typically have indices which run over the possible directions in space or spacetime. Notice, however, that there is no built‐in notion of covariant and contravariant tensor indices in the Wolfram System: you have to set these up explicitly using metric tensors.

Functions for creating and testing the structure of tensors.

In[1]:=

Out[1]=

In[2]:=

Out[2]=

In[3]:=

Out[3]//MatrixForm=

In[4]:=

Out[4]=

Here is the element of the tensor.

In[5]:=

Out[5]=

In[6]:=

Out[6]=

The rank of a tensor is equal to the number of indices needed to specify each element. You can pick out subtensors by using a smaller number of indices.

Tensor manipulation operations.

You can think of a rank k tensor as having k "slots" into which you insert indices. Applying Transpose is effectively a way of reordering these slots. If you think of the elements of a tensor as forming a k‐dimensional cuboid, you can view Transpose as effectively rotating (and possibly reflecting) the cuboid.

In the most general case, Transpose allows you to specify an arbitrary reordering to apply to the indices of a tensor. The function Transpose[T,{p₁,p₂,…,p_k}] gives you a new tensor T^′ such that the value of T^′_{i1 i2 … ik} is given by T_{ip1 ip2 … ipk}.

If you originally had an n_p1×n_p2×…×n_pk tensor, then by applying Transpose, you will get an n₁×n₂×…×n_k tensor.

In[7]:=

Out[7]=

In[8]:=

Out[8]=

In[9]:=

Out[9]=

In[10]:=

Out[10]=

In[11]:=

Out[11]=

In[12]:=

Out[12]=

If you have a tensor that contains lists of the same length at different levels, then you can use Transpose to effectively collapse different levels.

In[13]:=

Out[13]=

In[14]:=

Out[14]=

You can also use Tr to extract diagonal elements of a tensor.

In[15]:=

Out[15]=

In[16]:=

Out[16]=

In[17]:=

Out[17]=

Outer products, and their generalizations, are a way of building higher‐rank tensors from lower‐rank ones. Outer products are also sometimes known as direct, tensor, or Kronecker products.

From a structural point of view, the tensor you get from Outer[f,t,u] has a copy of the structure of u inserted at the "position" of each element in t. The elements in the resulting structure are obtained by combining elements of t and u using the function f.

In[18]:=

Out[18]=

In[19]:=

Out[19]=

In[20]:=

Out[20]=

In[21]:=

Out[21]=

If you take the generalized outer product of an m₁×m₂×…×m_r tensor and an n₁×n₂×…×n_s tensor, you get an m₁×…×m_r×n₁×…×n_s tensor. If the original tensors have ranks r and s, your result will be a rank r+s tensor.

In terms of indices, the result of applying Outer to two tensors T_{i1 i2 … ir} and U_{j1 j2 … js} is the tensor V_{i1 i2 … irj1 j2 … js} with elements f[T_{i1 i2 … ir},U_{j1 j2 … js}].

In doing standard tensor calculations, the most common function f to use in Outer is Times, corresponding to the standard outer product.

Particularly in doing combinatorial calculations, however, it is often convenient to take f to be List. Using Outer, you can then get combinations of all possible elements in one tensor, with all possible elements in the other.

In constructing Outer[f,t,u] you effectively insert a copy of u at every point in t. To form Inner[f,t,u], you effectively combine and collapse the last dimension of t and the first dimension of u. The idea is to take an m₁×m₂×…×m_r tensor and an n₁×n₂×…×n_s tensor, with m_r=n₁, and get an m₁×m₂×…×m_r-1×n₂×…×n_s tensor as the result.

The simplest examples are with vectors. If you apply Inner to two vectors of equal length, you get a scalar. Inner[f,v₁,v₂,g] gives a generalization of the usual scalar product, with f playing the role of multiplication, and g playing the role of addition.

In[22]:=

Out[22]=

In[23]:=

Out[23]=

In[24]:=

Out[24]=

In[25]:=

Out[25]=

In[26]:=

Out[26]=

In[27]:=

Out[27]=

You can think of Inner as performing a "contraction" of the last index of one tensor with the first index of another. If you want to perform contractions across other pairs of indices, you can do so by first transposing the appropriate indices into the first or last position, then applying Inner, and then transposing the result back.

In many applications of tensors, you need to insert signs to implement antisymmetry. The function Signature[{i₁,i₂,…}], which gives the signature of a permutation, is often useful for this purpose.

Treating only certain sublists in tensors as separate elements.

In[28]:=

Out[28]=

In[29]:=

Out[29]=

Flattening block tensors.

In[30]:=

Out[30]//TableForm=

In[31]:=

Out[31]//TableForm=