Physlib

Physlib.Relativity.Tensors.Constructors

Constructors of tensors.

There are a number of ways to construct explicit tensors.

Tensors with a single index.

Tensors with two indices.

fromPairT

Contraction of fromPairT with fromSingleT

Contraction of fromPairT with fromPairT

fromConstPair

fromTripleT

fromConstTriple

Tensors with more indices

Actions on tensors constructed from morphisms

Tensors constructed from morphisms are invariant under the group action.

36 declarations

definition

kk-linear equivalence between S.FD.obj{as:=c}S.FD.obj \{as := c\} and Pure S![c]\text{Pure } S ![c]

The kk-linear equivalence between the object S.FD.obj{as:=c}S.FD.obj \{as := c\} and the space of pure tensors Pure S![c]\text{Pure } S ![c] for a single index cCc \in C.

definition

kk-linear equivalence between S.FD.obj{as:=c}S.FD.obj \{as := c\} and S.Tensor![c]S.Tensor ![c]

The kk-linear equivalence between the object S.FD.obj{as:=c}S.FD.obj \{as := c\} and the tensor space S.Tensor![c]S.Tensor ![c] for a single index cCc \in C.

theorem

fromSingleT1(p.toTensor)=fromSingleP1(p)\text{fromSingleT}^{-1}(p.\text{toTensor}) = \text{fromSingleP}^{-1}(p) for pure tensors pp

For any index cCc \in C and any pure tensor pPure S![c]p \in \text{Pure } S ![c] of rank 1, the following identity holds: fromSingleT1(p.toTensor)=fromSingleP1(p)\text{fromSingleT}^{-1}(p.\text{toTensor}) = \text{fromSingleP}^{-1}(p) where fromSingleT1\text{fromSingleT}^{-1} is the inverse of the kk-linear equivalence between the vector space S.FD.obj{as:=c}S.FD.obj \{ as := c \} and the tensor space S.Tensor![c]S.Tensor ![c], and fromSingleP1\text{fromSingleP}^{-1} is the inverse of the kk-linear equivalence between the same vector space and the space of pure tensors Pure S![c]\text{Pure } S ![c].

theorem

fromSingleT(x)=Pure.toTensor(ιx)\text{fromSingleT}(x) = \text{Pure.toTensor}(\iota_x)

For any index cCc \in C and any vector xS.FD.obj{as:=c}x \in S.FD.obj \{ as := c \}, the tensor constructed from xx via the kk-linear equivalence fromSingleT\text{fromSingleT} is equal to the rank-1 pure tensor associated with xx. Specifically, fromSingleT(x)=Pure.toTensor(ιx)\text{fromSingleT}(x) = \text{Pure.toTensor}(\iota_x) where ιxPure S![c]\iota_x \in \text{Pure } S ![c] is the pure tensor mapping the unique index 00 to the vector xx.

theorem

gfromSingleT(x)=fromSingleT(ρ(g)x)g \cdot \text{fromSingleT}(x) = \text{fromSingleT}(\rho(g)x)

Let SS be a tensor species over a group GG and an index set CC. For any index cCc \in C, let VcV_c be the vector space S.FD.obj{as:=c}S.FD.obj \{ as := c \} and let ρ\rho be the representation of GG on VcV_c. For any vector xVcx \in V_c and any group element gGg \in G, the action of gg on the rank-1 tensor constructed from xx is equal to the tensor constructed from the transformed vector ρ(g)x\rho(g)x. Specifically, gfromSingleT(x)=fromSingleT(ρ(g)x)g \cdot \text{fromSingleT}(x) = \text{fromSingleT}(\rho(g)x) where fromSingleT\text{fromSingleT} is the linear equivalence that maps a vector to its corresponding rank-1 tensor.

theorem

fromSingleT\text{fromSingleT} commutes with index remapping via equality

For any indices c,c1Cc, c_1 \in C, let h:{c}={c1}h: \{c\} = \{c_1\} be an equality in the discrete category of indices. For any vector xVcx \in V_c (where VcV_c denotes the object S.FD.obj{as:=c}S.FD.obj \{as := c\}), the following equality holds: fromSingleT(S.FD.map(h)(x))=permTid(fromSingleT(x))\text{fromSingleT}(S.FD.map(h)(x)) = \text{permT}_{\text{id}}(\text{fromSingleT}(x)) where S.FD.map(h):VcVc1S.FD.map(h): V_c \to V_{c_1} is the linear map induced by the equality hh, and permTid\text{permT}_{\text{id}} is the tensor permutation map corresponding to the identity permutation, which re-indexes the tensor from cc to c1c_1.

theorem

Contraction of fromSingleT(x)fromSingleT(y)\text{fromSingleT}(x) \otimes \text{fromSingleT}(y) equals the pairing x,y\langle x, y \rangle

