API 参考

本节提供完整的模块、类和函数接口文档。

核心模块

atomscf.grid
atomscf.operator
atomscf.scf
atomscf.scf_hf	Hartree-Fock SCF 实现
atomscf.hartree
atomscf.occupations
atomscf.utils

HF 子模块

atomscf.hf.slater	Slater 径向积分模块
atomscf.hf.angular	角动量耦合系数模块
atomscf.hf.exchange	HF 交换算子模块

交换-关联泛函

atomscf.xc.lda
atomscf.xc.vwn
atomscf.xc.constants	XC 常量集中维护

常用功能索引

网格生成

atomscf.grid.radial_grid_linear(n, rmin, rmax)	生成线性（等间隔）径向网格及其梯形积分权重。
atomscf.grid.radial_grid_log(n, rmin, rmax)	生成对数（几何）径向网格及其梯形积分权重。
atomscf.grid.radial_grid_exp_transformed(n, ...)	生成用于变量变换方法的指数网格。
atomscf.grid.radial_grid_mixed(n_inner, ...)	生成混合径向网格：核附近为对数网格，外层为线性网格。

HF 计算

atomscf.scf_hf.run_hf_minimal(cfg)	对 H 原子运行最小 HF 自洽：交换与 Hartree 相消，仅剩外势。
atomscf.scf_hf.run_hf_scf_s(cfg)	运行 s 轨道 HF SCF 计算。
atomscf.scf_hf.run_hf_scf(cfg)	运行通用 HF SCF 计算（支持 s, p 等多 l 通道）。

DFT 计算

atomscf.scf.run_lsda_x_only(cfg[, verbose, ...])	运行 LSDA X-only 的自洽场计算（球对称、径向）。
atomscf.scf.run_lsda_pz81(cfg[, verbose, ...])	运行 LSDA（Dirac 交换 + PZ81 关联）的自洽场计算，并给出能量分解。
atomscf.scf.run_lsda_vwn(cfg[, verbose, ...])	运行 LSDA（Dirac 交换 + VWN 关联）的自洽场计算，并给出能量分解。

方程求解器

atomscf.operator.solve_bound_states_fd(r, l, ...)	基于有限差分 Hamiltonian 的径向束缚态求解（取低端 \(k\) 个本征对）。
atomscf.operator.solve_bound_states_fd5(r, ...)	在等间距线性网格上使用五点有限差分求解径向束缚态（取低端 \(k\) 个本征对）。
atomscf.operator.solve_bound_states_transformed(r, ...)	使用变量变换方法求解径向束缚态（适用于指数网格）。

配置与结果类

HF 配置与结果

atomscf.scf_hf.HFConfig(Z, r, w[, tol, maxiter])	HF 最小实现配置（教学版，仅支持 H）。
atomscf.scf_hf.HFSCFGeneralConfig(Z, r, w, ...)	通用 HF SCF 配置（支持 RHF/UHF 和多 l 通道）。
atomscf.scf_hf.HFResult(converged, ...)	HF 最小实现结果容器（H 验证）。
atomscf.scf_hf.HFSCFGeneralResult(converged, ...)	通用 HF SCF 结果容器（支持 RHF/UHF）。

DFT 配置与结果

atomscf.scf.SCFConfig(Z, r, w[, lmax, ...])	SCF 配置参数。
atomscf.scf.SCFResult(converged, iterations, ...)	SCF 结果容器。