Resize
Bases: SpatialTransform
Resize images to a target spatial shape.
The field of view is preserved; voxel spacing is adjusted to fit the new shape.
Warning
In most medical image applications, this transform should
not be used as it scales anisotropically. Prefer
Resample (change spacing) combined with
CropOrPad (change shape) instead.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
target_shape
|
int | tuple[int, int, int]
|
Target spatial shape \((I, J, K)\). A single integer \(N\) means \((N, N, N)\). |
required |
image_interpolation
|
str
|
|
'linear'
|
label_interpolation
|
str
|
|
'nearest'
|
**kwargs
|
Any
|
See |
{}
|
Examples:
>>> import torchio as tio
>>> transform = tio.Resize(128)
>>> transform = tio.Resize((256, 256, 64))
Source code in src/torchio/transforms/spatial/resize.py
supports_per_instance_params
property
Whether this transform can sample parameters per batch element.
Defaults to False. Transforms that implement per-instance
parameter sampling override this to return True. When False,
the transform always uses batch-shared parameters regardless of
the per_instance flag, preserving the legacy behavior.
supports_per_instance_p
property
Whether this transform can gate each batch element independently.
Defaults to False. Shape-preserving transforms that implement
per-element probability override this to return True.
Shape-changing transforms must leave it False because masked
and unmasked elements would have incompatible shapes.
invertible
property
Whether this transform can be inverted.
forward(data)
Apply the transform.
The output type always matches the input type.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
data
|
Any
|
Input data to transform. |
required |
Source code in src/torchio/transforms/transform.py
inverse(params)
Return a transform that undoes this one.
Override in invertible subclasses. The returned transform, when applied, reverses the effect of the forward pass with the given parameters.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
params
|
dict[str, Any]
|
The parameters recorded in the forward pass. |
required |
Returns:
| Type | Description |
|---|---|
Transform
|
A new |
Source code in src/torchio/transforms/transform.py
to_hydra()
Export as a Hydra-compatible config dict.
Returns a dict with _target_ set to the fully qualified
class name and only non-default field values included.
Returns:
| Type | Description |
|---|---|
dict[str, Any]
|
Dict suitable for |
Source code in src/torchio/transforms/transform.py
make_params(batch)
apply_transform(batch, params)
Resize each image to the target shape.