f2py-jit 0.8.4

No project description provided

f2py-jit

Just-in-time compilation of Fortran code in Python via f2py.

Documentation

• Tutorial
• Public API

Quick start

Start from a piece of Fortran code.f90

subroutine hello()
  print*, "Hello world!"
end subroutine

Compile the code, import it and execute it

from f2py_jit import jit
f90 = jit('code.f90')
f90.hello()

Do the same but from a python string containing the source block

source = """
subroutine hello()
  print*, "Hello world!"
end subroutine
"""
f90 = jit(source)
f90.hello()

If the Fortran source contains multiple subroutines calling each other, f2py will not perform interprocedural optimizations (at least not by default). f2py_jit can inline the source code before compiling it, and you will get a performace boost [This feature is experimental]

f90 = jit('code.f90', inline=True)

Features

• Compilation of source blocks as python strings
• Caching of module builds across executions
• Optional inlining to improve performance (experimental)

Dependencies

• numpy
• Fortran compiler

Installation

From pip

pip install f2py-jit

From source

git clone https://framagit.org/coslo/f2py-jit.git
cd f2py_jit
make install

Credits

Part of this code is adapted from numpy.f2py module by Pearu Peterson, in accordance with the NumPy license.

Authors

Daniele Coslovich: https://www.units.it/daniele.coslovich/