通过 numpy.distutils 使用#

Legacy

这个子模块被认为是遗产,将不再接收更新.这也可能意味着它将在未来的 NumPy 版本中被移除.``distutils`` 已被 meson 取代,请参见 numpy.distutils 的状态和迁移建议.

numpy.distutils 是 NumPy 的一部分,并扩展了标准的 Python distutils 模块,以处理 Fortran 源代码和 F2PY 签名文件,例如编译 Fortran 源代码,调用 F2PY 构建扩展模块等.

对 distutils 的扩展#

numpy.distutils 使用以下功能扩展了 distutils:

  • Extension 类参数 sources 可以包含 Fortran 源文件.此外,列表 sources 最多可以包含一个 F2PY 签名文件,在这种情况下,扩展模块的名称必须与签名文件中使用的 <modulename> 匹配.假设 F2PY 签名文件恰好包含一个 python module 块.

    如果 sources 不包含签名文件,则使用 F2PY 扫描 Fortran 源文件以构建对 Fortran 代码的包装器.

    可以通过 Extension 类参数 f2py_options 提供给 F2PY 可执行文件的附加选项.

  • 以下定义了新的 distutils 命令:

    build_src

    构建 Fortran 包装器扩展模块,以及其他许多事情.

    config_fc

    更改 Fortran 编译器选项.

    此外,``build_ext`` 和 build_clib 命令也被增强以支持 Fortran 源代码.

    运行

    python <setup.py file> config_fc build_src build_ext --help

    查看这些命令的可用选项.

  • 在构建包含 Fortran 源代码的 Python 包时,可以通过使用 build_ext 命令选项 --fcompiler=<Vendor> 选择不同的 Fortran 编译器.这里的 <Vendor> 可以是以下名称之一（在 linux 系统上）:

    absoft compaq fujitsu g95 gnu gnu95 intel intele intelem lahey nag nagfor nv pathf95 pg vast

    请参阅 numpy_distutils/fcompiler.py 以获取支持的不同平台编译器的最新列表,或运行

    python -m numpy.f2py -c --backend distutils --help-fcompiler
On this page