f90wrap技术文档

1. 安装指南

f90wrap可以通过以下方式安装：

• 使用pip安装最新稳定版本：

  pip install f90wrap
  

• 使用conda安装：

  conda install -c conda-forge f90wrap
  

• 对于开发版本，可以使用以下命令：

  pip install git+https://github.com/jameskermode/f90wrap
  

如果您的Fortran 90编译器具有非标准名称（例如gfortran-9），则在安装f90wrap之前需要设置F90环境变量，以确保它使用正确的编译器：

F90=gfortran-9 pip install f90wrap

2. 项目的使用说明

f90wrap是一个自动生成Python扩展模块的工具，这些模块可以与使用派生类型的Fortran代码接口。它基于流行的f2py工具，生成更简单的Fortran 90接口，然后适合与f2py一起使用，同时提供了一个高级的Python封装器，使得最终用户对额外层的存在透明。

使用f90wrap对一组Fortran 90源文件进行包装并生成适合输入到f2py的包装器的命令如下：

f90wrap -m MODULE F90_FILES

其中MODULE是您想要生成的Python模块的名称，F90_FILES是包含您希望通过Python暴露的模块、类型和子例程的Fortran 90源文件列表。

3. 项目API使用文档

f90wrap生成的Python扩展模块的使用与标准Python模块类似。以下是一个简单的示例：

import f90wrap_module  # 假设这是f90wrap生成的模块

# 调用Fortran代码中的函数
result = f90wrap_module.my_fortran_function(input_array)

具体的API使用方法将取决于生成的模块和Fortran代码中暴露的函数和子例程。

4. 项目安装方式

项目的安装方式已在安装指南部分详细说明。简要概括如下：

• 使用pip安装稳定版本。
• 使用conda从conda-forge通道安装。
• 通过pip安装开发版本，直接从GitHub仓库获取最新代码。

确保在安装前设置了正确的Fortran编译器环境变量，如果编译器名称非标准，则需要指定。