Physics/ToCovariant - 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 : 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

withPhysics:

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

Setupcoordinates=Cartesian,tensors=Aμ

Systems of spacetime coordinates are:X=x,y,z,t

_______________________________________________________

coordinatesystems=X,tensors=Aμ,γμ,σμ,μ,gμ,ν,εα,β,μ,ν,Xμ

(1)

CompactDisplayAX

Ax,y,z,twill now be displayed asA

(2)

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

Fμ,ν=d_μAνXd_νAμX

Fμ,ν=μAννAμ

(3)

Define

Defined objects with tensor properties

Aμ,γμ,Fμ,ν,σμ,μ,gμ,ν,εα,β,μ,ν,Xμ

(4)

The covariant components of Fμ,ν are

F

Fμ,ν=0A2xA1yA3xA1zA4xA.1A1yA2x0A3yA2zA4yA.2A1zA3xA2zA3y0A4zA.3A.1A4xA.2A4yA.3A4z0

(5)

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

F`~`

Fμ,νμ,ν=0A22x+A11yA33x+A11zA44xA.11A11y+A22x0A33y+A22zA44yA.22A11z+A33xA22z+A33y0A44zA.33A.11+A44xA.22+A44yA.33+A44z0

(6)

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

ToContravariant

gα,μgβ,νFα,βα,β=gα,μgβ,νααAββgα,νgβ,μααAββ

(7)

indets,OrspecindexF,specfuncA

Fα,βα,β,Aββ

(8)

Restrict that operation to only μ

ToContravariant,only=μ

* Partial match of 'only' against keyword 'onlytheseindices'

gα,μFαναν=gα,μααAνgα,μνAαα

(9)

indets,OrspecindexF,specfuncA

Fνανα,Aν,Aαα

(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

ToContravariant,only=μ,changecharacter

* Partial match of 'only' against keyword 'onlytheseindices'

* Partial match of 'changecharacter' against keyword 'changecharacteroffreeindices'

Fμνμν=μμAννAμμ

(11)

indets,OrspecindexF,specfuncA

Fνμνμ,Aν,Aμμ

(12)

An expression that has free and repeated indices:

DefineA,B,G

Defined objects with tensor properties

B,G,Aμ,γμ,Fμ,ν,σμ,μ,gμ,ν,εα,β,μ,ν,Xμ

(13)

AαBβFμ,νGν,α+AβBαFμ,ρGρ,α

AαBβFμ,νGν,α+AβBαFμ,ρGρ,α

(14)

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

Check,all

The repeated indices per term are: ...,...,..., the free indices are: ...

α,ν,α,ρ,β,μ

(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

ToContravariant

gα,κAκκgβ,λBλλgμ,σgν,τFσ,τσ,τgν,υgα,χGυ,χυ,χ+gβ,νAννgα,κBκκgλ,μgρ,σFλ,σλ,σgρ,τgα,υGτ,υτ,υ

(16)

indets,specindexA,B,F,G

Aκκ,Aνν,Bκκ,Bλλ,Fλ,σλ,σ,Fσ,τσ,τ,Gτ,υτ,υ,Gυ,χυ,χ

(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

Simplify

0

(18)

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

ToContravariant,changerepeatedindices=false

Aαgβ,κBκκgλ,μFλνλνGν,α+gβ,νAννBαgκ,μFκρκρGρ,α

(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.