Inference methods¶
Sliding Window Inference¶
-
monai.inferers.
sliding_window_inference
(inputs, roi_size, sw_batch_size, predictor, overlap=0.25, mode=<BlendMode.CONSTANT: 'constant'>, sigma_scale=0.125, padding_mode=<PytorchPadMode.CONSTANT: 'constant'>, cval=0.0, device=None)[source]¶ Sliding window inference on inputs with predictor.
When roi_size is larger than the inputs’ spatial size, the input image are padded during inference. To maintain the same spatial sizes, the output image will be cropped to the original input size.
- Parameters
inputs (
Tensor
) – input image to be processed (assuming NCHW[D])roi_size (
Union
[Sequence
[int
],int
]) – the spatial window size for inferences. When its components have None or non-positives, the corresponding inputs dimension will be used. if the components of the roi_size are non-positive values, the transform will use the corresponding components of img size. For example, roi_size=(32, -1) will be adapted to (32, 64) if the second spatial dimension size of img is 64.sw_batch_size (
int
) – the batch size to run window slices.predictor (
Callable
[[Tensor
],Tensor
]) – given input tensor patch_data in shape NCHW[D], predictor(patch_data) should return a prediction with the same spatial shape and batch_size, i.e. NMHW[D]; where HW[D] represents the patch spatial size, M is the number of output channels, N is sw_batch_size.overlap (
float
) – Amount of overlap between scans.mode (
Union
[BlendMode
,str
]) –{
"constant"
,"gaussian"
} How to blend output of overlapping windows. Defaults to"constant"
."constant
”: gives equal weight to all predictions."gaussian
”: gives less weight to predictions on edges of windows.
sigma_scale (
Union
[Sequence
[float
],float
]) – the standard deviation coefficient of the Gaussian window when mode is"gaussian"
. Default: 0.125. Actual window sigma issigma_scale
*dim_size
. When sigma_scale is a sequence of floats, the values denote sigma_scale at the corresponding spatial dimensions.padding_mode (
Union
[PytorchPadMode
,str
]) – {"constant"
,"reflect"
,"replicate"
,"circular"
} Padding mode forinputs
, whenroi_size
is larger than inputs. Defaults to"constant"
See also: https://pytorch.org/docs/stable/nn.functional.html#padcval (
float
) – fill value for ‘constant’ padding mode. Default: 0device (
Optional
[device
]) – device running the concatenation of the windows. By default the device and accordingly the memory of the input device is used. If for example set to device=torch.device(‘cpu’) the gpu memory consumption is less and independent of the input and roi_size parameter. Output is on the device set or if not set the inputs device.
- Raises
NotImplementedError – When
inputs
does not have batch size = 1.
Note
input must be channel-first and have a batch dim, support both spatial 2D and 3D.
currently only supports inputs with batch_size=1.
- Return type
Tensor
Inferers¶
-
class
monai.inferers.
Inferer
[source]¶ A base class for model inference. Extend this class to support operations during inference, e.g. a sliding window method.
SimpleInferer¶
SlidingWindowInferer¶
-
class
monai.inferers.
SlidingWindowInferer
(roi_size, sw_batch_size=1, overlap=0.25, mode=<BlendMode.CONSTANT: 'constant'>, sigma_scale=0.125, padding_mode=<PytorchPadMode.CONSTANT: 'constant'>, cval=0.0)[source]¶ Sliding window method for model inference, with sw_batch_size windows for every model.forward().
- Parameters
roi_size (
Union
[Sequence
[int
],int
]) – the window size to execute SlidingWindow evaluation. If it has non-positive components, the corresponding inputs size will be used. if the components of the roi_size are non-positive values, the transform will use the corresponding components of img size. For example, roi_size=(32, -1) will be adapted to (32, 64) if the second spatial dimension size of img is 64.sw_batch_size (
int
) – the batch size to run window slices.overlap (
float
) – Amount of overlap between scans.mode (
Union
[BlendMode
,str
]) –{
"constant"
,"gaussian"
} How to blend output of overlapping windows. Defaults to"constant"
."constant
”: gives equal weight to all predictions."gaussian
”: gives less weight to predictions on edges of windows.
sigma_scale (
Union
[Sequence
[float
],float
]) – the standard deviation coefficient of the Gaussian window when mode is"gaussian"
. Default: 0.125. Actual window sigma issigma_scale
*dim_size
. When sigma_scale is a sequence of floats, the values denote sigma_scale at the corresponding spatial dimensions.padding_mode (
Union
[PytorchPadMode
,str
]) – {"constant"
,"reflect"
,"replicate"
,"circular"
} Padding mode whenroi_size
is larger than inputs. Defaults to"constant"
See also: https://pytorch.org/docs/stable/nn.functional.html#padcval (
float
) – fill value for ‘constant’ padding mode. Default: 0
Note
sw_batch_size
denotes the max number of windows per network inference iteration, not the batch size of inputs.