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 generate 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 location, 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 setting 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.