Let SS be a tensor species over a ring kk and CC be the set of index colors. For any index cCc \in C, let VcV_c denote the kk-module associated with cc (formally S.FD.obj{as:=c}S.FD.obj \{as := c\}) and let τ(c)\tau(c) be the index color such that a contraction exists between VcV_c and Vτ(c)V_{\tau(c)}. Given vectors xVcx \in V_c and yVτ(c)y \in V_{\tau(c)}, the contraction of the tensor product of the two rank-1 tensors constructed from xx and yy is equal to the scalar pairing of xx and yy (represented as a rank-0 tensor). Specifically, contr0,0(fromSingleT(x)fromSingleT(y))=x,yc1\text{contr}_{0,0} (\text{fromSingleT}(x) \otimes \text{fromSingleT}(y)) = \langle x, y \rangle_c \cdot \mathbf{1} where: - fromSingleT\text{fromSingleT} maps a vector to its corresponding rank-1 tensor. - \otimes denotes the tensor product of tensors (`prodT`). - contr0,0\text{contr}_{0,0} is the contraction operation `contrT` acting on the indices of the rank-2 tensor. - ,c\langle \cdot, \cdot \rangle_c is the contraction pairing defined by the tensor species SS for color cc. - 1\mathbf{1} is the identity rank-0 tensor (`Pure.toTensor default`).

definition

kk-linear map from Vc1kVc2V_{c_1} \otimes_k V_{c_2} to rank-2 tensors

Given a tensor species SS over a ring kk and index colors c1,c2Cc_1, c_2 \in C, let Vc1V_{c_1} and Vc2V_{c_2} be the kk-modules (vector spaces) associated with these colors. The function `fromPairT` is a kk-linear map from the tensor product Vc1kVc2V_{c_1} \otimes_k V_{c_2} to the space of rank-2 tensors S.Tensor(c1,c2)S.\text{Tensor}(c_1, c_2). It constructs a two-index tensor by taking the tensor product of the single-index tensors corresponding to the elements in Vc1V_{c_1} and Vc2V_{c_2}.

theorem

fromPairT(xy)=prodT(fromSingleT x,fromSingleT y)\text{fromPairT}(x \otimes y) = \text{prodT}(\text{fromSingleT } x, \text{fromSingleT } y)

For a tensor species SS over a ring kk and index colors c1,c2Cc_1, c_2 \in C, let xVc1x \in V_{c_1} and yVc2y \in V_{c_2} be elements of the vector spaces associated with these colors. The rank-2 tensor constructed from their tensor product xkyx \otimes_k y 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.

theorem

gfromPairT(x)=fromPairT((ρ(g)ρ(g))x)g \cdot \text{fromPairT}(x) = \text{fromPairT}((\rho(g) \otimes \rho(g))x)

Let SS be a tensor species over a group GG and a ring kk. For any index colors c1,c2Cc_1, c_2 \in C, let Vc1V_{c_1} and Vc2V_{c_2} be the kk-modules associated with these colors, and let ρ\rho denote the representation of GG on these modules. For any element xVc1kVc2x \in V_{c_1} \otimes_k V_{c_2} and any group element gGg \in G, the action of gg on the rank-2 tensor constructed from xx satisfies: gfromPairT(x)=fromPairT((ρ(g)ρ(g))(x))g \cdot \text{fromPairT}(x) = \text{fromPairT}((\rho(g) \otimes \rho(g))(x)) where fromPairT\text{fromPairT} is the kk-linear map that constructs a rank-2 tensor from the tensor product of two vector spaces, and (ρ(g)ρ(g))(\rho(g) \otimes \rho(g)) is the induced action on the tensor product Vc1kVc2V_{c_1} \otimes_k V_{c_2}.

theorem

fromPairT((idf)x)=permid(fromPairT x)\text{fromPairT}((\text{id} \otimes f)x) = \text{perm}_{\text{id}}(\text{fromPairT } x)

For a tensor species SS over a ring kk and index colors c1,c2,c2Cc_1, c_2, c_2' \in C, let VcV_{c} denote the kk-module (vector space) associated with color cc. Let h:c2=c2h: c_2 = c_2' be an equality and let f:Vc2Vc2f: V_{c_2} \to V_{c_2'} be the kk-linear map induced by hh (the map S.FD.map(h)S.FD.map(h)). For any element xVc1kVc2x \in V_{c_1} \otimes_k V_{c_2}, the rank-2 tensor constructed from the mapped element satisfies: fromPairT((idf)x)=permTid(fromPairT x)\text{fromPairT}((\text{id} \otimes f)x) = \text{permT}_{\text{id}}(\text{fromPairT } x) where fromPairT\text{fromPairT} is the kk-linear map that constructs a rank-2 tensor from a tensor product of vector spaces, and permTid\text{permT}_{\text{id}} is the tensor permutation map corresponding to the identity permutation, which re-indexes the tensor to account for the color change from configuration [c1,c2][c_1, c_2] to [c1,c2][c_1, c_2'].

theorem

fromPairT(comm x)=perm1,0(fromPairT x)\text{fromPairT}(\text{comm } x) = \text{perm}_{1,0}(\text{fromPairT } x)

