
dmpp(1)                      Khoros                       dmpp(1)

PROGRAM
     dmpp - Magnitude, Power, or Phase of 1-D signal(s)

SYNTAX
     dmpp

     -i             input data file (xviff file)

     -o             resulting output file (xviff file)

     [-p]           type of phase (0-radians, 1-degrees)

     [-mp]          phase range (0: -pi to pi, 1: - 0 to 2pi)

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

     [-m]           type of response desired::
                    0 (choose Magnitude),
                    1 (choose Power),
                    or 2 (choose Phase)
                       [default = 0]

     [-s]           type of scaling::
                    0 (choose magnitude),
                    1 (choose log(magnitude)),
                    2 (choose log(magnitude+1)),
                    3 (choose ln(magnitude)),
                    or 4 (choose ln(magnitude+1))
                       [default = 0]

     [-V]           Gives the version for dmpp

     [-U]           Gives the usage for dmpp

     [-P]           Prompts for command line options

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

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

DESCRIPTION
     determines the magnitude, power, or phase of each 1-D data
     point in the input data file.

     dmpp will find the 1-D magnitude, power, or phase of each
     data point. If magnitude or power is selected, it can gen-
     erate the log or natural log of the result, or the log or
     natural log of the result +1.

     If phase is selected, then dmpp can generate either the
     radian or degree result.

     dmpp does not work on explicit location data and will return
     an error when such a file is encountered.  No output file
     will be created.  dmpp works only on VFF_TYP_FLOAT or
     VFF_TYP_COMPLEX data files.

     Input/Output Files
     The input file must be of type VFF_TYP_FLOAT or
     VFF_TYP_COMPLEX.  The output file returned will be the same
     size of the input file and the type will be VFF_TYP_FLOAT.

     *********************************************************************

     Process direction
     Data can be processed with either band or vector orientation
     (-d option).  The default data processing direction is in
     the vector direction (-d = 0).  This means that data stored
     in multiband format will be processed as a set of data
     sequences, where each sequence corresponds to a pixel loca-
     tion, and the points of each sequence are defined by the
     bands corresponding to that pixel location.  The direction
     of processing can be changed so that each band is processed
     as a signal (instead of each vector being a signal) by set-
     ting the -d option to 1.

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

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

OPTIONAL ARGUMENTS
     -p     type: boolean
            desc: type of phase (0-radians, 1-degrees)
            default: false

     -mp    type: boolean
            desc: phase range (0: -pi to pi, 1: - 0 to 2pi)
            default: false

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

     -m     type: integer
            desc: type of response desired:
            allowed values:
            0 (choose Magnitude),
            1 (choose Power),
            or 2 (choose Phase)

     -s     type: integer
            desc: type of scaling:
            allowed values:
            0 (choose magnitude),
            1 (choose log(magnitude)),
            2 (choose log(magnitude+1)),
            3 (choose ln(magnitude)),
            or 4 (choose ln(magnitude+1))

EXAMPLES
     dmpp -i input_file -o magnitude, power, or phase_output_file
     Will return a file containing the magnitude, power, or phase
     of the input_file.  The data processing direction is in the
     vector direction.
     dmpp -i input_file -o magnitude, power, or phase_output_file
     -m 1 -d 1
     Will return a file containing the log(magnitude, power, or
     phase) of the input_file.  The data processing direction is
     in the band direction.

SEE ALSO
     intro(1), verror(3), vgparms(3), vutils(3), ldmpp(3)

RESTRICTIONS
     dmpp works only on VFF_TYP_COMPLEX and VFF_TYP_FLOAT.

     dmpp does not work on explicit location data and will return
     an error when such a data file is encountered.  -bugs_end

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

Khoros                    Release: 1.0                          1

