PhyslibSearch

Physlib.Relativity.Tensors.Constructors

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]

#fromSingleP

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]

#fromSingleT

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

#fromSingleT_symm_pure

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)

#fromSingleT_eq_pureT

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)

#actionT_fromSingleT

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

#fromSingleT_map

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

#contrT_fromSingleT_fromSingleT

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

#fromPairT

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)

#fromPairT_tmul

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)

#actionT_fromPairT

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)

#fromPairT_map_right

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)

#fromPairT_comm

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}

#fromSingleTContrFromPairT

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)

#fromSingleTContrFromPairT_tmul

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)

#fromSingleT_contr_fromPairT_tmul

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)

#contrT_fromSingleT_fromPairT

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

#fromPairTContr

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)

#fromPairTContr_tmul_tmul

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)

#fromPairT_contr_fromPairT_eq_fromPairTContr_tmul

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)

#fromPairT_contr_fromPairT_eq_fromPairTContr

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}

#fromPairT_basis_repr

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)}

#fromPairT_apply_basis_repr

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}

#fromConstPair

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)

#actionT_fromConstPair

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)

#fromConstPair_whiskerLeft

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)

#fromConstPair_braid

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

#fromTripleT

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

#fromTripleT_tmul

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)

#actionT_fromTripleT

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

#fromTripleT_basis_repr

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

#fromTripleT_apply_basis

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

#fromConstTriple

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)

#actionT_fromConstTriple

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

#fromConst

A 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 \).

theorem

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

#fromConst_eq

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

#actionT_fromConst

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.