For a tensor species SS over a ring kk and index colors c1,c2Cc_1, c_2 \in C, let Vc1V_{c_1} and Vc2V_{c_2} be the kk-modules (vector spaces) associated with these colors. Given an element xVc1kVc2x \in V_{c_1} \otimes_k V_{c_2}, let comm:Vc1kVc2Vc2kVc1\text{comm}: V_{c_1} \otimes_k V_{c_2} \cong V_{c_2} \otimes_k V_{c_1} 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 comm(x)\text{comm}(x) is equivalent to taking the tensor `fromPairT(x)` and permuting its indices by the swap σ(0)=1,σ(1)=0\sigma(0)=1, \sigma(1)=0. That is: fromPairT(comm(x))=permT(σ,h)(fromPairT(x))\text{fromPairT}(\text{comm}(x)) = \text{perm}_T(\sigma, h)(\text{fromPairT}(x)) where σ=[1,0]\sigma = [1, 0] is the permutation swapping the two indices and hh is the condition ensuring the consistency of the index colors.

definition

Contraction of xVcx \in V_c and yVτ(c)Vc2y \in V_{\tau(c)} \otimes V_{c_2}

Given a vector xx in the space VcV_c and a tensor yy in the tensor product Vτ(c)kVc2V_{\tau(c)} \otimes_k V_{c_2}, where τ(c)\tau(c) denotes the dual index of cc, this function constructs a rank-1 tensor in S.Tensor([c2])S.\text{Tensor}([c_2]) by contracting xx with the first index of yy. Categorically, the process is defined by: 1. Forming the tensor product xyVck(Vτ(c)kVc2)x \otimes y \in V_c \otimes_k (V_{\tau(c)} \otimes_k V_{c_2}). 2. Applying the inverse associator α1\alpha^{-1} to regroup the terms as (VckVτ(c))kVc2(V_c \otimes_k V_{\tau(c)}) \otimes_k V_{c_2}. 3. Applying the contraction morphism contrc:VckVτ(c)k\text{contr}_c : V_c \otimes_k V_{\tau(c)} \to k to the first two components. 4. Using the left unitor λ:kkVc2Vc2\lambda : k \otimes_k V_{c_2} \cong V_{c_2} to obtain a vector in Vc2V_{c_2}. 5. Converting this resulting vector into a single-indexed tensor via the linear equivalence `fromSingleT`. For simple tensors y=y1y2y = y_1 \otimes y_2, the operation satisfies: fromSingleTContrFromPairT(x,y1y2)=contrc(xy1)fromSingleT(y2) \text{fromSingleTContrFromPairT}(x, y_1 \otimes y_2) = \text{contr}_c(x \otimes y_1) \cdot \text{fromSingleT}(y_2) where \cdot denotes scalar multiplication by the result of the contraction.

theorem

fromSingleTContrFromPairT(x,y1y2)=contrc(xy1)fromSingleT(y2)\text{fromSingleTContrFromPairT}(x, y_1 \otimes y_2) = \text{contr}_c(x \otimes y_1) \cdot \text{fromSingleT}(y_2)

For any indices c,c2Cc, c_2 \in C, let VcV_c and Vc2V_{c_2} be the corresponding vector spaces and Vτ(c)V_{\tau(c)} be the vector space associated with the dual index of cc. Given a vector xVcx \in V_c, and vectors y1Vτ(c)y_1 \in V_{\tau(c)} and y2Vc2y_2 \in V_{c_2} forming the simple tensor y1y2y_1 \otimes y_2, the contraction operation fromSingleTContrFromPairT\text{fromSingleTContrFromPairT} satisfies: fromSingleTContrFromPairT(x,y1y2)=contrc(xy1)fromSingleT(y2) \text{fromSingleTContrFromPairT}(x, y_1 \otimes y_2) = \text{contr}_c(x \otimes y_1) \cdot \text{fromSingleT}(y_2) where contrc:VcVτ(c)k\text{contr}_c : V_c \otimes V_{\tau(c)} \to k is the contraction morphism, fromSingleT\text{fromSingleT} is the linear equivalence mapping a vector to a rank-1 tensor, and \cdot denotes scalar multiplication.

theorem

contr(fromSingleT xfromPairT(y1y2))=fromSingleTContrFromPairT(x,y1y2)\text{contr}(\text{fromSingleT } x \otimes \text{fromPairT}(y_1 \otimes y_2)) = \text{fromSingleTContrFromPairT}(x, y_1 \otimes y_2)

