network_from_marock(filename, voxel_size=1)[source]#

Load data from a 3DMA-Rock extracted network.

  • filename (str) – The location of the ‘np2th’ and ‘th2np’ files. This can be an absolute path or relative to the current working directory.

  • voxel_size (scalar) – The resolution of the image on which 3DMA-Rock was run, in terms of the linear length of eac voxel. The default is 1. This is used to scale the voxel counts to actual dimension. It is recommended that this value be in SI units [m] to work well with OpenPNM.


network – An OpenPNM Network dictionary

Return type:



This format consists of two files: ‘rockname.np2th’ and ‘rockname.th2pn’. They should be stored together in a folder which is referred to by the path argument. These files are binary and therefore not human readable.


3DMA-Rock is a network extraction algorithm developed by Brent Lindquist and his group

It uses Medial Axis thinning to find the skeleton of the pore space, then extracts geometrical features such as pore volume and throat cross-sectional area.

[1] Lindquist, W. Brent, S. M. Lee, W. Oh, A. B. Venkatarangan, H. Shin,

and M. Prodanovic. “3DMA-Rock: A software package for automated analysis of rock pore structure in 3-D computed microtomography images.” SUNY Stony Brook (2005).