Poromics is a set of tools for rapid estimation of transport properties of 3D images of porous materials. It is designed to be fast and easy to use. Currently, it can predict the tortuosity factor of an image. The goal is to support more transport properties in the future such as permeability. Poromics is optionally GPU-accelerated, which can significantly speed up the calculations for large images (up to 100x speedup).
Poromics depends on the Julia package Tortuosity.jl. However, it is not necessary to install Julia separately. The package will be installed automatically when you install poromics.
Note
We highly recommend using uv instead of pip to install poromics (or any other Python package!) as it's extremely faster. It has lots of useful features, but for all practical purposes, it is a drop-in replacement for pip.
Install uv, and then run the following command in a terminal/command prompt:
uv pip install poromicsIf you prefer to use pip, run the following command in a terminal/command prompt:
pip install poromicsNote
The first time you import poromics, it will take a few minutes to install Julia and the required packages. This is a one-time setup.
import porespy as ps
import poromics
im = ps.generators.blobs(shape=[100, 100, 1], porosity=0.6) # Test image
result = poromics.tortuosity_fd(im, axis=1, rtol=1e-5, gpu=True)
print(result)The Result object is a simple container with the following attributes:
im: The tortuosity factor of the image.axis: The axis along which the tortuosity was calculated.tau: The tortuosity factor.c: The concentration field.
Warning
The CLI is still in development and not yet functional.
poromics --help- Speed up matrix assembly by direct assembly on GPU.
- Create Julia sysimage files upon installation for faster startup.
- Add more transport properties (e.g. permeability).
- Add CLI support.