Physics/ToCovariant - Maple Help
For the best experience, we recommend viewing online help using Google Chrome or Microsoft Edge.

Online Help

Home : Support : Online Help : Physics/ToCovariant

Physics[ToCovariant] - rewrite in covariant form the indices of the tensors of a given expression

Physics[ToContravariant] - rewrite in covariant form the indices of the tensors of a given expression

Calling Sequence

ToCovariant(tensorial_expression, optional ...)

ToContravariant(tensorial_expression, optional ...)

Parameters

tensorial_expression

-

any tensorial expression, or a set, list, equation or matrix of them, onto which the operation is performed

Description

• 

When working with tensors in spaces where the covariant and contravariant tensors' components have a different value (the underlying metric is not Euclidean) one frequently wants to express formulations with some or all of the tensors's indices expressed either in covariant or contravariant form. In previous Maple releases, also in Maple 2021, you can raise or lower free indices multiplying by the metric and performing the contraction. That, however, involves a whole simplification process not always desired, and does not result in flipping the character of repeated indices. The SubstituteTensorIndices is also useful for that purpose but requires changing the indices one by one. Instead, to handle the whole manipulation operation, you can use ToCovariant and ToContravariant.

• 

Several options are available to adjust the operation in different ways, as explained in the Options section above. Perhaps two more relevant ones are changecharacteroffreeindices (default value is false), that can be used to receive an expression where you get all free indices flipping their character, and onlytheseindices = ... to restrict the operation to only some of the indices.

• 

Note that closely related to ToCovariant and ToContravariant, the Physics package includes a SubstituteTensorIndices command.

Examples

Set coordinates and a tensor for experimentation; avoid redundant display of functionality using CompactDisplay

(1)

(2)

Consider the following tensorial expression, define it as the components of a new tensor

(3)

(4)

The covariant components of  are

(5)

Related to the character of indices, note first that, since Maple 2021, when you request the contravariant components of a tensor definition as , the output is already expressed using the contravariant components of the tensors involved, in this case

(6)

The definition of  involves only free and covariant indices; make all the tensors be expressed using covariant indices without changing the mathematical value of the expression

(7)

(8)

Restrict that operation to only

(9)

(10)

In the above we see the tensors originally having  covariant, now with the index in that position contravariant. To achieve the other possible meaning of to contravariant use the option changecharacteroffreeindices

(11)

(12)

An expression that has free and repeated indices:

(13)

(14)

There are several tensors with covariant indices, and the free and repeated indices can be determined using Check

(15)

We see the free indices are  and , both covariant. To have all the tensors of this expression (but for the metric) with all their indices contravariant, use

(16)

(17)

This result is mathematically equal to the starting expression - all that happened is that the covariant versions of the indices were replaced by the contravariant ones at the cost of adding metric factors, so

(18)

In addition to the onlytheseindices option, to perform these operations only on the free indices, you can also use changerepeatedindices = false

(19)

See Also

`.`, CompactDisplay, Coordinates, g_, Physics, Physics conventions, Physics examples, Physics Updates, Tensors - a complete guide, Mini-Course Computer Algebra for Physicists, Setup, SubstituteTensor, SubstituteTensorIndices, TensorArray

References

  

Landau, L.D., and Lifshitz, E.M. The Classical Theory of Fields, Course of Theoretical Physics Volume 2, fourth revised English edition. Elsevier, 1975.


Download Help Document