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 delimited 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 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 (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.