
dnormal(1)                   Khoros                    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 con-
     ventional 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 sig-
     nal that ranges from the minimum value specified to the max-
     imum.  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 mag-
     nitude 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.

Khoros                    Release: 1.0                          1