Let SS be a tensor species over a ring kk and CC be the set of index colors. For any index colors c,c2Cc, c_2 \in C, let VcV_c be the kk-module associated with cc and VτcV_{\tau c} be the kk-module associated with the dual color of cc. Given a vector xVcx \in V_c and vectors y1Vτc,y2Vc2y_1 \in V_{\tau c}, y_2 \in V_{c_2}, the contraction of the rank-3 tensor product of fromSingleT(x)\text{fromSingleT}(x) and fromPairT(y1y2)\text{fromPairT}(y_1 \otimes y_2) is equal to the rank-1 tensor fromSingleTContrFromPairT(x,y1y2)\text{fromSingleTContrFromPairT}(x, y_1 \otimes y_2). Specifically, contr0,1(fromSingleT(x)fromPairT(y1y2))=permTid(fromSingleTContrFromPairT(x,y1y2))\text{contr}_{0,1} (\text{fromSingleT}(x) \otimes \text{fromPairT}(y_1 \otimes y_2)) = \text{permT}_{\text{id}} (\text{fromSingleTContrFromPairT}(x, y_1 \otimes y_2)) where: - fromSingleT\text{fromSingleT} and fromPairT\text{fromPairT} are the canonical maps from vectors/tensor products of vectors to rank-1 and rank-2 tensors, respectively. - prodT\text{prodT} (denoted by \otimes) forms the rank-3 tensor with indices [c,τc,c2][c, \tau c, c_2]. - contr0,1\text{contr}_{0,1} is the contraction operation `contrT` acting on the indices of color cc and τc\tau c (the indices at positions 0 and 1). - fromSingleTContrFromPairT(x,y1y2)\text{fromSingleTContrFromPairT}(x, y_1 \otimes y_2) represents the vector contraction x,y1c\langle x, y_1 \rangle_c resulting in the rank-1 tensor x,y1cfromSingleT(y2)\langle x, y_1 \rangle_c \cdot \text{fromSingleT}(y_2). - permTid\text{permT}_{\text{id}} is the identity permutation used for index type alignment.

theorem

contr(fromSingleT xfromPairT y)=fromSingleTContrFromPairT(x,y)\text{contr}(\text{fromSingleT } x \otimes \text{fromPairT } y) = \text{fromSingleTContrFromPairT}(x, y)

Let SS be a tensor species over a ring kk and CC be the set of index colors. For any index colors c,c2Cc, c_2 \in C, let VcV_c be the kk-module associated with cc and VτcV_{\tau c} be the kk-module associated with the dual color of cc. Given a vector xVcx \in V_c and a tensor yVτckVc2y \in V_{\tau c} \otimes_k V_{c_2}, the contraction of the rank-3 tensor formed by the product of the rank-1 tensor fromSingleT(x)\text{fromSingleT}(x) and the rank-2 tensor fromPairT(y)\text{fromPairT}(y) is equal to the rank-1 tensor fromSingleTContrFromPairT(x,y)\text{fromSingleTContrFromPairT}(x, y). Specifically, contr0,1(fromSingleT(x)fromPairT(y))=permTid(fromSingleTContrFromPairT(x,y))\text{contr}_{0,1} (\text{fromSingleT}(x) \otimes \text{fromPairT}(y)) = \text{permT}_{\text{id}} (\text{fromSingleTContrFromPairT}(x, y)) where: - fromSingleT\text{fromSingleT} and fromPairT\text{fromPairT} are the canonical maps from vectors and tensor products of vectors to rank-1 and rank-2 tensors, respectively. - prodT\text{prodT} (denoted by \otimes) forms the rank-3 tensor with indices [c,τc,c2][c, \tau c, c_2]. - contr0,1\text{contr}_{0,1} is the contraction operation `contrT` acting on the indices at positions 0 and 1 (colors cc and τc\tau c). - fromSingleTContrFromPairT(x,y)\text{fromSingleTContrFromPairT}(x, y) is the rank-1 tensor in S.Tensor([c2])S.\text{Tensor}([c_2]) resulting from the contraction of xx with the first index of yy. - permTid\text{permT}_{\text{id}} is the identity permutation used for index type alignment.

definition

Contraction of xVc1Vcx \in V_{c_1} \otimes V_c and yVτcVc2y \in V_{\tau c} \otimes V_{c_2} into a rank-2 tensor

Given a tensor species SS over a ring kk and index colors c,c1,c2Cc, c_1, c_2 \in C, let VciV_{c_i} be the kk-modules associated with these colors. For elements xVc1kVcx \in V_{c_1} \otimes_k V_c and yVτckVc2y \in V_{\tau c} \otimes_k V_{c_2} (where τc\tau c is the dual color of cc), this function constructs a rank-2 tensor in S.Tensor(c1,c2)S.\text{Tensor}(c_1, c_2). The construction is performed categorically: it takes the tensor product xyx \otimes y, reassociates the factors to isolate VckVτcV_c \otimes_k V_{\tau c}, applies the contraction morphism VckVτckV_c \otimes_k V_{\tau c} \to k, and uses the left unitor to obtain an element in Vc1kVc2V_{c_1} \otimes_k V_{c_2}, which is finally mapped to a rank-2 tensor via `fromPairT`.

theorem

fromPairTContr(x1x2,y1y2)=contr(x2y1)fromPairT(x1y2)\text{fromPairTContr}(x_1 \otimes x_2, y_1 \otimes y_2) = \text{contr}(x_2 \otimes y_1) \cdot \text{fromPairT}(x_1 \otimes y_2)

