Table of Contents

NAME

rawdist2d - calculate the distortion between two 2D raw images

SYNOPSIS

rawdist2d [-vo] [-mse] [-snr] [-mae] [-s] [-bpp bits_per_pixel] [-bend] [-lend] num_rows num_cols rawfile1 rawfile2

OPTIONS

-vo
Output only the value of the distortion (terse output).
-mse
Express the distortion in terms of MSE.
-snr
Express the distortion in terms of SNR.
-mae
Express the distortion in terms of MAE.
-s
Indicates raw file contains signed values. Default: raw file contains unsigned values.
-bpp
Indicates the number of bits per each pixel (sample) value. Default is 16.
-bend
Indicates raw file contains integers stored in big-endian format. This is the default.
-lend
Indicates raw file contains integers stored in little-endian format.

DESCRIPTION

rawdist2d prints the mean square error (MSE), signal-to-noise ratio (SNR), and maximum absolute error (MAE), between two 2D raw image files, rawfile1 and rawfile2, to stdout.

The options -mse, -snr, and -mae, indicate in which form the distortion should be expressed. If none of these options are specified, rawdist2d prints the distortion in all forms.

If the option -vo is specified, then rawdist2d prints a terse output, consisting of only the value of the distortion, to stdout. One of the options -mse, -snr, or -mae must be specified in this case.

For the calculation of SNR, rawfile1 is considered to be the original signal; rawdist2d thus finds the variance of rawfile1 for use in the SNR calculation.

The option -bpp specifies the number of bits that each pixel value contains. bits_per_pixel must be between 1 and 32. If bits_per_pixel is <= 8, then each sample is stored in rawfile as the least significant bits in a single byte; otherwise, if bits_per_pixel is <= 16, then each sample is stored in rawfile as the least significant bits of two consecutive bytes (the default); otherwise, if bits_per_pixel is <= 32, then each sample is stored in rawfile as the least significant bits of four consecutive bytes. The option -s indicates that the raw file contains signed values; unsigned is assumed if the -s option is absent. The options -bend and -lend indicate whether the raw file is in big-endian or little-endian format, respectively. If neither is specified, big-endian is assumed.

Both rawfile1 and rawfile2 must be stored in row-major order and must be the same size (num_rows x num_cols).

SEE ALSO

QccHYPRaw(3) , QccPackHYP(3) , QccPack(3)

AUTHOR

Copyright (C) 1997-2021 James E. Fowler


Table of Contents



Get QccPack at SourceForge.net. Fast, secure and Free Open Source software downloads