F2PY 用户指南和参考手册#
F2PY(Fortran to Python interface generator,Fortran 到 Python 接口生成器)实用工具的目的是在 Python 和 Fortran 之间提供连接。F2PY 作为 NumPy (numpy.f2py)的一部分分发,安装后也可以作为独立的命令行工具使用。最初由 Pearu Peterson 创建,较旧的变更日志可在 历史参考 中找到。
F2PY 促进创建/构建原生的 Python C/API 扩展模块,这些模块使得
能够调用 Fortran 77/90/95 外部子程序和 Fortran 90/95 模块子程序以及 C 函数;
能够从 Python 访问 Fortran 77
COMMON块和 Fortran 90/95 模块数据,包括可分配数组
从 Python 访问。
注意
Fortran 77 基本上功能完整,F2PY 中支持的现代 Fortran 数量也在不断增加。大多数 iso_c_binding 接口都可以使用 f2py 自动编译为本地扩展模块。欢迎报告 Bug!
F2PY 可以用作命令行工具 f2py,也可以用作 Python 模块 numpy.f2py。虽然我们尝试将命令行工具作为 numpy 设置的一部分提供,但某些平台(如 Windows)很难可靠地将可执行文件放在 PATH 中。如果您的系统中 f2py 命令不可用,您可能需要将其作为模块运行
python -m numpy.f2py
如果您在系统中拥有多个安装了 NumPy 的 Python(非虚拟环境),并且想确保使用特定的 Python/F2PY 版本,那么使用 python -m 调用也是一种好习惯。
如果您在不带参数的情况下运行 f2py,并且末尾的 numpy Version 行与从 python -m numpy.f2py 打印的 NumPy 版本匹配,那么您可以使用较短的版本。否则,或者如果您无法运行 f2py,您应该在本指南中将所有对 f2py 的调用替换为较长的版本。
有关 Meson 构建的示例,请参阅 使用 F2PY。