cutcutcodec.core.analysis.video.quality.psnr

cutcutcodec.core.analysis.video.quality.psnr(ref: Tensor, dis: Tensor, *args, **kwargs) → Tensor[source]

Compute the peak signal to noise ratio of 2 images.

Parameters

ref, disarraylike: The 2 images to be compared, of shape ([*batch], height, width, channels). Supported types are float32 and float64.
weightsiterable[float], optional: The relative weight of each channel. By default, all channels have the same weight.
threadsint, optional: Defines the number of threads. The value -1 means that the function uses as many calculation threads as there are cores. The default value (0) allows the same behavior as (-1) if the function is called in the main thread, otherwise (1) to avoid nested threads. Any other positive value corresponds to the number of threads used.

Returns

psnrarraylike: The global peak signal to noise ratio, as a ponderation of the mean square error of each channel. It is batched and clamped in [0, 100] db.

Notes

It is optimized for C contiguous tensors.
If device is cpu and gradient is not required, a fast C code is used instead of torch code.

Examples

>>> import numpy as np
>>> from cutcutcodec.core.analysis.video.quality import psnr
>>> np.random.seed(0)
>>> ref = np.random.random((720, 1080, 3))  # It could also be a torch array list...
>>> dis = 0.8 * ref + 0.2 * np.random.random((720, 1080, 3))
>>> psnr(ref, dis).round(1)
np.float64(21.8)
>>>