size_to_satn#
- size_to_satn(size, im=None, bins=None)[source]#
Converts an image of invasion size values into saturations.
This is meant to accept the output of the
porosimetry
function.- Parameters:
size (ndarray) – The image containing invasion size values in each voxel.
im (ndarray, optional) – A binary image of the porous media, with
True
indicating the void space andFalse
indicating the solid phase. If not given then it is assumed that the solid is identified assize == 0
.bins (array_like or int (optional)) – The bins to use when converting sizes to saturation. The default is to create 1 bin for each unique value in
size
. If an int is supplied it is interpreted as the number of bins between 0 and the maximum value insize
. If an array is supplied it is used as the bins directly.
- Returns:
satn – An ndarray the same size as
seq
but with sequence values replaced by the fraction of void space invaded at or below the sequence number. Solid voxels and uninvaded voxels are represented by 0 and -1, respectively.- Return type:
ndarray
Examples
Click here to view online example.