# this is
# ============================================================================
# foutra: definition of command line options and parameters
# ---------------------------------------------------------
outfile output filename
infile input filename
t:T select traces T, where T may be any range
specification like '3-4' or '5,6,7-12,20'
-help prints this help text
-xhelp print information concerning supported data formats
-v be verbose
-D debug mode
-o overwrite output
-type type select input file type
-Type type select output file type
-amplitude compute Fourier amplitude spectrum
-power compute power spectral density (or power spectrum)
-harmonic scale output appropriate fro harmonic signals
useful for two-tone-tests of linearity (see below)
-rms report rms values of input data
-boxcar apply boxcar taper (i.e. no taper; default is Hanning)
-demean[=n] remove average from input time series
(determined from n samples)
-detrend[=n] remove trend from input time series
(determined from n samples)
-divisor[=n] FFT becomes very inefficient if the factorization
of the number of samples includes large prime numbers.
This option removes the least number of samples to
the total number of samples a multiple of "n"
-pad n pad time series with zeroes; n gives the integer factor
for the number of samples; the raw amplitude spectrum
has to be understood as the spectrum of the whole
series including the padded zeroes; PSD and harmonic
signals are scaled to represent the taper time window
only, such that padding is a means of smoothing only
-nsegments n subdivide input time series in "n" overlapping
sequences (overlap is 50%); spectral analysis is
done for each sequence individually; the result
is the mean of all sequences; this applies to PSD
and harmonic signal analysis only; it is particularly
useful for two-tone-test where spectral smoothing
of background noise is anticpated, while maintaining
the full resolution for harmonic peaks
-avg[=n] smooth power spectrum by averaging over n samples
values still specify power spectral density
-rbw[=n] smooth power spectrum by averaging over n decades
values still specify power spectral density
-derivative[=n] effectively take n-th derivative of time series
computation is done in the Fourier domain and has no effect on
time series
-scalerbw[=n] scale to mean value in n decades
output value then are not power spectral density but average
signal power in the specified bandwidth
-ASCII[=base] write result to two-column ASCII files with basename 'base'
-logascii[=n] write ASCII data on logarithmic frequency axis with
one value per 'n' decades
-avgascii only average values for output to ASCII file
this option speeds up calculation together with
-scalerbw which increases computation time
with the square of frequency
#
# ----- END OF foutra_options.txt -----