dnormal(1)

PROGRAM
dnormal - Normalize Data

SYNTAX

dnormal

-i  input data file (xviff file)

-o  resulting output file (xviff file)

[-t]
    type of normalization (0 = normal, 1 = scale and shift

[-n]
    minimum value of warped data

[-m]
    maximum value of warped data

[-d]
    data processing direction (0 = down vectors, 1 = across bands)

[-V]
    Gives the version for dnormal

[-U]
    Gives the usage for dnormal

[-P]
    Prompts for command line options

[-A [file1]]
    Creates the answer file called dnormal.ans or file1

[-a [file1]]
    Uses dnormal.ans or file1 as the answer file

DESCRIPTION
Normalizes the magnitude of the input data. This often minimizes roundoff errors in future processing. When conventional normalization is selected (i.e. -t 0, which is the default), dnormal scales the magnitude of the data by the magnitude of the largest value in the data set. In the alternate mode of operation (-t 1), dnormal computes the scale factor to force the most positive value in the data record to be equal to the user selected value, and shifts it according to minimum value specified. The result is a signal that ranges from the minimum value specified to the maximum. The resulting image has only its "appearance" preserved.

In the second mode of operation described above, if the minimum value specified is less than zero and dnormal is operating on a complex sequence, then it will reset the minimum value to 0. Furthermore, if the maximum value is negative, and it is operating on a complex sequence, the maximum will be reset to its absolute value.

In the default mode of operation, phase is not disturbed. This is not guaranteed if the scale and shift mode is enabled.

REQUIRED ARGUMENTS

-i  type: infile
    desc: input data file (xviff file)

-o  type: outfile
    desc: resulting output file (xviff file)

OPTIONAL ARGUMENTS

-t  type: boolean
    desc: type of normalization (0 = normal, 1 = scale and shift
    default: false

-n  type: float
    desc: minimum value of warped data
    default: 0
    bounds: no range checking

-m  type: float
    desc: maximum value of warped data
    default: 1
    bounds: no range checking

-d  type: boolean
    desc: data processing direction (0 = down vectors, 1 = across bands)
    default: true

EXAMPLES

dnormal -i input_file -o output_file

This preceeding command line will take the input file and normalize it with respect to its largest value.

dnormal -i input_file -o output_file -n 10 -m 14 -d 1

This command will shift and scale the data so that its magnitude ranges from a minimum of 10.0 to a maximum of 14. The process direction chosen is band oriented.

SEE ALSO
intro(1), verror(3), vgparms(3), vutils(3), ldnormal(3) dscale (1), dspl (3)

RESTRICTIONS
Operated on real and complex data only.

COPYRIGHT
Copyright 1992, University of New Mexico. All rights reserved.