convert routines of the DifferentialGeometry package
|
Calling Sequence
|
|
convert(A, DGArray)
convert(B, DGvector)
convert(C, DGform)
convert(C, DGspinor)
convert(E, DGtensor)
convert(F, DGjet)
convert(F, DGdiff)
convert(G, DGbiform, bidegree)
|
|
Parameters
|
|
A
|
-
|
a tensor
|
B
|
-
|
a Matrix, a tensor, or the infinitesimal symmetry generators for a system of differential equations, as calculated by PDEtools:-Infinitesimals
|
C
|
-
|
a differential form or a differential biform
|
E
|
-
|
an Arrary, a vector, a differential form, or a spinor-tensor
|
F
|
-
|
a Maple expression
|
G
|
-
|
a differential form
|
|
|
|
|
Description
|
|
•
|
convert(A, DGArray) will convert a rank r tensor A to an r-dimensional array. For example, if A= a * dx1 &t dx2 &t dx3 and T = convert(A, DGArray), then T[1, 2, 3] = a and all other entries of T are 0.
|
•
|
If B is a a rank 1 contravariant tensor, then convert(B, DGvector) will return the corresponding vector field.
|
•
|
If C is a rank 1 covariant tensor, then convert(B, DGform) will return a differential 1-form.
|
•
|
If C is a differential biform, that is, a form expressed in terms of the contact forms on a jet space, then convert(C, DGform) will return the differential form on jet space obtained by replacing the contact forms by their coordinate formulas.
|
•
|
If E is a vector field, then convert(E, DGtensor) will convert E to a rank 1 contravariant tensor.
|
•
|
If E is a differential p-form, then convert(E, DGtensor) will convert E to a rank p contravariant tensor.
|
•
|
convert(F, DGjet) will convert a Maple expression F involving the Maple command diff, applied to functions u(x, y, z, ...), v(x, y, z, ...), ... to the standard indexed notation for derivatives, for example, diff(u(x, y, z), x) -> u[1], diff(u(x, y, z), x, y, z, z) -> u[1, 2, 3, 3] etc.
|
•
|
convert(F, DGdiff) performs the inverse to the conversion command convert/DGjet, it will convert expressions F involving the indexed notation for derivatives to expressions containing the Maple diff command.
|
•
|
convert(G, DGbiform) will convert a differential p-form G, defined on a jet space J^k(M, N) , into a list of (p + 1)-biforms, Theta = [theta_0, theta_1, theta_2, .. theta_p], where theta_k has contact degree k, and G = theta_0 + theta_1 + theta_2 + ... + theta_p.
|
|
|
Examples
|
|
|
convert/DGArray
|
|
>
|
|
Example 1.
We define a manifold M with coordinates [x, y, z]. On M we define two tensors T1 and T2. We convert these tensors to a Maple Array
>
|
|
>
|
|
| (1) |
>
|
|
| (2) |
>
|
|
| (3) |
>
|
|
| (4) |
>
|
|
| (5) |
|
|
convert/DGvector
|
|
>
|
|
Example 1.
We define a manifold M with coordinates [x, y, z]. We convert a matrix to a linear vector field.
>
|
|
>
|
|
| (6) |
>
|
|
| (7) |
Example 2.
We define a manifold M with coordinates [x, y, z]. On M we define two tensors T1 and T2 and contract the 1st and 3 indices of T1 against the 1st and second indices of T2. The result is a contravariant rank 1 tensor S on M. We then convert S to a vector field X.
>
|
|
>
|
|
| (8) |
>
|
|
| (9) |
>
|
|
| (10) |
>
|
|
| (11) |
>
|
|
| (12) |
>
|
|
_DG([["tensor", M, [["con_bas"], []]], [[[1], 2], [[3], 1]]])
_DG([["vector", M, []], [[[1], 2], [[3], 1]]])
| |
Example 3.
We use the PDEtools:-Infinitesimals program to find the infinitesimals symmetries of a system of differential equations. We convert the output of this program, which lists of the components of the infinitesimal symmetries, to a list of vector fields on the manifold of independent and dependent variables.
>
|
|
| (13) |
>
|
|
| (14) |
>
|
|
| (15) |
>
|
|
| (16) |
|
|
convert/DGform
|
|
>
|
|
Example 1.
We define a manifold M with coordinates [x, y, z]. On M we define a tensor T and contract the 1st and 3rd indices of T. The result is a covariant rank 1 tensor S on M. We then convert S to a differential 1-form alpha.
>
|
|
>
|
|
| (17) |
>
|
|
| (18) |
>
|
|
| (19) |
The tensor S and the 1 form alpha both have the same external displays but are have different internal representations. We can see this using DGinfo or lprint.
>
|
|
| (20) |
>
|
|
_DG([["tensor", M, [["cov_bas"], []]], [[[1], 1], [[2], 2]]])
_DG([["form", M, 1], [[[1], 1], [[2], 2]]])
| |
Example 2.
>
|
|
>
|
|
| (21) |
>
|
|
| (22) |
>
|
|
| (23) |
>
|
|
| (24) |
|
|
convert/DGspinor
|
|
The solder form sigma is the fundamental spin-tensor in spinor algebra. It provides for a 1-1 correspondence between vectors and rank 2 Hermitian spinors. The convert/DGspinor uses a uer specified solder form to convert tensor indices of a given spinor-tensor to pairs of spinor indices.
>
|
|
To illustrate this convert procedure we first construct a solder form. Define a vector bundle over M with base coordinates [x, y, z, t] and fiber coordinates [z1, z2, w1, w2].
>
|
|
| (25) |
Define a spacetime metric g on M. Our spinor conventions assume the metric has signature [1, -1, -1, -1].
>
|
|
| (26) |
Define an orthonormal frame on M with respect to the metric g.
>
|
|
| (27) |
Calculate the solder form sigma from the frame F. See Spinor, SolderForm.
>
|
|
| (28) |
Example 1.
Define a vector X and convert it to a contravariant rank 2 spinor psi. The convert/DGspinor command requires the solder form as a 3rd argument and a list of tensorial indices to be converted to spinorial indices as a 4th argument.
>
|
|
| (29) |
>
|
|
| (30) |
Example 2.
Define a rank 3 tensor and convert the 1st and 3rd indices to pairs of spinor indices to obtain a rank 5 spin-tensor chi. Note that the spinorial indices are moved to the right.
>
|
|
| (31) |
>
|
|
| (32) |
Example 3.
With the convert/DGspinor command, the spinor psi. can be converted back to the vector X and the spin-tensor chi back to the tensor T.
>
|
|
| (33) |
>
|
|
| (34) |
|
|
convert/DGtensor
|
|
>
|
|
We define a manifold M with coordinates [x, y, z].
>
|
|
Example 1.
We define a Matrix' A1 and convert it to a rank 2 tensor in 4 different ways:
>
|
|
| (35) |
>
|
|
| (36) |
>
|
|
| (37) |
>
|
|
| (38) |
>
|
|
| (39) |
Example 2.
We define an 4 dimensional array and convert it to a rank 4 covariant tensor.
>
|
|
>
|
|
| (40) |
>
|
|
| (41) |
>
|
|
| (42) |
Example 3.
We define a vector field and convert it to a rank 1 contravariant tensor field.
>
|
|
| (43) |
>
|
|
| (44) |
The tensor T and vector X both have the same external displays but have different internal representations. We can see this using DGinfo or lprint.
>
|
|
| (45) |
>
|
|
_DG([["vector", M, []], [[[2], x^2], [[3], -y^2]]])
_DG([["tensor", M, [["con_bas"], []]], [[[2], x^2], [[3], -y^2]]])
| |
Example 4.
We define a differential 2-form and convert it to a rank 2 covariant tensor field.
>
|
|
| (46) |
>
|
|
| (47) |
Example 5.
A spinor or spinor-tensor can be converted to a tensor using a solder form sigma. To work with spinors, define a vector bundle over M with base coordinates [x, y, z, t] and fiber coordinates [z1, z2, w1, w2].
>
|
|
| (48) |
Define a spacetime metric g on M. Our spinor convention require that the metric has signature [1, -1,-1,-1].
>
|
|
| (49) |
Define an orthonormal frame on M with respect to the metric g.
>
|
|
| (50) |
Calculate the solder form sigma from the frame F. See Spinor, SolderForm.
>
|
|
| (51) |
Define a contravariant rank 2 spinor psi and convert it to a rank 1 contravariant tensor X. In this situation, convert/DGtensor command requires the solder form as a 3rd argument and a list of pairs of spinorial indices to be converted to tensorial indices as a 4th argument.
>
|
|
| (52) |
>
|
|
| (53) |
Example 6.
Define a covariant rank 2 spinor psi and convert it to a rank 1 covariant tensor omega.
>
|
|
| (54) |
>
|
|
| (55) |
Example 7.
Define a covariant rank 4 spinor psi and convert it to a rank 2 covariant tensor G .
>
|
|
| (56) |
>
|
|
| (57) |
Example 8.
Define a mixed contravariant rank 5 spin-tensor psi and convert it to a rank 3 contravariant tensor in 2 different ways. (The tensors T1 and T2 are complex because psi is not Hermitian.)
>
|
|
| (58) |
>
|
|
| (59) |
>
|
|
| (60) |
|
|
convert/DGjet, convert/DGdiff
|
|
>
|
|
Example 1.
We define the 2nd order jet space J^2(R^2, R) for one function u of two independent variables [x, y].
>
|
|
We convert the Laplace of a function, defined using the Maple diff command into a standard index notation for coordinates on jet spaces.
>
|
|
| (61) |
>
|
|
| (62) |
Example 2.
•
|
We retrieve a 4th order ODE from Kamke and rewrite it in standard index notation for coordinates on jet spaces.
|
>
|
|
| (63) |
>
|
|
| (64) |
>
|
|
| (65) |
Example 3.
Define a 2-form on J^2(R^2, R).We convert the KdV equation, given in jet notation, to ordinary derivative notation.
>
|
|
>
|
|
| (66) |
>
|
|
| (67) |
|
|
convert/DGbiform
|
|
>
|
|
Define a 2-form on J^2(R^2, R).We define the 2nd order jet space J^2(R^2, R) for one function u of two independent variables [x, y].
>
|
|
Define a 2-form on J^2(R^2, R).
>
|
|
| (68) |
Define a 2-form on J^2(R^2, R). To obtain the representation of omega in terms of the contact forms Cu[1] = du[1] - u[1, 1]*dx - u[1, 2]*dy and Cu[2] = du[2] - u[1, 2]*dx - u[2, 2]*dy (*) we solve the equations (*) for du[1] and du[2], substitute for du[1] and du[2] into omega, and then grade the terms according to their contact degree -- [2, 0] : not contact forms; [1,1] : linear in contact forms; [0, 2] : quadratic in contact forms.
>
|
|
| (69) |
>
|
|
| (70) |
>
|
|
| (71) |
>
|
|
| (72) |
Jet >
|
|
|
|
|