Skip to main content

A framework for conducting pore network modeling simulations of multiphase transport in porous materials

Project description


VERSION 3.0 of OpenPNM is now out. All the examples on the website are now using the features and idioms of V3. For a description of the main changes please see our recent blog post.

Overview of OpenPNM

OpenPNM is a comprehensive framework for performing pore network simulations of porous materials.

More Information

For more details about the package can be found in the online documentation

Installation and Requirements

pip

OpenPNM can be installed using pip by running the following command in a terminal:

pip install openpnm

conda-forge

OpenPNM can also be installed from the conda-forge repository using:

conda install -c conda-forge openpnm

[!WARNING]
For compatibility with ARM64 architecture, we removed pypardiso as a hard dependency. However, we still strongly recommend that non-macOS users (including users of older Macs with an Intel CPU) manually install pypardiso via pip install pypardiso or conda install -c conda-forge pypardiso, otherwise OpenPNM simulations will be very slow.

For developers

For developers who intend to change the source code or contribute to OpenPNM, the source code can be downloaded from Github and installed by running:

pip install -e 'path/to/downloaded/files'

The advantage to installing from the source code is that you can edit the files and have access to your changes each time you import OpenPNM.

OpenPNM requires the Scipy Stack (Numpy, Scipy, Matplotlib, etc), which is most conveniently obtained by installing the Anaconda Distribution.

Asking Questions and Getting Help

Github now has a Discussions function, which works similarly to stack overflow. Please post your question in the Q&A category so devs or users can provide answers, vote on accepted answers, improve on each other's answers, and generally discuss things. Most importantly, all answers are searchable so eventually, once enough questions have been posted and answered, you can find what you're looking for with a simple search.

Contact

OpenPNM is developed by the Porous Materials Engineering and Analysis Lab (PMEAL), in the Department of Chemical Engineering at the University of Waterloo in Waterloo, Ontario, Canada.

The lead developer for this project is Prof. Jeff Gostick (jgostick@gmail.com).

Acknowledgements

OpenPNM is grateful to CANARIE for their generous funding over the past few years. We would also like to acknowledge the support of NSERC of Canada for funding many of the student that have contributed to OpenPNM since it's inception in 2011.

Citation

If you use OpenPNM in a publication, please cite the following paper:

Gostick et al. "OpenPNM: a pore network modeling package." Computing in Science & Engineering 18, no. 4 (2016): 60-74. doi:10.1109/MCSE.2016.49

Also, we ask that you "star" :star: this repository so we can track the number of users who are interested in this project, which is helpful for securing future grant funding.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

openpnm-3.5.0.tar.gz (220.9 kB view details)

Uploaded Source

Built Distribution

openpnm-3.5.0-py3-none-any.whl (304.5 kB view details)

Uploaded Python 3

File details

Details for the file openpnm-3.5.0.tar.gz.

File metadata

  • Download URL: openpnm-3.5.0.tar.gz
  • Upload date:
  • Size: 220.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.0 CPython/3.12.4

File hashes

Hashes for openpnm-3.5.0.tar.gz
Algorithm Hash digest
SHA256 1b92c825530324dbccf792378102bf167250246cf7c3a6f9a4220fe3346cf66c
MD5 77e014236d795e602bc5e121ccf3f8e7
BLAKE2b-256 05f2e4ec3d56c6d99ded4ba081ab78b50a16efa22f7b82f5abdccee163fbbd00

See more details on using hashes here.

File details

Details for the file openpnm-3.5.0-py3-none-any.whl.

File metadata

  • Download URL: openpnm-3.5.0-py3-none-any.whl
  • Upload date:
  • Size: 304.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.0 CPython/3.12.4

File hashes

Hashes for openpnm-3.5.0-py3-none-any.whl
Algorithm Hash digest
SHA256 6fa0e9397e6c1a42c0d7fc700cc0c2c103b23a42db252b7712362e707e60019d
MD5 71065244bfcbfe9c5b61dd0394816c77
BLAKE2b-256 c56f348b92b839cf5e55ab87891ea2f93a91e0fb97172a58b0224234584fbf20

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page