OpenPNM: A Pore Network Modeling Package

Pore network modeling is a widely used technique for simulating multiphase transport in porous materials, but there are very few software options available. This work outlines the OpenPNM package that was jointly developed by several porous media research groups to help address this gap. OpenPNM is written in Python using NumPy and SciPy for most mathematical operations, thus combining Python's ease of use with the performance necessary to perform large simulations. The package assists the user with managing and interacting with all the topological, geometrical, and thermophysical data. It also includes a suite of commonly used algorithms for simulating percolation and performing transport calculations on pore networks. Most importantly, it was designed to be highly flexible to suit any application and be easily customized to include user-specified pore-scale physics models. The framework is fast, powerful, and concise. An illustrative example is included that determines the effective diffusivity through a partially water-saturated porous material with just 29 lines of code.

[1]  Volker Schmidt,et al.  Random geometric graphs for modelling the pore space of fibre-based materials , 2011 .

[2]  Ioannis Chatzis,et al.  Modelling Pore Structure By 2-D And 3-D Networks With ApplicationTo Sandstones , 1977 .

[3]  W. V. Pinczewski,et al.  Invasion percolation: new algorithms and universality classes , 1999 .

[4]  Norman R. Morrow,et al.  Effect of contact angle on capillary displacement curvatures in pore throats formed by spheres , 1994 .

[5]  Mark Pritzker,et al.  Pore network modeling of fibrous gas diffusion layers for polymer electrolyte membrane fuel cells , 2007 .

[6]  K. Jarrod Millman,et al.  Python for Scientists and Engineers , 2011, Comput. Sci. Eng..

[7]  Markus Hilpert,et al.  Pore-morphology-based simulation of drainage in totally wetting porous media , 2001 .

[8]  Ioannis Chatzis,et al.  The modeling of mercury porosimetry and the relative permeability of mercury in sandstones using percolation theory , 1985 .

[9]  E. W. Washburn.  Note on a Method of Determining the Distribution of Pore Sizes in a Porous Material. , 1921, Proceedings of the National Academy of Sciences of the United States of America.

[10]  Robert Cimrman.  SfePy - Write Your Own FE Application , 2014, ArXiv.

[11]  G. Matthews,et al.  An improved simulation of void structure, water retention and hydraulic conductivity in soil with the Pore‐Cor three‐dimensional network , 2003 .

[12]  Eric Jones,et al.  SciPy: Open Source Scientific Tools for Python , 2001 .

[13]  Jacob Bear,et al.  On the Concept and Size of a Representative Elementary Volume (Rev) , 1987 .

[14]  Pierre M. Adler,et al.  Pore network modelling to determine the transport properties in presence of a reactive fluid: From pore to reservoir scale , 2013 .

[15]  Aric Hagberg,et al.  Exploring Network Structure, Dynamics, and Function using NetworkX , 2008, Proceedings of the Python in Science Conference.

[16]  Sally M. Benson,et al.  Microtomography and Pore-Scale Modeling of Two-Phase Fluid Distribution , 2011 .

[17]  S. M. Hassanizadeh,et al.  Analysis of Fundamentals of Two-Phase Flow in Porous Media Using Dynamic Pore-Network Models: A Review , 2012 .

[18]  Matthew D. Jackson,et al.  Detailed physics, predictive capabilities and macroscopic consequences for pore-network models of multiphase flow. , 2002 .

[19]  H. Giesche,et al.  Mercury Porosimetry: A General (Practical) Overview , 2006 .

[20]  Karsten E. Thompson,et al.  Pore-scale modeling of fluid transport in disordered fibrous materials , 2002 .

[21]  Martin J Blunt,et al.  Pore-network extraction from micro-computerized-tomography images. , 2009, Physical review. E, Statistical, nonlinear, and soft matter physics.

[22]  W Brent Lindquist,et al.  The geometry of primary drainage. , 2006, Journal of colloid and interface science.

[23]  M. Blunt.  Flow in porous media — pore-network models and multiphase flow , 2001 .

