f2py编译Fortran代码:直调子程序可用、封装为module后调用报属性缺失问题
问题根因
当Fortran子程序被封装进module结构后,f2py的默认导出规则会导致命名空间嵌套,这是你遇到AttributeError的核心原因:
- 独立全局子程序没有所属的Fortran模块,f2py会直接将其导出到最终生成的Python模块顶层,因此你原来的调用逻辑完全正常。
- 挂载在module内部的子程序,f2py默认会把整个Fortran模块作为同名属性挂载到Python模块下,子程序不会自动提升到顶层。
- 你的测试代码中,Fortran源码里的模块名
pymod和要生成的Python模块名完全一致,最终生成的模块结构实际是:
顶层Python模块
pymod
└── 对应Fortran源码的pymod模块对象
└── 实际的simple_lin_fit子程序
你直接调用pymod.simple_lin_fit时,自然会因为顶层模块下不存在这个属性而报错。
修复方法
1. 编写符合要求的Fortran模块代码
将原来的独立子程序完整嵌入到Fortran module中,完整代码如下:
! pymod.f90 module pymod implicit none contains subroutine simple_lin_fit(x_data, y_data, N, a, b, sa, sb, r_squared, sigma) implicit none integer, intent(in) :: N real(kind = 8), dimension(N) , intent(in) :: x_data, y_data real(kind = 8), intent(out) :: a, b, sa, sb, r_squared, sigma real(kind = 8) :: sum_x, sum_xx, sum_xy, sum_y, sum_yy, SSE, SXX, SXY, SYY sum_x = sum(x_data) sum_y = sum(y_data) sum_xx = sum(x_data**2) sum_yy = sum(y_data**2) sum_xy = sum(x_data*y_data) SXY = sum_xy - sum_x*sum_y/N SXX = sum_xx - sum_x**2/N SYY = sum_yy - sum_y**2/N a = SXY/SXX b = (sum_y - a*sum_x)/N SSE = sum((y_data-a*x_data-b)**2) sigma = sqrt(SSE/(N-2)) r_squared = 1 - SSE/SYY sa = sigma/sqrt(SXX) sb = sa*sqrt(sum_xx/N) end subroutine simple_lin_fit end module pymod
2. 调整f2py编译命令
原来的简化编译命令默认会生成嵌套命名空间,需要通过f2py的符号指定语法,明确把模块内的子程序提升到Python模块顶层,正确的编译命令为:
f2py3 -m pymod -c pymod.f90 only: simple_lin_fit : pymod
命令参数说明:
only: simple_lin_fit:指定需要导出的符号名称,后续如果在module中新增其他子程序,只要把对应子程序名追加到这里即可: pymod:告知f2py上述要导出的符号,来自源码中名为pymod的Fortran模块
3. 验证模块结构
编译完成生成动态库后,先不要直接运行业务代码,在Python中执行以下命令验证导出是否正常:
import pymod print(dir(pymod))
只要输出的属性列表中直接出现simple_lin_fit,就说明导出成功,原来的Python测试代码可以直接正常运行。
后续开发注意事项
- 如果项目中需要引入其他依赖的Fortran模块,只要把这些依赖的源码文件按顺序加到编译命令的源文件列表中,f2py会自动处理模块间的依赖关系。比如依赖公共模块
common.f90的编译命令为:f2py3 -m pymod -c common.f90 pymod.f90 only: simple_lin_fit : pymod - 尽量不要让Fortran源码中的模块名和最终生成的Python模块名完全不做区分,如果不想写导出指定语句,也可以通过修改Fortran模块名的方式规避嵌套问题,但这需要调整Python侧的调用路径,不如直接用导出指定的方式兼容原有调用逻辑。
- 编译时如果没有指定导出规则,即使编译流程全程无报错,也可能出现符号未导出、命名空间嵌套的问题,不要默认认为无报错就代表导出完全符合预期。
内容的提问来源于stack exchange,提问作者Eric Cardozo
相关产品推荐
相关产品推荐

