pendular_ring¶

openpnm.models.geometry.throat_volume.pendular_ring(target, throat_diameter='throat.diameter', pore_diameter='pore.diameter')[source]¶

Calculates the volume of the pendular rings residing between the end of a cylindrical throat and spherical pores that are in contact but not overlapping.

This volume should be added to the throat volume if the throat length was found as the center-to-center distance less the pore radii.

Parameters

target (OpenPNM Base object) – Object with which this model is associated. This controls the length of the calculated array, and also provides access to other necessary properties.
throat_diameter (str) – Name of the dictionary key on target where the array containing pore diameter values is stored
pore_diameter (str) – Name of the dictionary key on target where the array containing pore diameter values is stored

Returns

volumes – A numpy ndarray containing throat volume values

Return type

ndarray

Notes

This model does not consider the possibility that multiple throats might overlap in the same location which could happen if throats are large and connectivity is random.