Physlib.Relativity.Tensors.Constructors
36 declarations
-linear equivalence between and
#fromSinglePThe -linear equivalence between the object and the space of pure tensors for a single index .
-linear equivalence between and
#fromSingleTThe -linear equivalence between the object and the tensor space for a single index .
for pure tensors
#fromSingleT_symm_pureFor any index and any pure tensor of rank 1, the following identity holds: where is the inverse of the -linear equivalence between the vector space and the tensor space , and is the inverse of the -linear equivalence between the same vector space and the space of pure tensors .
For any index and any vector , the tensor constructed from via the -linear equivalence is equal to the rank-1 pure tensor associated with . Specifically, where is the pure tensor mapping the unique index to the vector .
Let be a tensor species over a group and an index set . For any index , let be the vector space and let be the representation of on . For any vector and any group element , the action of on the rank-1 tensor constructed from is equal to the tensor constructed from the transformed vector . Specifically, where is the linear equivalence that maps a vector to its corresponding rank-1 tensor.
commutes with index remapping via equality
#fromSingleT_mapFor any indices , let be an equality in the discrete category of indices. For any vector (where denotes the object ), the following equality holds: where is the linear map induced by the equality , and is the tensor permutation map corresponding to the identity permutation, which re-indexes the tensor from to .
Contraction of equals the pairing
#contrT_fromSingleT_fromSingleTLet be a tensor species over a ring and be the set of index colors. For any index , let denote the -module associated with (formally ) and let be the index color such that a contraction exists between and . Given vectors and , the contraction of the tensor product of the two rank-1 tensors constructed from and is equal to the scalar pairing of and (represented as a rank-0 tensor). Specifically, where: - maps a vector to its corresponding rank-1 tensor. - denotes the tensor product of tensors (`prodT`). - is the contraction operation `contrT` acting on the indices of the rank-2 tensor. - is the contraction pairing defined by the tensor species for color . - is the identity rank-0 tensor (`Pure.toTensor default`).
-linear map from to rank-2 tensors
#fromPairTGiven a tensor species over a ring and index colors , let and be the -modules (vector spaces) associated with these colors. The function `fromPairT` is a -linear map from the tensor product to the space of rank-2 tensors . It constructs a two-index tensor by taking the tensor product of the single-index tensors corresponding to the elements in and .
For a tensor species over a ring and index colors , let and be elements of the vector spaces associated with these colors. The rank-2 tensor constructed from their tensor product via the map `fromPairT` is equal to the tensor product `prodT` of the rank-1 tensors `fromSingleT x` and `fromSingleT y`, subject to an identity permutation of indices to reconcile the index type definitions.
Let be a tensor species over a group and a ring . For any index colors , let and be the -modules associated with these colors, and let denote the representation of on these modules. For any element and any group element , the action of on the rank-2 tensor constructed from satisfies: where is the -linear map that constructs a rank-2 tensor from the tensor product of two vector spaces, and is the induced action on the tensor product .
For a tensor species over a ring and index colors , let denote the -module (vector space) associated with color . Let be an equality and let be the -linear map induced by (the map ). For any element , the rank-2 tensor constructed from the mapped element satisfies: where is the -linear map that constructs a rank-2 tensor from a tensor product of vector spaces, and is the tensor permutation map corresponding to the identity permutation, which re-indexes the tensor to account for the color change from configuration to .
For a tensor species over a ring and index colors , let and be the -modules (vector spaces) associated with these colors. Given an element , let be the canonical commutativity isomorphism of the tensor product. The theorem states that applying the rank-2 tensor construction map `fromPairT` to the commuted element is equivalent to taking the tensor `fromPairT(x)` and permuting its indices by the swap . That is: where is the permutation swapping the two indices and is the condition ensuring the consistency of the index colors.
Contraction of and
#fromSingleTContrFromPairTGiven a vector in the space and a tensor in the tensor product , where denotes the dual index of , this function constructs a rank-1 tensor in by contracting with the first index of . Categorically, the process is defined by: 1. Forming the tensor product . 2. Applying the inverse associator to regroup the terms as . 3. Applying the contraction morphism to the first two components. 4. Using the left unitor to obtain a vector in . 5. Converting this resulting vector into a single-indexed tensor via the linear equivalence `fromSingleT`. For simple tensors , the operation satisfies: where denotes scalar multiplication by the result of the contraction.
For any indices , let and be the corresponding vector spaces and be the vector space associated with the dual index of . Given a vector , and vectors and forming the simple tensor , the contraction operation satisfies: where is the contraction morphism, is the linear equivalence mapping a vector to a rank-1 tensor, and denotes scalar multiplication.
Let be a tensor species over a ring and be the set of index colors. For any index colors , let be the -module associated with and be the -module associated with the dual color of . Given a vector and vectors , the contraction of the rank-3 tensor product of and is equal to the rank-1 tensor . Specifically, where: - and are the canonical maps from vectors/tensor products of vectors to rank-1 and rank-2 tensors, respectively. - (denoted by ) forms the rank-3 tensor with indices . - is the contraction operation `contrT` acting on the indices of color and (the indices at positions 0 and 1). - represents the vector contraction resulting in the rank-1 tensor . - is the identity permutation used for index type alignment.
Let be a tensor species over a ring and be the set of index colors. For any index colors , let be the -module associated with and be the -module associated with the dual color of . Given a vector and a tensor , the contraction of the rank-3 tensor formed by the product of the rank-1 tensor and the rank-2 tensor is equal to the rank-1 tensor . Specifically, where: - and are the canonical maps from vectors and tensor products of vectors to rank-1 and rank-2 tensors, respectively. - (denoted by ) forms the rank-3 tensor with indices . - is the contraction operation `contrT` acting on the indices at positions 0 and 1 (colors and ). - is the rank-1 tensor in resulting from the contraction of with the first index of . - is the identity permutation used for index type alignment.
Contraction of and into a rank-2 tensor
#fromPairTContrGiven a tensor species over a ring and index colors , let be the -modules associated with these colors. For elements and (where is the dual color of ), this function constructs a rank-2 tensor in . The construction is performed categorically: it takes the tensor product , reassociates the factors to isolate , applies the contraction morphism , and uses the left unitor to obtain an element in , which is finally mapped to a rank-2 tensor via `fromPairT`.
Let be a tensor species over a ring , and for any color , let be the -module associated with it. For any vectors , , , and (where is the dual color of ), the rank-2 tensor obtained by the contraction operation `fromPairTContr` on the elementary tensors and satisfies: where is the contraction morphism for the color , and maps an element of to a rank-2 tensor.
Let be a tensor species over a ring . For index colors , let , and be the -modules associated with these colors, where is the dual color of . For any vectors , and , the contraction of the tensor product of the rank-2 tensors constructed from the elementary tensors and at the middle indices is equal to the rank-2 tensor obtained via the direct contraction map `fromPairTContr`. Specifically, where: - is the linear map from to the space of rank-2 tensors. - between tensors denotes the tensor product operation `prodT`. - (formally `contrT 2 1 2`) denotes the contraction of the second index of the first tensor with the first index of the second tensor (indices 1 and 2 of the resulting rank-4 product). - The equality holds up to a canonical re-indexing of the indices (identity permutation).
Let be a tensor species over a ring . For any index colors , let , and be the -modules associated with these colors, where denotes the dual color of . For any elements and , the contraction of the tensor product of the rank-2 tensors constructed from and is equal to the rank-2 tensor obtained via the direct contraction map `fromPairTContr`. Specifically, where: - is the -linear map from to the space of rank-2 tensors. - between tensors denotes the tensor product operation `prodT`. - (formally `contrT 2 1 2`) denotes the contraction of the second index of the first tensor with the first index of the second tensor (corresponding to the matching colors and ). - The equality holds up to a canonical re-indexing (permutation) of the resulting indices.
Basis Representation of equals Basis Representation of in
#fromPairT_basis_reprLet be a tensor species over a ring , and let be index colors with corresponding -modules and . For any element and any multi-index for rank-2 tensors of colors , the coefficient of the rank-2 tensor at index with respect to the tensor basis is equal to the coefficient of at the index pair with respect to the induced tensor product basis of . That is,
Let be a tensor species over a ring . For any index colors and basis indices and , let and be the basis vectors of the -modules and respectively. Then, the value of the -linear map on the tensor product of these basis vectors is the basis element of the rank-2 tensor space corresponding to the multi-index : where denotes the basis element of the tensor space for the color pair at indices .
Rank-2 tensor from
#fromConstPairLet be a tensor species over a ring and a group . For any two colors , let and be the -modules (representations) associated with these colors. The function `fromConstPair` constructs a rank-2 tensor in from a morphism , where is the monoidal unit (the trivial representation) in the category . The resulting tensor is obtained by evaluating the linear map at the identity and applying the transformation `fromPairT` to the resulting element of the tensor product . This construction defines "constant" or invariant rank-2 tensors, such as a metric or a unit tensor.
Let be a tensor species over a ring and a group . For any index colors , let and be the -modules (representations) associated with these colors. Let denote the monoidal unit (the trivial representation) in the category . For any morphism of representations and any group element , the rank-2 tensor constructed via `fromConstPair` is invariant under the group action:
Let be a tensor species over a ring and a group . For any colors , let be the -modules (representations) associated with these colors. Let be an equality and be the -linear map induced by . Given a morphism from the monoidal unit in the category of representations , applying the rank-2 tensor construction `fromConstPair` to the composition of with the map is equivalent to re-indexing the tensor constructed from using the identity permutation: where is the tensor permutation map corresponding to the identity permutation, which accounts for the change in index colors from configuration to .
Let be a tensor species over a ring and a group . For any two colors , let and be the -modules (representations) associated with these colors. Given a morphism from the monoidal unit in the category of representations , let be the braiding (canonical commutativity isomorphism) in the category. The theorem states that applying the rank-2 tensor construction `fromConstPair` to the braided morphism is equivalent to taking the tensor constructed from and swapping its indices: where is the permutation swapping the two indices and is the proof of consistency for the index colors.
-linear map from to rank-3 tensors
#fromTripleTFor a tensor species over a ring and index colors , `fromTripleT` is the -linear map: where is the underlying -module associated with the color , and is the space of tensors with three indices of colors . This map constructs a rank-3 tensor by mapping the triple tensor product of the component modules into the formal tensor space of the species.
`fromTripleT` of a pure tensor equals the product of `fromSingleT` tensors
#fromTripleT_tmulLet be a tensor species over a ring . For any index colors and elements , , and (where is the module associated with color ), the rank-3 tensor constructed via from the element is equal to the product of the rank-1 tensors , , and (as calculated by ), up to an identity permutation of the indices.
Let be a tensor species over a ring and a group . For any index colors , let be the -module associated with the color and be the representation of on . For any element and any group element , the action of on the rank-3 tensor constructed from via the linear map is given by: where denotes the group action on the tensor space and denotes the induced map on the tensor product of modules.
Basis representation of equals basis representation of
#fromTripleT_basis_reprLet be a tensor species over a ring and be index colors. Let denote the -modules associated with these colors. For any element and any multi-index for a rank-3 tensor with colors , the component (coefficient) of the tensor in the tensor basis at index is equal to the component of in the product basis of at indices .
maps the product of basis elements to the rank-3 basis tensor
#fromTripleT_apply_basisLet be a tensor species over a ring and let be index colors. For any basis indices of the respective representation spaces, the -linear map maps the triple tensor product of basis elements to the basis tensor of the species with colors at the multi-index .
Constant rank-3 tensor constructed from an invariant morphism
#fromConstTripleLet be a tensor species over a ring and a group . For any three index colors , let denote the representation space associated with the color . Given a morphism in the category of representations , where is the trivial representation, `fromConstTriple` constructs a rank-3 tensor in . This tensor is obtained by evaluating the underlying linear map of at to produce an invariant element in the triple tensor product , which is then converted into a tensor of the species. This is used to represent physical constants that are invariant under the group action, such as the Pauli matrices.
Let be a tensor species over a ring and a group . For any three index colors , let denote the representation space associated with the color . Given a morphism from the trivial representation in the category of representations , the rank-3 tensor constructed from , denoted , is invariant under the group action. That is, for any :
General Constant Tensor Node
#fromConstA general constant node. Given a morphism \( T \) from the trivial representation to the representation associated with a color configuration \( c \) of length \( n \), this defines a tensor of species \( S \) with colors \( c \).
Let be a natural number and be a color configuration. Let be a morphism from the trivial representation in the category of representations to the representation defined by the tensor species and the color configuration . Then the tensor constructed from this morphism, denoted , is equal to the image of the unit scalar under the morphism , i.e., .
Invariance of constant tensors under group action:
#actionT_fromConstLet be a group and be a field. Let be a morphism from the trivial representation to the representation associated with a tensor species and a color configuration of length . For any group element , the tensor constructed from , denoted as , is invariant under the group action, satisfying .
