Crate cryspglib 

cryspglib — Rust 晶体空间群识别库。

基于 spglib 的纯 Rust 移植， 提供晶体对称性分析、空间群识别、标准晶胞构造和 k 点网格生成。

主要入口

• spg_get_dataset — 获取完整空间群信息数据集
• spg_get_symmetry — 仅获取对称操作
• spg_standardize_cell — 获取理想化标准晶胞
• spg_find_primitive — 获取原胞

晶格矩阵约定

所有 3x3 矩阵采用 lattice[cart][vec] 布局（行=笛卡尔分量，列=晶格矢量）。 详见 mathfunc 模块文档。

Modules

arithmetic

整数算术与晶体学对称操作的组合规则。

cell

晶胞结构体和相关操作。

cof3_test

CoF₃ 空间群测试。

crps4_test

CrPS₄ 空间群测试。

debug

调试和日志输出工具。

delaunay

Delaunay 晶格约化。

determination

空间群确定的主流程。

hall_symbol

Hall 符号匹配。

kgrid

k 点网格生成。

kpoint

k 点地址生成。

la2nio4_test

La₂NiO₄ 空间群测试。

magnetic_spacegroup

磁性空间群识别。

mathfunc

3x3 矩阵和 3 维向量的基本运算（f64 和 i32）。

msg_database

磁性空间群数据库。

niggli

Niggli 晶格约化。

overlap

原子位置重叠检测。

pointgroup

primitive

原胞查找。

refinement

Bravais 格子精细化和精确结构确定。

site_symmetry

Wyckoff 位置的精确定位和对等原子分配。

sitesym_database

位点对称性数据库。

spacegroup

空间群搜索与识别。

spg_database

Automatically generated from spg_database.c DO NOT EDIT MANUALLY

spin

磁性对称性支持。

symmetry

对称操作检测。

Structs

SpglibDataset

空间群数据集的完整结构。

SpglibMagneticDataset

磁性空间群数据集。

SpglibMagneticSpacegroupType

磁性空间群类型（从数据库查询）。

SpglibMagneticSymmetry

磁空间群 + 对称操作的完整分析结果。

SpglibSpacegroupType

空间群类型信息（从数据库查询）。

Enums

MagneticType

磁性空间群类型。

SpglibError

spglib 错误码。

Constants

SPGLIB_COMMIT

Git 提交哈希

SPGLIB_MAJOR_VERSION

主版本号

SPGLIB_MICRO_VERSION

补丁版本号

SPGLIB_MINOR_VERSION

次版本号

SPGLIB_VERSION

版本字符串

SPGLIB_VERSION_FULL

完整版本字符串（含构建信息）

Functions

spg_delaunay_reduce

Delaunay 晶格约化。

spg_find_primitive

寻找原胞。

spg_format_magnetic_symmetry

将 SpglibMagneticSymmetry 格式化为可读文本（类似 phonopy –symmetry 风格）。

spg_get_commit

获取 Git 提交哈希。

spg_get_dataset

识别晶体的空间群。

spg_get_dataset_with_hall_number

获取空间群数据集（指定 Hall 编号）。

spg_get_dense_BZ_grid_points_by_rotations

通过旋转矩阵获取 BZ 网格点。

spg_get_dense_grid_points_by_rotations

通过旋转矩阵获取密集网格点。

spg_get_dense_ir_reciprocal_mesh

获取不可约倒易网格（密集版本，使用 usize 映射表）。

spg_get_error_message

获取错误码对应的消息。

spg_get_grid_point_from_address

从网格地址获取网格点索引。

spg_get_hall_number_from_symmetry

从对称操作确定 Hall 编号。

spg_get_international

获取空间群的国际符号。

spg_get_ir_reciprocal_mesh

获取不可约倒易网格。

spg_get_layer_dataset

获取层状空间群数据集。

spg_get_magnetic_dataset

从晶格 + 原子位置 + 磁矩分析磁空间群和对称操作。

spg_get_magnetic_spacegroup_type

获取磁性空间群类型。

spg_get_magnetic_spacegroup_type_from_symmetry

获取磁性空间群类型（从对称操作）。

spg_get_major_version

获取主版本号。

spg_get_micro_version

获取补丁版本号。

spg_get_minor_version

获取次版本号。

spg_get_multiplicity

获取对称操作的多重数（即对称操作的个数）。

spg_get_pointgroup

获取点群信息。

spg_get_schoenflies

获取空间群的 Schoenflies 符号。

spg_get_spacegroup_type

根据 Hall 编号获取空间群类型信息。

spg_get_spacegroup_type_from_symmetry

从对称操作确定空间群类型。

spg_get_stabilized_reciprocal_mesh

获取稳定化倒易网格（给定对称操作和 q 点）。

spg_get_symmetry

获取对称操作（旋转矩阵和分数平移）。

spg_get_symmetry_from_database

从空间群数据库获取对称操作。

spg_get_version

获取 spglib 版本字符串。

spg_get_version_full

获取完整版本字符串。

spg_niggli_reduce

Niggli 晶格约化。

spg_read_structure

从类似 POSCAR 的格式解析结构（含可选磁矩）。

spg_refine_cell

精细化晶胞。

spg_relocate_BZ_grid_address

将网格点重新定位到第一布里渊区。

spg_standardize_cell

标准化晶胞。

spgat_find_primitive

寻找原胞（带角度容差）。

spgat_get_dataset

获取空间群数据集（带角度容差）。

spgat_get_dataset_with_hall_number

获取空间群数据集（指定 Hall 编号，带角度容差）。

spgat_get_international

获取空间群的国际符号（带角度容差）。

spgat_get_multiplicity

获取对称操作的多重数（带角度容差）。

spgat_get_schoenflies

获取空间群的 Schoenflies 符号（带角度容差）。

spgat_get_symmetry

获取对称操作（带角度容差）。

spgat_refine_cell

精细化晶胞（带角度容差）。

spgat_standardize_cell

标准化晶胞（带角度容差）。