vpi.Image.recursive_gaussian_filter

Image.recursive_gaussian_filter(self: vpi.Image, sigma: Union[tuple[float, float], float], *, backend: vpi.Backend = vpi.Backend.DEFAULT, out: vpi.Image = None, border: vpi.Border = vpi.Border.ZERO, stream: vpi.Stream = None) vpi.Image

Runs Recursive Gaussian Filter over the image.

This function can be used to run bigger sigma values than the maximum limit of direct-convolution-based Gaussian filter.

See also

Refer to the algorithm explanation for more details and usage examples.

Parameters
  • sigma (Tuple[float, float] or float) – The standard deviation of the Gaussian kernel as either (1) a tuple of two floats or (2) a single float, where (1) defines the X and Y directions respectively, and (2) defines both.

  • out (vpi.Image, optional) – The output for the algorithm.

  • border (vpi.Border, optional) – The border extension used by the algorithm. Default is vpi.Border.ZERO.

  • backend (vpi.Backend, optional) – The backend to be used by the algorithm.

  • stream (vpi.Stream, optional) – The stream to be used by the algorithm.

Returns

The outut of the algorithm.

Return type

vpi.Image

Caution

Restrictions to several arguments may apply. Check the C API references of the create function and the submit function and the group concepts for more details.