tensor(deprecated)/contract - Help

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

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)

T:=create1,1,arrayw,x,0,y,z,0,0,y2,xyw

T:=tableindex_char=1,1,compts=wx0yz00y2xyw

(1)

contractT,1,2

tableindex_char=,compts=wxy+w+z

(2)

See Also

DifferentialGeometry[Tensor][ContractIndices], Physics, Physics[SumOverRepeatedIndices], tensor(deprecated), tensor(deprecated)/permute_indices, tensor(deprecated)[prod], tensor(deprecated)[simp]


Download Help Document

Was this information helpful?



Please add your Comment (Optional)
E-mail Address (Optional)
What is ? This question helps us to combat spam