tensor(deprecated)/contract - Maple Help
For the best experience, we recommend viewing online help using Google Chrome or Microsoft Edge.

Online Help

All Products    Maple    MapleSim


Home : Support : Online Help : tensor(deprecated)/contract

tensor

  

contract

  

contract a tensor over one or more pairs of indices

 

Calling Sequence

Parameters

Description

Examples

Calling Sequence

contract(A, [i1,i2], ...)

Parameters

A

-

tensor_type object of rank > 1

[i1, i2]

-

pair of indices of opposite index character to be contracted over given as a list. There must be at least one pair in the call, and the total number of pairs cannot exceed rank(A)/2.

Description

Important: The tensor package has been deprecated. Use the superseding command DifferentialGeometry[Tensor][ContractIndices].

• 

The function contract(A, [i1,i2], [i3,i4], ...) computes the contraction of the tensor A over the pairs of indices i1 and i2, i3 and i4, etc.

• 

There must not be any duplicates in the given indices (it is impossible to contract over a single index more than once) and the indices of each pair must be of opposite covariant-contravariant character.

• 

The return value is the resultant tensor_type object of rank equal to rank(A) - 2 * (# of pairs in the call).

• 

Simplification:  This routine uses the `tensor/prod/simp` routine for simplification purposes.  The simplification routine is applied to each component of the result after it is computed.  By default, `tensor/prod/simp` is initialized to the `tensor/simp` routine. It is recommended that the `tensor/prod/simp` routine be customized to suit the needs of the particular problem.

• 

This function is part of the tensor package, and so can be used in the form contract(..) only after performing the command with(tensor), or with(tensor,contract).  This function can always be accessed in the long form tensor[contract](..).

Examples

Important: The tensor package has been deprecated. Use the superseding command DifferentialGeometry[Tensor][ContractIndices].

withtensor:

Create a rank-2 tensor and contract it to form a scalar (the trace)

Tcreate1,1,arrayw,x,0,y,z,0,0,y2,xyw

Ttableindex_char=1,−1,compts=wx0yz00y2xyw

(1)

contractT,1,2

tableindex_char=,compts=xyw+w+z

(2)

See Also

DifferentialGeometry[Tensor][ContractIndices]

Physics

Physics[SumOverRepeatedIndices]

tensor(deprecated)

tensor(deprecated)/permute_indices

tensor(deprecated)[prod]

tensor(deprecated)[simp]