OpenImpala Documentation

OpenImpala is a high-performance framework for computing effective transport properties (diffusivity, conductivity, tortuosity) directly on 3D voxel images of porous microstructures.

It solves steady-state transport equations on the voxel grid using finite differences, parallelised via MPI through the AMReX library, with HYPRE or AMReX MLMG for linear solves.

import numpy as np
import openimpala as oi

data = np.random.choice([0, 1], size=(64, 64, 64), dtype=np.int32)

with oi.Session():
    result = oi.tortuosity(data, phase=1, direction="z")
    print(f"Tortuosity: {result.tortuosity:.4f}")

Install from PyPI

pip install openimpala

GPU acceleration is automatic when CuPy is installed. For HPC clusters needing compiled HYPRE solvers, see openimpala-cuda in the Getting Started guide.

Development

Indices and tables