lens

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

Calculates the volume residing the hemispherical caps formed by the intersection between cylindrical throats and spherical pores.

This volume should be subtracted from throat volumes if the throat lengths were found using throat end points.

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.

See also

pendular_ring