apply_padded#

Applies padding to an image before passing through specified function

import numpy as np
import porespy as ps
import scipy.ndimage as spim
import matplotlib.pyplot as plt
import skimage
from edt import edt
ps.visualization.set_mpl_style()

im#

Generate a test image. Can be 2D or 3D image.

im = np.zeros([300, 300])
im = ps.generators.rsa(im, r=20, volume_fraction=0.4) == 0

plt.figure(figsize=[6, 6])
plt.axis(False)
plt.imshow(im);

/tmp/ipykernel_2781/1290140162.py:2: DeprecationWarning: Call to deprecated function (or staticmethod) rsa. (This function will be renamed random_spheres in a future version)
  im = ps.generators.rsa(im, r=20, volume_fraction=0.4) == 0
../../../_images/6b32ddc698d1c07d118657bad23075e2fdd55361a1024f6b85f7c2b2aa79cef8.png

func#

A good use case is skeletonize_3d, which has edge artifacts that can be reduced if the image is pre-padded. It works on 2D or 3D images.

func = skimage.morphology.skeletonize_3d

pad_width#

The amount of padding to add to each axis

x1 = ps.filters.apply_padded(im=im, pad_width=1, func=func, pad_val=1)
x2 = ps.filters.apply_padded(im=im, pad_width=100, func=func, pad_val=1)

fig, ax = plt.subplots(1, 2, figsize=[12, 12]);
ax[0].imshow(x1);
ax[0].axis(False)
ax[0].set_title('pad_width = 1')
ax[1].imshow(x2);
ax[1].axis(False)
ax[1].set_title('pad_width = 100');
../../../_images/dc3e28c444b1c84d5fc2b8b0cebc7110e856a26c03fc9272959ab3cfdcdc32db.png

It’s also useful for morphological operations such as binary_opening

func = skimage.morphology.binary_opening

x3 = ps.filters.apply_padded(im=im, pad_width=0, func=func, pad_val=1, footprint=ps.tools.ps_disk(15))
x4 = ps.filters.apply_padded(im=im, pad_width=50, func=func, pad_val=1, footprint=ps.tools.ps_disk(15))

fig, ax = plt.subplots(1, 2, figsize=[12, 12]);
ax[0].imshow(x3)
ax[0].axis(False)
ax[0].set_title('With no padding')
ax[1].imshow(x4)
ax[1].axis(False)
ax[1].set_title('With padding');
../../../_images/0462ecf42440c3d976e679aa074aaf2ee3174e7ae52e7b6e0e90b0d272c20f2f.png

pad_val#

The value to be placed in padded voxels. It is almost always 1 but setting to 0 may be useful for applying a distance transform.

func = edt

x5 = ps.filters.apply_padded(im=im, pad_width=10, func=func, pad_val=1)
x6 = ps.filters.apply_padded(im=im, pad_width=10, func=func, pad_val=0)

fig, ax = plt.subplots(1, 2, figsize=[12, 12]);
ax[0].imshow(x5);
ax[0].axis(False)
ax[0].set_title('pad_val = 1')
ax[1].imshow(x6);
ax[1].axis(False)
ax[1].set_title('pad_val = 0');
../../../_images/e88bfdd41c1b6b70c1c2437894f6584ee2f065c7ea2e1eec96a24801ac0cf050.png