tortuosity

tortuosity(im, axis, return_im=False, **kwargs)[source]

Calculates tortuosity of given image in specified direction

Parameters
  • im (ndarray) – The binary image to analyze with True indicating phase of interest

  • axis (int) – The axis along which to apply boundary conditions

  • return_im (boolean) – If True then the resulting tuple contains a copy of the input image with the concentration profile.

Returns

results

A named-tuple containing:
  • tortuosity: calculated using the effective_porosity as \(\tau = \frac{D_{AB}}{D_{eff}} \cdot \varepsilon\).

  • effective_porosity: of the image after applying trim_nonpercolating_paths. This removes disconnected voxels which cause singular matrices.

  • original_porosity: of the image as given

  • formation_factor: found as \(D_{AB}/D_{eff}\).

  • image: containing the concentration values from the simulation. This is only returned if return_im is True.

Return type

tuple