[24]  L. E. Scriven,et al.  Percolation theory of two phase flow in porous media , 1981 .

[25]  Cass T. Miller,et al.  Multiphase flow and transport modeling in heterogeneous porous media: challenges and approaches , 1998 .

[26]  Ali Q. Raeini,et al.  Modelling two-phase flow in porous media at the pore scale using the volume-of-fluid method , 2012, J. Comput. Phys..

[27]  Amir Raoof,et al.  PoreFlow: A complex pore-network model for simulation of reactive transport in variably saturated porous media , 2013, Comput. Geosci..

[28]  Vahid Joekar-Niasar,et al.  Network model investigation of interfacial area, capillary pressure and saturation relationships in granular porous media , 2010 .

[29]  Steven L. Bryant,et al.  Physically representative network models of transport in porous media , 1993 .

[30]  Travis E. Oliphant,et al.  Python for Scientific Computing , 2007, Computing in Science & Engineering.

[31]  William G. Gray,et al.  Paradoxes and Realities in Unsaturated Flow Theory , 1991 .

[32]  Ioannis Chatzis,et al.  Network modelling of pore structure and transport properties of porous media , 1993 .

[33]  Marc Prat,et al.  Scale effect and two-phase flow in a thin hydrophobic porous layer. Application to water transport in gas diffusion layers of proton exchange membrane fuel cells , 2009 .

[34]  Alkiviades C. Payatakes,et al.  Capillary pressure spectrometry: Toward a new method for the measurement of the fractional wettability of porous media , 2006 .

[35]  K. Pruess,et al.  TOUGH2 User's Guide Version 2 , 1999 .

[36]  Aimy Bazylak,et al.  Unstructured Pore Network Modeling with Heterogeneous PEMFC GDL Porosity Distributions , 2010 .

[37]  Marc Prat,et al.  Recent advances in pore-scale models for drying of porous media , 2002 .

[38]  Mark A. Knackstedt,et al.  SIMULATION OF MERCURY POROSIMETRY ON CORRELATED GRIDS : EVIDENCE FOR EXTENDED CORRELATED HETEROGENEITY AT THE PORE SCALE IN ROCKS , 1998 .

[39]  Adam Z. Weber,et al.  Effective diffusivity in partially-saturated carbon-fiber gas diffusion layers: Effect of local saturation and application to macroscopic continuum models , 2015 .

[40]  Allen G. Hunt,et al.  Basic transport properties in natural porous media: Continuum percolation theory and fractal model , 2005, Complex..

[41]  Gaël Varoquaux,et al.  The NumPy Array: A Structure for Efficient Numerical Computation , 2011, Computing in Science & Engineering.

[42]  Michael Moore,et al.  OpenFCST: An Open-Source Mathematical Modelling Software for Polymer Electrolyte Fuel Cells , 2014 .

[43]  Michael A. Celia,et al.  Recent advances in pore scale models for multiphase flow in porous media , 1995 .

[44]  Madalena M. Dias,et al.  Network models for two-phase flow in porous media Part 1. Immiscible microdisplacement of non-wetting fluids , 1986, Journal of Fluid Mechanics.

[45]  Jeff T. Gostick,et al.  Random Pore Network Modeling of Fibrous PEMFC Gas Diffusion Media Using Voronoi and Delaunay Tessellations , 2013 .

[46]  Michael A. Celia,et al.  A Functional Relationship Between Capillary Pressure, Saturation, and Interfacial Area as Revealed by a Pore‐Scale Network Model , 1996 .

[47]  C. Pan,et al.  Lattice‐Boltzmann simulation of two‐phase flow in porous media , 2004 .

[48]  M. Blunt,et al.  Pore-scale imaging and modelling , 2013 .

[49]  M. Sahimi.  Flow phenomena in rocks : from continuum models to fractals, percolation, cellular automata, and simulated annealing , 1993 .

[50]  Q RaeiniAli,et al.  Modelling two-phase flow in porous media at the pore scale using the volume-of-fluid method , 2012 .