Let SS be a tensor species over a ring kk, and for any color cCc \in C, let VcV_c be the kk-module associated with it. For any vectors x1Vc1x_1 \in V_{c_1}, x2Vcx_2 \in V_c, y1Vτcy_1 \in V_{\tau c}, and y2Vc2y_2 \in V_{c_2} (where τc\tau c is the dual color of cc), the rank-2 tensor obtained by the contraction operation `fromPairTContr` on the elementary tensors x1x2x_1 \otimes x_2 and y1y2y_1 \otimes y_2 satisfies: fromPairTContr(x1x2,y1y2)=contrc(x2y1)fromPairT(x1y2)\text{fromPairTContr}(x_1 \otimes x_2, y_1 \otimes y_2) = \text{contr}_c(x_2 \otimes y_1) \cdot \text{fromPairT}(x_1 \otimes y_2) where contrc:VckVτck\text{contr}_c: V_c \otimes_k V_{\tau c} \to k is the contraction morphism for the color cc, and fromPairT\text{fromPairT} maps an element of Vc1kVc2V_{c_1} \otimes_k V_{c_2} to a rank-2 tensor.

theorem

contr1,2(fromPairT(x1x2)fromPairT(y1y2))=fromPairTContr(x1x2,y1y2)\text{contr}_{1,2} (\text{fromPairT}(x_1 \otimes x_2) \otimes \text{fromPairT}(y_1 \otimes y_2)) = \text{fromPairTContr}(x_1 \otimes x_2, y_1 \otimes y_2)

Let SS be a tensor species over a ring kk. For index colors c,c1,c2Cc, c_1, c_2 \in C, let Vc1,Vc,VτcV_{c_1}, V_c, V_{\tau c}, and Vc2V_{c_2} be the kk-modules associated with these colors, where τc\tau c is the dual color of cc. For any vectors x1Vc1,x2Vc,y1Vτcx_1 \in V_{c_1}, x_2 \in V_c, y_1 \in V_{\tau c}, and y2Vc2y_2 \in V_{c_2}, the contraction of the tensor product of the rank-2 tensors constructed from the elementary tensors x1kx2x_1 \otimes_k x_2 and y1ky2y_1 \otimes_k y_2 at the middle indices is equal to the rank-2 tensor obtained via the direct contraction map `fromPairTContr`. Specifically, contr1,2(fromPairT(x1kx2)fromPairT(y1ky2))=fromPairTContr(x1kx2,y1ky2)\text{contr}_{1,2} \left( \text{fromPairT}(x_1 \otimes_k x_2) \otimes \text{fromPairT}(y_1 \otimes_k y_2) \right) = \text{fromPairTContr}(x_1 \otimes_k x_2, y_1 \otimes_k y_2) where: - fromPairT\text{fromPairT} is the linear map from VakVbV_a \otimes_k V_b to the space of rank-2 tensors. - \otimes between tensors denotes the tensor product operation `prodT`. - contr1,2\text{contr}_{1,2} (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).

theorem

contr1,2(fromPairT(x)fromPairT(y))=fromPairTContr(x,y)\text{contr}_{1,2}(\text{fromPairT}(x) \otimes \text{fromPairT}(y)) = \text{fromPairTContr}(x, y)

Let SS be a tensor species over a ring kk. For any index colors c,c1,c2Cc, c_1, c_2 \in C, let Vc1,Vc,VτcV_{c_1}, V_c, V_{\tau c}, and Vc2V_{c_2} be the kk-modules associated with these colors, where τc\tau c denotes the dual color of cc. For any elements xVc1kVcx \in V_{c_1} \otimes_k V_c and yVτckVc2y \in V_{\tau c} \otimes_k V_{c_2}, the contraction of the tensor product of the rank-2 tensors constructed from xx and yy is equal to the rank-2 tensor obtained via the direct contraction map `fromPairTContr`. Specifically, contr1,2(fromPairT(x)fromPairT(y))=fromPairTContr(x,y)\text{contr}_{1,2} \left( \text{fromPairT}(x) \otimes \text{fromPairT}(y) \right) = \text{fromPairTContr}(x, y) where: - fromPairT\text{fromPairT} is the kk-linear map from VakVbV_a \otimes_k V_b to the space of rank-2 tensors. - \otimes between tensors denotes the tensor product operation `prodT`. - contr1,2\text{contr}_{1,2} (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 cc and τc\tau c). - The equality holds up to a canonical re-indexing (permutation) of the resulting indices.

theorem

Basis Representation of fromPairT(x)\text{fromPairT}(x) equals Basis Representation of xx in VcVc1V_c \otimes V_{c_1}

