Poromics documentation

What is Poromics?

Poromics is an open-source Python package for estimation of transport properties of 2D/3D images of porous materials. The main design philosophies driving Poromics are speed and ease of use. Poromics is developed alongside the Julia library Tortuosity.jl, which serves as its tortuosity simulation engine.

The goal is to support more transport properties in the future such as permeability, transient tortuosity, etc. Poromics is GPU-compatible right out of the box, which can significantly speed up the calculations for large images (up to 50x speedup).

A typical workflow for estimating tortuosity. The user loads a 2D/3D image of a porous material and specifies an axis. Poromics then performs a steady-state diffusion simulation along the specified axis to compute the tortuosity from the concentration profile ¹.

Roadmap

• Add support for more transport properties
  • Diffusional tortuosity
  • Electrode tortuosity
  • Transient tortuosity
  • Permeability
• Add command-line interface (CLI) for easy usage
• Add support for sysimage creation upon installation for faster startup

Contributing

We welcome contributions to Poromics! If you have any ideas, suggestions, or bug reports, please open an issue or submit a pull request. For more information on how to contribute, please refer to the contributing guide, or simply open an issue or a pull request on GitHub.

---

1. Image from: Fu, J., Thomas, H. R., & Li, C. (2021). Tortuosity of porous media: Image analysis and physical simulation. Earth-Science Reviews, 212, 103439. (Figure 9) ↩