Updating the resize documentation.

[zivy]

The runtime difference between resizing with anti-aliasing and without is significant. This may be an issue when the function is used in a context involving user interaction.

[zivy]

Code illustrating the runtime behavior:

import SimpleITK as sitk
from SimpleITK.utilities.resize import resize
import time
import numpy as np

image = sitk.ReadImage("puppy.jpg")

time_diff = []
for i in range(5):
  t0 = time.time()
  resize(image, [64,64], fill_value=0, anti_aliasing_sigma=0)
  t1 = time.time()
  time_diff.append(t1-t0)

print(f"Time without antialiasing {np.mean(time_diff)}")

time_diff = []
for i in range(5):
  t0 = time.time()
  resize(image, [64,64], fill_value=0, anti_aliasing_sigma=None)
  t1 = time.time()
  time_diff.append(t1-t0)

print(f"Time with default antialiasing {np.mean(time_diff)}")

Output was:

Time without antialiasing 0.005415868759155273
Time with default antialiasing 0.03511381149291992

[blowekamp]

Change to:

Anti-aliasing is enabled by default.

Performance can be increased by disabling anti-aliasing ( anti_aliasing_sigma=0 ), and by setting the interpolator to sitkNearestNeighbor at the cost of decreasing quality.

[zivy]

Updated.

[blowekamp]

Thanks.