Let SS be a tensor species over a ring kk, and let c,c1Cc, c_1 \in C be index colors with corresponding kk-modules VcV_c and Vc1V_{c_1}. For any element xVckVc1x \in V_c \otimes_k V_{c_1} and any multi-index b=(b0,b1)b = (b_0, b_1) for rank-2 tensors of colors (c,c1)(c, c_1), the coefficient of the rank-2 tensor fromPairT(x)\text{fromPairT}(x) at index bb with respect to the tensor basis is equal to the coefficient of xx at the index pair (b0,b1)(b_0, b_1) with respect to the induced tensor product basis of VckVc1V_c \otimes_k V_{c_1}. That is, [fromPairT(x)]b=[x](b0,b1).[\text{fromPairT}(x)]_b = [x]_{(b_0, b_1)}.

theorem

fromPairT(eb0eb1)=E(b0,b1)\text{fromPairT}(e_{b_0} \otimes e_{b_1}) = \mathcal{E}_{(b_0, b_1)}

Let SS be a tensor species over a ring kk. For any index colors c,c1Cc, c_1 \in C and basis indices b0{0,,dim(Vc)1}b_0 \in \{0, \dots, \text{dim}(V_c)-1\} and b1{0,,dim(Vc1)1}b_1 \in \{0, \dots, \text{dim}(V_{c_1})-1\}, let eb0(c)e_{b_0}^{(c)} and eb1(c1)e_{b_1}^{(c_1)} be the basis vectors of the kk-modules VcV_c and Vc1V_{c_1} respectively. Then, the value of the kk-linear map fromPairT\text{fromPairT} on the tensor product of these basis vectors is the basis element of the rank-2 tensor space S.Tensor(c,c1)S.\text{Tensor}(c, c_1) corresponding to the multi-index (b0,b1)(b_0, b_1): fromPairT(eb0(c)keb1(c1))=E(b0,b1),\text{fromPairT}(e_{b_0}^{(c)} \otimes_k e_{b_1}^{(c_1)}) = \mathcal{E}_{(b_0, b_1)}, where E(b0,b1)\mathcal{E}_{(b_0, b_1)} denotes the basis element of the tensor space for the color pair (c,c1)(c, c_1) at indices (b0,b1)(b_0, b_1).

definition

Rank-2 tensor from v:1Vc1kVc2v: \mathbb{1} \to V_{c_1} \otimes_k V_{c_2}

Let SS be a tensor species over a ring kk and a group GG. For any two colors c1,c2Cc_1, c_2 \in C, let Vc1V_{c_1} and Vc2V_{c_2} be the kk-modules (representations) associated with these colors. The function `fromConstPair` constructs a rank-2 tensor in S.Tensor(c1,c2)S.\text{Tensor}(c_1, c_2) from a morphism v:1Vc1kVc2v: \mathbb{1} \to V_{c_1} \otimes_k V_{c_2}, where 1\mathbb{1} is the monoidal unit (the trivial representation) in the category Rep(k,G)\text{Rep}(k, G). The resulting tensor is obtained by evaluating the linear map vv at the identity 1k1 \in k and applying the transformation `fromPairT` to the resulting element of the tensor product Vc1kVc2V_{c_1} \otimes_k V_{c_2}. This construction defines "constant" or invariant rank-2 tensors, such as a metric or a unit tensor.

theorem

gfromConstPair(v)=fromConstPair(v)g \cdot \text{fromConstPair}(v) = \text{fromConstPair}(v)

Let SS be a tensor species over a ring kk and a group GG. For any index colors c1,c2Cc_1, c_2 \in C, let Vc1V_{c_1} and Vc2V_{c_2} be the kk-modules (representations) associated with these colors. Let 1\mathbb{1} denote the monoidal unit (the trivial representation) in the category Rep(k,G)\text{Rep}(k, G). For any morphism of representations v:1Vc1kVc2v: \mathbb{1} \to V_{c_1} \otimes_k V_{c_2} and any group element gGg \in G, the rank-2 tensor constructed via `fromConstPair` is invariant under the group action: gfromConstPair(v)=fromConstPair(v)g \cdot \text{fromConstPair}(v) = \text{fromConstPair}(v)

theorem

fromConstPair(v(idf))=permTid(fromConstPair v)\text{fromConstPair}(v \gg (\text{id} \otimes f)) = \text{permT}_{\text{id}}(\text{fromConstPair } v)

