MARock

class openpnm.io.MARock[source]

Bases: openpnm.io.GenericIO.GenericIO

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).

classmethod import_data(path, voxel_size=1, project=None)[source]

Load data from a 3DMA-Rock extracted network. 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.

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

  • network (OpenPNM Network Object) – If an Network object is recieved, this method will add new data to it but NOT overwrite anything that already exists. This can be used to append data from different sources.

  • 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.

  • project (OpenPNM Project object) – A GenericNetwork is created and added to the specified Project. If no Project is supplied then one will be created and returned.

classmethod load(*args, **kwargs)[source]

This method is being deprecated. Use import_data instead.