Table of Contents

NAME

rawdist3d - calculate the distortion between two 3D raw images

SYNOPSIS

rawdist3d [-vo] [-mse] [-snr] [-mae] [-s] [-bpv bits_per_voxel] [-bsq] [-bil] [-bip] [-bend] [-lend] num_rows num_cols num_frames 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.
-bpv
Indicates the number of bits per each voxel (sample) value. Default is 16.
-bsq
Indicates raw file is stored in band-sequential (BSQ) order. This is the default.
-bil
Indicates raw file is stored in band-interleaved-by-line (BIL) order.
-bip
Indicates raw file is stored in band-interleaved-by-pixel (BIP) order.
-bend
Indicates raw file contains 16-bit integers stored in big-endian format. This is the default.
-lend
Indicates raw file contains 16-bit integers stored in little-endian format.

DESCRIPTION

rawdist3d prints the mean square error (MSE), signal-to-noise ratio (SNR), and maximum absolute error (MAE), between two 3D 16-bit 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, rawdist3d prints the distortion in all forms.

If the option -vo is specified, then rawdist3d 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; rawdist3d thus finds the variance of rawfile1 for use in the SNR calculation.

The option -bpv specifies the number of bits that each voxel value contains. bits_per_voxel must be between 1 and 32. If bits_per_voxel is <= 8, then each sample is stored in rawfile as the least significant bits in a single byte; otherwise, if bits_per_voxel is <= 16, then each sample is stored in rawfile as the least significant bits of two consecutive bytes (the default); otherwise, if bits_per_voxel 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.

The options -bsq, -bil, and -bip indicate the scanning order of the rawfile; see QccHYPRaw(3) . If none of -bsq, -bil, or -bip are present, BSQ is assumed.

Both rawfile1 and rawfile2 must be the same size (num_rows x num_cols spatially, with num_frames spectral bands).

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