Let SS be a tensor species over a ring kk and a group GG. For any colors c1,c2,c2Cc_1, c_2, c_2' \in C, let Vc1,Vc2,Vc2V_{c_1}, V_{c_2}, V_{c_2'} be the kk-modules (representations) associated with these colors. Let h:c2=c2h : c_2 = c_2' be an equality and f:Vc2Vc2f : V_{c_2} \to V_{c_2'} be the kk-linear map induced by hh. Given a morphism v:1Vc1kVc2v : \mathbb{1} \to V_{c_1} \otimes_k V_{c_2} from the monoidal unit 1\mathbb{1} in the category of representations Rep(k,G)\text{Rep}(k, G), applying the rank-2 tensor construction `fromConstPair` to the composition of vv with the map idVc1f\text{id}_{V_{c_1}} \otimes f is equivalent to re-indexing the tensor constructed from vv using the identity permutation: fromConstPair(v(idVc1f))=permTid(fromConstPair v)\text{fromConstPair}(v \gg (\text{id}_{V_{c_1}} \otimes f)) = \text{permT}_{\text{id}}(\text{fromConstPair } v) where permTid\text{permT}_{\text{id}} is the tensor permutation map corresponding to the identity permutation, which accounts for the change in index colors from configuration [c1,c2][c_1, c_2] to [c1,c2][c_1, c_2'].

theorem

fromConstPair(vβ)=permT([1,0])(fromConstPair v)\text{fromConstPair}(v \gg \beta) = \text{perm}_T([1, 0])(\text{fromConstPair } v)

Let SS be a tensor species over a ring kk and a group GG. For any two colors c1,c2Cc_1, c_2 \in C, let Vc1V_{c_1} and Vc2V_{c_2} be the kk-modules (representations) associated with these colors. Given a morphism v:1Vc1kVc2v: \mathbb{1} \to V_{c_1} \otimes_k V_{c_2} from the monoidal unit 1\mathbb{1} in the category of representations Rep(k,G)\text{Rep}(k, G), let βVc1,Vc2:Vc1Vc2Vc2Vc1\beta_{V_{c_1}, V_{c_2}}: V_{c_1} \otimes V_{c_2} \to V_{c_2} \otimes V_{c_1} be the braiding (canonical commutativity isomorphism) in the category. The theorem states that applying the rank-2 tensor construction `fromConstPair` to the braided morphism vβv \gg \beta is equivalent to taking the tensor constructed from vv and swapping its indices: fromConstPair(vβ)=permT(σ,h)(fromConstPair(v))\text{fromConstPair}(v \gg \beta) = \text{perm}_T(\sigma, h)(\text{fromConstPair}(v)) where σ=[1,0]\sigma = [1, 0] is the permutation swapping the two indices and hh is the proof of consistency for the index colors.

definition

kk-linear map from Vc1(Vc2Vc3)V_{c_1} \otimes (V_{c_2} \otimes V_{c_3}) to rank-3 tensors

For a tensor species SS over a ring kk and index colors c1,c2,c3Cc_1, c_2, c_3 \in C, `fromTripleT` is the kk-linear map: Φ:Vc1k(Vc2kVc3)S.Tensor(c1,c2,c3) \Phi : V_{c_1} \otimes_k (V_{c_2} \otimes_k V_{c_3}) \to S.\text{Tensor}(c_1, c_2, c_3) where Vci=(S.FD.obj(ci)).VV_{c_i} = (S.FD.obj(c_i)).V is the underlying kk-module associated with the color cic_i, and S.Tensor(c1,c2,c3)S.\text{Tensor}(c_1, c_2, c_3) is the space of tensors with three indices of colors c1,c2,c3c_1, c_2, c_3. 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.

theorem

`fromTripleT` of a pure tensor equals the product of `fromSingleT` tensors

Let SS be a tensor species over a ring kk. For any index colors c1,c2,c3Cc_1, c_2, c_3 \in C and elements xVc1x \in V_{c_1}, yVc2y \in V_{c_2}, and zVc3z \in V_{c_3} (where VciV_{c_i} is the module associated with color cic_i), the rank-3 tensor constructed via fromTripleT\text{fromTripleT} from the element x(yz)x \otimes (y \otimes z) is equal to the product of the rank-1 tensors fromSingleT x\text{fromSingleT } x, fromSingleT y\text{fromSingleT } y, and fromSingleT z\text{fromSingleT } z (as calculated by prodT\text{prodT}), up to an identity permutation of the indices.

theorem

gfromTripleT(x)=fromTripleT((ρc1(g)ρc2(g)ρc3(g))x)g \cdot \text{fromTripleT}(x) = \text{fromTripleT}((\rho_{c_1}(g) \otimes \rho_{c_2}(g) \otimes \rho_{c_3}(g))x)

Let SS be a tensor species over a ring kk and a group GG. For any index colors c1,c2,c3Cc_1, c_2, c_3 \in C, let VciV_{c_i} be the kk-module associated with the color cic_i and ρci\rho_{c_i} be the representation of GG on VciV_{c_i}. For any element xVc1k(Vc2kVc3)x \in V_{c_1} \otimes_k (V_{c_2} \otimes_k V_{c_3}) and any group element gGg \in G, the action of gg on the rank-3 tensor constructed from xx via the linear map fromTripleT\text{fromTripleT} is given by: gfromTripleT(x)=fromTripleT((ρc1(g)(ρc2(g)ρc3(g)))x)g \cdot \text{fromTripleT}(x) = \text{fromTripleT}((\rho_{c_1}(g) \otimes (\rho_{c_2}(g) \otimes \rho_{c_3}(g)))x) where \cdot denotes the group action on the tensor space and \otimes denotes the induced map on the tensor product of modules.

theorem

Basis representation of fromTripleT(x)\text{fromTripleT}(x) equals basis representation of xx

Let SS be a tensor species over a ring kk and c,c1,c2Cc, c_1, c_2 \in C be index colors. Let Vc,Vc1,Vc2V_c, V_{c_1}, V_{c_2} denote the kk-modules associated with these colors. For any element xVck(Vc1kVc2)x \in V_c \otimes_k (V_{c_1} \otimes_k V_{c_2}) and any multi-index bb for a rank-3 tensor with colors (c,c1,c2)(c, c_1, c_2), the component (coefficient) of the tensor fromTripleT(x)\text{fromTripleT}(x) in the tensor basis at index bb is equal to the component of xx in the product basis of Vc(Vc1Vc2)V_c \otimes (V_{c_1} \otimes V_{c_2}) at indices (b0,b1,b2)(b_0, b_1, b_2).

theorem

fromTripleT\text{fromTripleT} maps the product of basis elements to the rank-3 basis tensor

Let SS be a tensor species over a ring kk and let c,c1,c2Cc, c_1, c_2 \in C be index colors. For any basis indices b0,b1,b2b_0, b_1, b_2 of the respective representation spaces, the kk-linear map fromTripleT\text{fromTripleT} maps the triple tensor product of basis elements (S.basis c b0)(S.basis c1 b1S.basis c2 b2)(S.\text{basis } c \ b_0) \otimes (S.\text{basis } c_1 \ b_1 \otimes S.\text{basis } c_2 \ b_2) to the basis tensor of the species SS with colors (c,c1,c2)(c, c_1, c_2) at the multi-index (b0,b1,b2)(b_0, b_1, b_2).

definition

Constant rank-3 tensor constructed from an invariant morphism vv

Let SS be a tensor species over a ring kk and a group GG. For any three index colors c1,c2,c3Cc_1, c_2, c_3 \in C, let VciV_{c_i} denote the representation space associated with the color cic_i. Given a morphism v:1Vc1Vc2Vc3v: \mathbb{1} \to V_{c_1} \otimes V_{c_2} \otimes V_{c_3} in the category of representations Rep(k,G)\text{Rep}(k, G), where 1\mathbb{1} is the trivial representation, `fromConstTriple` constructs a rank-3 tensor in S.Tensor(c1,c2,c3)S.\text{Tensor}(c_1, c_2, c_3). This tensor is obtained by evaluating the underlying linear map of vv at 1k1 \in k to produce an invariant element in the triple tensor product Vc1(Vc2Vc3)V_{c_1} \otimes (V_{c_2} \otimes V_{c_3}), 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.

theorem

gfromConstTriple(v)=fromConstTriple(v)g \cdot \text{fromConstTriple}(v) = \text{fromConstTriple}(v)

Let SS be a tensor species over a ring kk and a group GG. For any three index colors c1,c2,c3Cc_1, c_2, c_3 \in C, let VciV_{c_i} denote the representation space associated with the color cic_i. Given a morphism v:1Vc1(Vc2Vc3)v: \mathbb{1} \to V_{c_1} \otimes (V_{c_2} \otimes V_{c_3}) from the trivial representation 1\mathbb{1} in the category of representations Rep(k,G)\text{Rep}(k, G), the rank-3 tensor constructed from vv, denoted fromConstTriple(v)\text{fromConstTriple}(v), is invariant under the group action. That is, for any gGg \in G: gfromConstTriple(v)=fromConstTriple(v)g \cdot \text{fromConstTriple}(v) = \text{fromConstTriple}(v)

definition

General Constant Tensor Node

A general constant node. Given a morphism T T from the trivial representation to the representation associated with a color configuration c c of length n n , this defines a tensor of species S S with colors c c .

theorem

fromConst T=T(1)\text{fromConst } T = T(1)

Let nn be a natural number and c:Fin nCc: \text{Fin } n \to C be a color configuration. Let T:1S(c)T: \mathbb{1} \to S(c) be a morphism from the trivial representation 1\mathbb{1} in the category of representations Rep(k,G)\text{Rep}(k, G) to the representation S(c)S(c) defined by the tensor species SS and the color configuration cc. Then the tensor constructed from this morphism, denoted fromConst T\text{fromConst } T, is equal to the image of the unit scalar 1k1 \in k under the morphism TT, i.e., fromConst T=T(1)\text{fromConst } T = T(1).

theorem

Invariance of constant tensors under group action: gfromConst T=fromConst Tg \cdot \text{fromConst } T = \text{fromConst } T

Let GG be a group and kk be a field. Let T:1Rep kGS(c)T: \mathbb{1}_{\text{Rep } kG} \to S(c) be a morphism from the trivial representation 1\mathbb{1} to the representation associated with a tensor species SS and a color configuration cc of length nn. For any group element gGg \in G, the tensor constructed from TT, denoted as fromConst T\text{fromConst } T, is invariant under the group action, satisfying gfromConst T=fromConst Tg \cdot \text{fromConst } T = \text{fromConst } T.