Table of Contents


NAME

data:low-pass-pars - Calculate low-pass gain/phase-margin and band-width parameters (Decida Procedure)

USAGE

          data:low-pass-pars d OUT args

ARGUMENTS

d data object
OUT The name of the output data column. Requires DB(OUT) and PH(OUT) columns. If these are not present, then RE(OUT) and IM(OUT) columns are used. If none of these are present, then error message is generated.
args OPTIONS or RETURN-PARAMETERS. If no return-parameters are specified, all are returned.

OPTIONS

-freq <FREQ> specify the name of the frequency data column (default is FREQ).
-phase <phase> specify the phase at DC. If this is not specified, then the phase of OUT at the first FREQ point is used to choose among -180, 0, or 180 (the closest value).

RETURN-PARAMETERS

gain_dc return the gain at lowest frequency point (dB)
phase_dc return the phase at dc which was actually used
freq_gain0db return the frequency at gain=0dB
phase_gain0db return the phase at gain=0dB
freq_phase180 return the frequency at phase=(phase_dc-180)
gain_phase180 return the gain at phase=(phase_dc-180)
phase_margin return the phase_gain0db-(phase_dc-180)
gain_margin return the -gain_phase180
bandwidth_3db return the bandwidth at 3dB point
gbw_3db return the gain-bandwidth product using 3dB point
gbw_dec return the gain-bandwidth product at 1 decade below gain=0db point

RESULTS

Returns parameter value pairs: gain_dc gain at lowest frequency point (dB) phase_dc the phase at dc which was actually used freq_gain0db frequency at gain=0dB phase_gain0db phase at gain=0dB freq_phase180 frequency at phase=(phase_dc-180) gain_phase180 gain at phase=(phase_dc-180) phase_margin phase_gain0db-(phase_dc-180) gain_margin -gain_phase180 bandwidth_3db bandwidth at 3dB point gbw_3db gain-bandwidth product using 3dB point gbw_dec gain-bandwidth product at 1 decade below gain=0db pt

EXAMPLE-CALL

             data d
             d read tgw32b.out
             array set Pars [d low-pass-pars VOUT]
             echo "3dB bandwidth = $Pars(bandwidth_3db)"
             [data d] read tgw32b.out
             echo "phase-margin = [d low-pass-pars VOUT phase_margin]"

AUTHOR

Richard Booth

Table of Contents