Matrix Elements for the Eu Ion

This dataset provides angular matrices of spherical tensor operators for the f6 configuration (lanthanide ion Eu3+) in exact arithmetic. The matrices are derived from the software package AMELI (Angular Matrix Elements of Lanthanide Ions). They have been calculated in the determinantal product state space and transformed to $LS$-coupling. Each $LS$-state is classified by a complete set of irreducible representations matching those published by C. W. Nielson and G. F. Koster. The Hamilton matrices are comprehensively compared and verified with the values published by B. R. Judd and W. T. Carnall. Matrix Storage Format The value $v$ of each non-zero matrix element is represented by three values $s$, $n$, and $d$ as signed square root of a rational number: $$v=(-1)^s\sqrt{\frac{n}{d}}\ .$$ The storage format leverages the sparsity of the matrices. It is closely related to the COO standard format for sparse matrices with three vectors for the row index, column index, and value index of each non-zero matrix element. For symmetric matrices only the lower triangle matrix is stored. The actual values are stored in a separate list of unique values, the length of which is usually much smaller than the total number of non-zero elements. Storage follows the canonical COO order with row as primary and column as secondary index. The list of unique values is sorted in ascending order. If a matrix contains integer values $n$ or $d$ that exceed the 64-bit maximum of HDF5 data types, its values are split bit-wise and stored in multiple parts. Each matrix is stored in a SciDataContainer file with filename extension .zdc. This container file is a standard ZIP folder with a certain inner structure of metadata in JSON files following the FAIR principles of modern research data management. The matrix data is stored in the HDF5 file data/matrix.hdf5 inside the container. A detailed description of the data structures is given in the JSON file meta.json. Content of Dataset Record All tensor operator matrices are grouped with respect to their state spaces. The following files are included in this dataset record: FileDescription product.zip Product state tensor operator matrices in the subfolder product. Contains also the matrix transform.zdc used to transform product states or product state matrices into the $LS$-coupling scheme. Intended for energy level fits and transition calculations for lanthanide ions in crystalline materials. sljm.zip Tensor operator matrices in $LS$-coupling in the subfolder sljm. slj.zip Tensor operator matrices of the $J$-multiplets in $LS$-coupling. These are matrices from sljm.zip collapsed to the stretched states $M_J=J$ in the subfolder slj and matrices containing reduced matrix elements in the subfolder sljm_reduced. Intended for energy level fits and Judd-Ofelt calculations for lanthanide ions in amorphous materials. support.zip This special file is only useful when the AMELI package is extended to generate new custom operator matrices. In this case the included data containers with intermediate results optimize the calculation speed within the AMELI package. hashes.json The hash codes in this file are used for the automized version management algorithm. Matrix Files Each set of tensor operator matrices contains the following files: Filename Description Tensor Operator Radial Integral U_{k}_{q}.zdcComponent $q$ of the total unit tensor operator of rank $k$ in the orbital angular momentum space$\mathrm{{U}}^{{(k)}}_q$ T_{k}_{q}.zdcComponent $q$ of the total unit tensor operator of rank $k$ in the spin space$\mathrm{{T}}^{{(k)}}_q$ UU_{k}.zdcSquared total unit tensor operator of rank $k$ in the orbital angular momentum space$(\mathrm{{U}}^{{(k)}}\cdot\mathrm{{U}}^{{(k)}})$ TT_{k}.zdcSquared total unit tensor operator of rank $k$ in the spin space$(\mathrm{{T}}^{{(k)}}\cdot\mathrm{{T}}^{{(k)}})$ UT_{k}.zdcScalar product of the total unit tensor operators of rank $k$ in the orbital and spin spaces$(\mathrm{{U}}^{{(k)}}\cdot\mathrm{{T}}^{{(k)}})$ C_{k}_{q}.zdcComponent $q$ of the Coulomb operator of rank $k$$\mathrm{{C}}^{{(k)}}_q$ L_{q}.zdcComponent $q$ of the total orbital angular momentum operator$\mathrm{{L}}_q$ S_{q}.zdcComponent $q$ of the total spin angular momentum operator$\mathrm{{S}}_q$ J_{q}.zdcComponent $q$ of the total angular momentum operator$\mathrm{{J}}_q$ LL.zdcSquared total orbital angular momentum operator$(\mathrm{{L}}\cdot\mathrm{{L}})$$\alpha$ SS.zdcSquared total spin angular momentum operator$(\mathrm{{S}}\cdot\mathrm{{S}})$ JJ.zdcSquared total angular momentum operator$(\mathrm{{J}}\cdot\mathrm{{J}})$ LS.zdcScalar product of the total orbital and spin angular momentum operators$(\mathrm{{L}}\cdot\mathrm{{S}})$ C2.zdcCasimir operator of the special group $G_2$$\mathrm{{C}}_2(G_2)$$\beta$ CR.zdcCasimir operator of the special orthogonal (rotational) group in $2l+1$ dimensions$\mathrm{{C}}_2(SO(2l+1))$$\gamma$ H1_{k}.zdcCoulomb first order perturbation Hamiltonian of rank $k$$\mathrm{{f}}_k$$F^k$ H2.zdcSpin-orbit first order perturbation Hamiltonian$\mathrm{{z}}$$\zeta$ H4_{c}.zdcEffective Coulomb second order perturbation Hamiltonian$\mathrm{{t}}_c$$T^c$ Hss_{k}.zdcSpin-spin first order perturbation Hamiltonian of rank $k$$\mathrm{{m}}_{{k,ss}}$ Hsoo_{k}.zdcSpin-other-orbit first order perturbation Hamiltonian of rank $k$$\mathrm{{m}}_{{k,soo}}$ H5_{k}.zdcSpin-spin and spin-other-orbit first order perturbation Hamiltonian of rank $k$$\mathrm{{m}}_k$$M^k$ H6_{k}.zdcEffective electrostatic spin-orbit second order perturbation Hamiltonian of rank $k$$\mathrm{{p}}_k$$P^k$ Hcf_{k}_{q}.zdcComponent $q$ of the crystal field perturbation Hamiltonian of rank $k$$\mathrm{{H}}_{{\mathrm{{cf}},q}}^{{(k)}}$$B^k_q$ The component part _{q} is missing in the filenames of the set of matrices containing reduced matrix elements. Reduced matrix elements are an entity introduced by the Wigner-Eckart theorem, which describes the angular behaviour of any spherical tensor operator $\mathrm{A}^{(k)}$: $$ \langle J' M' | \mathrm{A}^{(k)}_{q} | J M \rangle = (-1)^{J'-M'} \begin{pmatrix} J' & k & J \\ -M' & q & M \end{pmatrix} \langle J' || \mathrm{A}^{(k)} || J \rangle $$ State Representation Each matrix data container includes the quantum numbers of all states in the JSON file data/matrix.json. For product states these are the quantum numbers $n$, $l$, $m_l$, $s$, and $m_s$ of each electron. States in $LS$-coupling are characterised by irreducible representations which in most cases are connected to eigenvalues of certain tensor operators. Key Irreducible Representation Related Tensor Operator S2Multiplicity $2S+1$ derived from the eigenvalue $S(S+1)$Squared operator of the total spin $(\mathrm{S}\cdot\mathrm{S})$ C73-tuple $W=(w_1w_2w_3)$Casimir operator $\mathrm{C}_2(SO(7))$ of the special orthogonal group in 7 dimensions C22-tuple $U=(u_1u_2)$Casimir operator $\mathrm{C}_2(G_2)$ of the special group $G_2$ L2Spectral character of $L$ derived from the eigenvalue $L(L+1)$Squared operator of the total orbital angular momentum $(\mathrm{L}\cdot\mathrm{L})$ J2Quantum number $J$ derived from the eigenvalue $J(J+1)$Squared operator of the total angular momentum $(\mathrm{J}\cdot\mathrm{J})$ JzEigenvalue $M_J$Operator of the axial component of the total angular momentum $\mathrm{J}_0$ senSeniority number $\nu$Operators $(\mathrm{S}\cdot\mathrm{S})$ and $\mathrm{C}_2(SO(7))$ numIndex of different states with same quantum numbers $L$ and $S$ tauIndex $\tau$ of different states with same set of quantum numbers Version History The dataset is published with a semantic version number in the scheme 'major.minor.patch', starting at '1.0.0'. The patch number is incremented for every update of the datasets metadata without any modification of the included files. The minor number identifies a dataset release with modified files. However, these are only non-functional modifications of metadata in the data containers. Modifications may include updated or corrected titles or descriptions in the metadata of data containers, or new metadata attributes. The major number is incremented with functional modifications of data containers or additional tensor operators. Version 1.0.0 Initial version Version 2.0.0 Replaced proprietary sign fix inside $J$-multiplets by ladder operator Coulomb operators added Crystal field operators added Version 3.0.0 Fixed Hcf/{k},0 matrices (wrong factor 2)本数据集以精确算术形式，提供了f⁶电子组态（镧系离子Eu³+）对应的球张量算符（spherical tensor operator）的角动量矩阵。这些矩阵源自软件包AMELI（Angular Matrix Elements of Lanthanide Ions，镧系离子角矩阵元），在行列式积态空间中计算得到，并被转换至LS耦合（LS-coupling）表象。每个LS耦合态通过一套完整的不可约表示（irreducible representation）进行分类，这套分类标准与C. W. Nielson和G. F. Koster发表的结果一致。哈密顿矩阵已与B. R. Judd和W. T. Carnall发表的数值进行了全面比对与验证。 ## 矩阵存储格式 每个非零矩阵元的数值$v$由$s$、$n$、$d$三个值表示，对应带符号的有理数平方根形式： $$v=(-1)^ssqrt{frac{n}{d}} .$$ 该存储格式利用矩阵稀疏性构建，与稀疏矩阵的COO标准格式高度契合，后者通过三个向量分别存储每个非零矩阵元的行索引、列索引与值索引。对于对称矩阵，仅存储其下三角部分。实际的矩阵元数值存储在单独的唯一值列表中，该列表的长度通常远小于非零矩阵元的总数量。存储遵循标准COO排序规则，以行索引为主键、列索引为次键。唯一值列表按升序排列。若矩阵中的$n$或$d$整数值超出HDF5数据类型的64位最大值，则将数值按位拆分并分多段存储。 每个矩阵存储于扩展名为.zdc的SciDataContainer文件中。该容器文件为标准ZIP文件夹，内部包含遵循现代科研数据管理FAIR原则的JSON格式元数据结构。容器内的矩阵数据存储于HDF5文件data/matrix.hdf5中。数据结构的详细说明位于JSON文件meta.json内。 ## 数据集记录内容 所有张量算符矩阵按其态空间进行分组。本数据集记录包含以下文件： 1. **product.zip**：位于子文件夹product中，包含乘积态张量算符矩阵，同时还包含用于将乘积态或乘积态矩阵转换至LS耦合表象的transform.zdc文件。适用于晶体材料中镧系离子的能级拟合与跃迁计算。 2. **sljm.zip**：位于子文件夹sljm中，包含LS耦合表象下的张量算符矩阵。 3. **slj.zip**：包含LS耦合表象下J多重态（J-multiplet）的张量算符矩阵。其中，子文件夹slj内的矩阵由sljm.zip中的矩阵坍缩至拉伸态$M_J=J$得到；子文件夹sljm_reduced内的矩阵则包含约化矩阵元（reduced matrix element）。适用于非晶态材料中镧系离子的能级拟合与Judd-Ofelt计算。 4. **support.zip**：仅在扩展AMELI软件包以生成自定义算符矩阵时可用。其包含的中间结果数据容器可优化AMELI软件包内的计算速度。 5. **hashes.json**：文件中的哈希码用于自动化版本管理算法。 ## 矩阵文件 每组张量算符矩阵包含以下文件： - `U_{k}_{q}.zdc`：轨道角动量空间中秩为$k$的总单位张量算符的$q$分量，即$mathrm{U}^{(k)}_q$ - `T_{k}_{q}.zdc`：自旋空间中秩为$k$的总单位张量算符的$q$分量，即$mathrm{T}^{(k)}_q$ - `UU_{k}.zdc`：轨道角动量空间中秩为$k$的总单位张量算符的平方，即$(mathrm{U}^{(k)} cdot mathrm{U}^{(k)})$ - `TT_{k}.zdc`：自旋空间中秩为$k$的总单位张量算符的平方，即$(mathrm{T}^{(k)} cdot mathrm{T}^{(k)})$ - `UT_{k}.zdc`：轨道与自旋空间中秩为$k$的总单位张量算符的标量积，即$(mathrm{U}^{(k)} cdot mathrm{T}^{(k)})$ - `C_{k}_{q}.zdc`：秩为$k$的库仑算符（Coulomb operator）的$q$分量，即$mathrm{C}^{(k)}_q$ - `L_{q}.zdc`：总轨道角动量算符$mathrm{L}_q$的$q$分量 - `S_{q}.zdc`：总自旋角动量算符$mathrm{S}_q$的$q$分量 - `J_{q}.zdc`：总角动量算符$mathrm{J}_q$的$q$分量 - `LL.zdc`：总轨道角动量算符的平方$(mathrm{L} cdot mathrm{L})$，对应$alpha$ - `SS.zdc`：总自旋角动量算符的平方$(mathrm{S} cdot mathrm{S})$ - `JJ.zdc`：总角动量算符的平方$(mathrm{J} cdot mathrm{J})$ - `LS.zdc`：总轨道与自旋角动量算符的标量积$(mathrm{L} cdot mathrm{S})$ - `C2.zdc`：特殊群$G_2$的卡西米尔算符（Casimir operator）$mathrm{C}_2(G_2)$，对应$eta$ - `CR.zdc`：$2l+1$维特殊正交（旋转）群的卡西米尔算符$mathrm{C}_2(mathrm{SO}(2l+1))$，对应$gamma$ - `H1_{k}.zdc`：秩为$k$的库仑一级微扰哈密顿量（perturbation Hamiltonian），即$mathrm{f}_k$（或$F^k$） - `H2.zdc`：自旋-轨道一级微扰哈密顿量，即$mathrm{z}$（或$zeta$） - `H4_{c}.zdc`：有效库仑二级微扰哈密顿量，即$mathrm{t}_c$（或$T^c$） - `Hss_{k}.zdc`：秩为$k$的自旋-自旋一级微扰哈密顿量，即$mathrm{m}_{k,ss}$ - `Hsoo_{k}.zdc`：秩为$k$的自旋-其他轨道一级微扰哈密顿量，即$mathrm{m}_{k,soo}$ - `H5_{k}.zdc`：秩为$k$的自旋-自旋与自旋-其他轨道一级微扰哈密顿量，即$mathrm{m}_k$（或$M^k$） - `H6_{k}.zdc`：秩为$k$的有效静电自旋-轨道二级微扰哈密顿量，即$mathrm{p}_k$（或$P^k$） - `Hcf_{k}_{q}.zdc`：秩为$k$的晶体场微扰哈密顿量的$q$分量，即$mathrm{H}_{mathrm{cf},q}^{(k)}$（或$B^k_q$） 包含约化矩阵元的矩阵组的文件名中省略了分量后缀$_{q}$。约化矩阵元是由维格纳-埃克特定理（Wigner-Eckart theorem）引入的概念，用于描述任意球张量算符$mathrm{A}^{(k)}$的角向行为： $$ langle J' M' | mathrm{A}^{(k)}_{q} | J M angle = (-1)^{J'-M'} egin{pmatrix} J' & k & J \ -M' & q & M end{pmatrix} langle J' || mathrm{A}^{(k)} || J angle $$ ## 态表示 每个矩阵数据容器的JSON文件data/matrix.json中包含所有态的量子数。对于乘积态，这些量子数为每个电子的$n$、$l$、$m_l$、$s$与$m_s$；LS耦合态则通过不可约表示进行表征，在大多数情况下，这些不可约表示与特定张量算符的本征值相关联。 ### 关键不可约表示相关张量算符 1. $S^2$：多重度$2S+1$，由总自旋平方算符$(mathrm{S} cdot mathrm{S})$的本征值$S(S+1)$推导得到 2. $C_7$三重态$W=(w_1,w_2,w_3)$：7维特殊正交群的卡西米尔算符$mathrm{C}_2(mathrm{SO}(7))$ 3. $C_2$二重态$U=(u_1,u_2)$：特殊群$G_2$的卡西米尔算符$mathrm{C}_2(G_2)$ 4. $L^2$：$L$的谱特征，由总轨道角动量平方算符$(mathrm{L} cdot mathrm{L})$的本征值$L(L+1)$推导得到 5. $J^2$：量子数$J$，由总角动量平方算符$(mathrm{J} cdot mathrm{J})$的本征值$J(J+1)$推导得到 6. $J_z$：本征值$M_J$，对应总角动量算符的轴向分量$mathrm{J}_0$ 7. $mathrm{sen}$：资历数（seniority number）$ u$，由算符$(mathrm{S} cdot mathrm{S})$与$mathrm{C}_2(mathrm{SO}(7))$表征 8. $mathrm{num}$：具有相同量子数$L$和$S$的不同态的索引 9. $ au$：具有相同量子数集合的不同态的索引$ au$ ## 版本历史 本数据集采用语义化版本号规范进行发布，版本格式为「主版本号.次版本号.修订号」，初始版本为1.0.0。修订号递增对应仅更新数据集元数据但未修改包含文件的版本；次版本号递增对应修改了包含文件的数据集发布，但仅为数据容器中元数据的非功能性修改，例如更新或修正数据容器元数据中的标题与描述，或新增元数据属性；主版本号递增对应数据容器的功能性修改或新增张量算符。 ### 版本1.0.0 初始发布版本。 ### 版本2.0.0 将$J$多重态内的专有符号修正替换为阶梯算符；新增库仑算符；新增晶体场算符。 ### 版本3.0.0 修复了$mathrm{Hcf}_{k,0}$矩阵（错误的因子2修正）。