安装

运行环境与文档构建环境是两回事。运行计算需要 Python 数值库及 pygrnwang 提供的 Fortran 可执行程序；仅构建 HTML 不需要这些程序。

安装程序

本地项目元数据要求 Python 3.9 及以上、 pygrnwang>=3.0.0 和 matplotlib>=3.9.2。

python -m pip install dyncfs
python -c "import dyncfs; print(dyncfs.__version__)"
dyncfs --help

导入成功只能证明 Python 接口可用。请通过快速开始 检查一次实际静态计算。

使用本地源码

将兼容的 pygrnwang 3.x 源码和 dyncfs 放在同一个父目录。 从该父目录运行：

conda create -n cfs -c conda-forge python=3.12 numpy scipy pandas obspy tqdm matplotlib
conda activate cfs
conda install -c conda-forge gfortran
python -m pip install -e ./pygrnwang
python -m pip install -e ./dyncfs
cd dyncfs

编译器和各平台的具体要求以对应 pygrnwang 源码中的安装说明为准。 安装匹配的二进制 wheel 可能不需要编译；从源码构建则需要 Fortran 工具链。

Windows 注意事项

保持 Conda 环境激活，或在自动化命令中使用：

conda run -n cfs python docs/examples/quickstart.py

不要直接调用未激活环境下的 python.exe，否则可能缺少数值库依赖的 DLL。 确认所需的 edgrn2.exe、edcmp2.exe、qseis2025.exe 或 qssp2020.exe 可被当前环境找到。

INI 中使用较短的绝对路径，Windows 可以写成 C:/work/case/input，不要额外添加引号。 相对路径以运行目录为基准，不以 INI 所在目录为基准。

动态本机并行不要求 MPI。走时通过 pygrnwang 的 Java 子进程或 ObsPy 后端计算。GIF 功能还需要单独安装 imageio。

本地构建文档

使用 Python 3.12 安装 docs/requirements.txt 后：

python docs/api/check_coverage.py
python -m sphinx -b html -W --keep-going docs docs/_build/html
python -m http.server 8000 --bind 127.0.0.1 --directory docs/_build/html

浏览器访问 http://127.0.0.1:8000/，或直接打开 docs/_build/html/index.html。完整环境说明见文档维护。