
dzresp(1)                    Khoros                     dzresp(1)

PROGRAM
     dzresp - Calculates the magnitude, power or phase response
     of a z-domain system

SYNTAX
     dzresp

     -i             input data file (polynomial file)

     -o             resulting output file (xviff file)

     [-n]           number of points

     [-r]           generate one-sided (0) or two-sided (1)
                    response

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

     [-p]           type of response(0 = magnitude; 1 = power; 2
                    = phase):
                    0 (magnitude response),
                    1 (power response),
                    or 2 (phase response)
                       [default = 0]

     [-V]           Gives the version for dzresp

     [-U]           Gives the usage for dzresp

     [-P]           Prompts for command line options

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

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

DESCRIPTION
     dzresp calculates the magnitude, power or phase response of
     a discrete system in the z transform domain.  The input file
     contains one or more polynomials in standard algebraic form,
     with extensions for stages.  For example:

             H(z) = (100*z^3 + 20*z - 1)/(150*z^2 + 3.14*z + 1);

     An example of a multistage polynomial is:

             H(z) = [(2*z^2 + z +1)/(4*z^2 - 1)]*[z^3 + 4];
     Each stage may be of any order, and each stage may be of a
     different order.  dzresp is insensitive to whitespace (tabs,
     carraige returns, spaces).  Each polynomial must be delim-
     ited by a semicolon.

     When calculating the magnitude or power response, if the
     result of an evaluation of the transfer function results in
     infinity, then the result of that evaluation will be set to
     1.0e38.  If the phase response is being Calculated, and the
     same thing happens, then the phase at that point will be set
     to the phase at the next point, unless this is the last
     point in the data set, in which case it will be set to the
     value of the previous calculation.

     Process direction
     Data can be output 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 pixel loca-
     tion.  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 (polynomial file)

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

OPTIONAL ARGUMENTS
     -n     type: integer
            desc: number of points
            default: 256
            bounds: no range checking

     -r     type: boolean
            desc: generate one-sided (0) or two-sided (1)
            response
            default: false

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

     -p     type: integer
            desc: type of response(0 = magnitude; 1 = power; 2 =
            phase)
            allowed values:
            0 (magnitude response),
            1 (power response),
            or 2 (phase response)

EXAMPLES
SEE ALSO
     intro(1), verror(3), vgparms(3), vutils(3), ldzresp(3)

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

Khoros                    Release: 1.0                          1

