Skip to content

fefafe/porescene

Repository files navigation

PoreScene

DOI PyPI Python License Docs Release

PoreScene is a Blender-based scientific visualization toolkit for porous media. It renders tomographic images, generated and reconstructed pore networks, as well as volume tessellations as photorealistic 3D scenes – with pores, throats, Voronoi cells, and watershed clusters colored by properties such as radius or coordination number using perceptually uniform colormaps, matching colorbars, and calibrated, on-scale axes.

The advantage: instead of clicking through a 3D editor, you describe the entire scene in a few lines of Python and render it reproducibly on Blender's GPU-accelerated Cycles engine – so the same script always yields the same publication-quality figure, ready for papers, presentations, and animations.

Installation

pip install porescene

More detailed instructions are provided in the documentation.

Citation

If you use PoreScene to generate figures for a publication, please cite it. Citation metadata is provided in CITATION.cff, and the software is archived on Zenodo under a version-independent concept DOI that always resolves to the latest release. You can use the BibTeX entry below:

@software{porescene,
  author = {Faber, Felix and Vorhauer-Huget, Nicole},
  title  = {{PoreScene}},
  year   = {2026},
  doi    = {10.5281/zenodo.21494378},
  url    = {https://github.com/fefafe/porescene},
}

Funding

This work was funded by the Deutsche Forschungsgemeinschaft (DFG, German Research Foundation) – Project-ID 422037413 – TRR 287.

About

Blender-based Python toolkit for reproducible, publication-quality 3D visualization of porous media – tomographic images, pore networks, and tessellations.

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages