This file lists some (currently available) parts of Spectrum Lab's configuration structure which can be accessed by the command interpreter.

Note: To access the following configuration variables through the interpreter, they must be prefixed with "cfg." or "config.".

Example:
print("FFT size=",cfg.FFTSize,"points")

Warning: Read/write access for most of these variables has never been tested, especially not from external programs using the message-based communication protocol ! If you need to access more of these parameters through the interpreter (or modify them from another program) and find that something doesn't work as it should, let me know.

FFT properties for the FIRST SPECTRUM ANALYZER...

FFTSize
FFT input size (number of sample points in the time domain)
FFTAverage
FFT average count (was once used to suppress noise in spectrograms)
FFTInputDec
Decimation ratio for the FFT input samples. Increases frequency resolution but decreases displayable bandwidth.
FFTCenterFreq
Center frequency for "complex frequency conversion with decimation" before the FFT.
FFTWindowFunc
Windowing function for the FFT. Implemented (so far) :
0 = RECTANGLE (which actually means "no windowing")
1 = HAMMING
2 = HANN (named after Julius von Hann, not "Hanning")
3 = GAUSS
4 = NUTTALL
5 = FLAT_TOP

Configuration for the FIRST SPECTRUM DISPLAY...

SpecFreqMin
min displayed frequency
SpecFreqMax
max displayed frequency
SpecFreqOffs
"any user-offset" for displayed frequency
SpecAmplMin
amplitude range, min
SpecAmplMax
amplitude range, max
SpecDbOffsExpr
an expression to calculate a user-defined "zero-decibel point". Periodically evaluated.
SpecDispOrient
orientation of the spectrum display and waterfall (horz,vert)
SpecGraphArea
Size of the spectrum graph area in pixels (the rest is used for frequency scale and spectrogram)
SpecDispMirror
mirror for the frequency axis (USB, LSB)
SpecDispStyle
display style (WHERE and WHAT is displayed)
SpecDispMode
display mode (outdated)
SpecOptiAverag
flag for "optimum spectrum average"
SpectrumActive
flag to enable/disable the spectrum analyzer
SpecAmplGrid
flag to turn the "amplitude grid" on and off
SpecFreqGrid
flag to turn the "frequency grid" on and off
SpecFreqGridSt
style for displaying the "frequency grid" (dotted, solid)
SpecBkgndColor
background color for spectrum graph
SpecGridColor
grid color for spectrum graph
SpecGrPenColor
pen color for spectrum graph

Waterfall display control

Wat1ClContrast
"Color Contrast" for the first (=main) waterfall display
Wat1ClBrightns
"Color Brightness" for the first (=main) waterfall display
Wat1FreqGrid
flag to turn the waterfall's frequency grid on and off
Wat1GridColor
grid color for the waterfall
Wat1TextColor
text color for the waterfall
Wat1LabelTrans
transparency of labels on the waterfall
Wat1TimeGrid
flag to enable/disable the "time grid" on the waterfall
Wat1TimeLabel
flag to enable/disable the "time label" on the waterfall
Wat1ScrollTime
scroll interval of the waterfall, time in seconds
Wat1Scrolling
flag if scrolling or "radar-like" waterfall
Wat1SmoothScr
flag if smooth scrolling shall be attempted
Wat1LineWidth
single or double waterfall line width
TimeGridStyle
style of time grid (dotted or solid)
TimeGridSecnds
spacing of time grid (in seconds)

Other display colors

FrScaleBgColor
Background color for the frequency scale
FrScaleFgColor
Foreground color for the frequency scale

System settings... sample rate, audio source and destination

NominalAudioSR
nominal audio sample rate as integer value, usually 5512, 11025, 22050, or 44100.
SrCalibEnable
flag to enable the sample rate calibrator
SrCalibConnect
numeric code for a channel where the sample rate calibrator is connected to
SrCalibMinAmpl
minimum amplitude for the sample rate calibrator. If signal is too weak, no calibration takes place
SrCalibAverags
count of average values for the sample rate calibrator
SrCalibRefFreq
reference frequency for the sample rate calibrator
SrCalibBdwidth
"observation" bandwidth of the sample rate calibrator
SrCalibMaxOffs
maximum tolerable frequency offset for the sample rate calibrator
FoCalibEnable
flag to enable the sample rate calibrator
FoCalibConnect
numeric code for a channel where the frequency offset (F.O.) calibrator is connected to
FoCalibMinAmpl
minimum amplitude for the F.O. calibrator. If signal is too weak, no calibration takes place
FoCalibAverags
count of average values for the F.O. rate calibrator
FoCalibRefFreq
reference frequency for the F.O. calibrator
FoCalibBdwidth
"observation" bandwidth of the F.O. calibrator
FoCalibMaxOffs
maximum tolerable frequency offset for the F.O. calibrator
StereoProcess
flag if mono or stereo processing (at the moment)
ConsumeADfile
flag if a "file server" shall be used instead of an A/D converter
ConsADfilename
name of the file which replaces an A/D converter
ToStartADfile
command line for ADC file server
ToStopADfile
command line for ADC file server
ProduceDAfile
flag if a "file server" shall be used instead of a D/A converter
ProdDAfilename
name of the file which replaces a D/A converter
ToStartDAfile
command line for DAC file server
ToStopDAfile
command line for DAC file server
MaxSrvFilesz
max. size of the file sent to or received from  analogue file server
SpectRefFile
name of a file with spectrum reference data
SpectRefEnable
flag if the spectrum reference curve shall be active or visible on the screen
SpectRefSubtr
flag if the values from the recference curve shall be ""subtracted"" from the spectra
SpectRefColor
color used to draw the spectrum reference curve
WavePlayLoops
flag if wave file shall be played in an endless loop
WavePlayUpsamp
flag if wave file shall be played with "upsampling"
WavePlayDownsp
flag if wave file shall be played with "downsampling"
WavePlayAAlias
flag if wave file shall be played with "anti-aliasing" when "upsampling"
WavePlaySpeedP
(not used at the moment) Speed percentage when playing wave file
WaveSaveDowns
flag if wave files shall be saved (recorded) with downsampling
WaveSaveSRate
wanted sample rate for recording wave files
WaveSaveFormat
to be defined
WaveSaveInfos
to be defined
WaveSaveIQpair
to be defined
WaveSaveCtFreq
to be defined
WaveSaveMaxKb
to be defined

Test signal generator

ConnGenToInput
to be defined
ConnGenToOutput
to be defined
AmplifierGain
gain for all amplifiers which are visible in the "circuit diagram". Array !
ConnSlider1To
defines to which parameter the "value slider" is connected
GenNoiseLevel
noise level of the test signal generator
GenNoiseEnable
flag to activate "noise" from the test signal generator
GenAModFrequ
amplitude modulator frequency of the test signal generator
GenAModFactor
amplitude modulation factor of the test signal generator
GenAModCarrier
carrier amplitude for the test signal generator's AM modulator
GenAModWavefrm
waveform for AM modulator
GenFModFrequ
freq-modulator signal frequency of the test signal generator
GenFModDeviatn
freq-modulator deviation of the test signal generator
GenFModWavefrm
waveform for FM modulator
Gen1.xyz
parameters for 1st test signal generator cell
Gen2.xyz
parameters for 2nd test signal generator cell
Gen2.xyz
parameters for 3rd test signal generator cell

Input, Output, Circuit Components

AdcInputActive
flag for activity of the analog input
DacOutputActive
flag for activity of the analog output
SignalGenActive
flag for activity of the signal generator
UsrFilterActive
flag for activity of the user programmable filter
UsrFilterBypass
flag to bypass the filter (feed-through for comparison)

DSP Blackboxes in the circuit window

Each of the four (?) "DSP Blackboxes" has an awful lot of properties and parameters. At the moment, they are *not* accessable through the "cfg"-command, but only direcly, using the blackbox command (just "blackbox", not "cfg.blackbox") as explained in another document.

Settings for "Periodic" and "Scheduled" actions (not only 'capture' !)

PeriodicStart
time-of-day when the periodic actions shall begin
PeriodicStop
time-of-day when the periodic actions shall stop
PeriodicIntrvl
interval of periodic actions
PeriodicEnable
flag to enable/disable periodic actions
PeriodicAction
a string of interpreter commands
ScheduleEnable
flag to enable/disable scheduled actions

Other function blocks

DigiTrmEnable
to be defined
DigiTrmCWIdent
to be defined
DCF77DecEnable
to be defined
DebugMetronome
to be defined

Screen Capture Options

Capt1Options
what shall be contained in a captured screen ?
Capt1Sequence
the "serial number" (file index) of the captured files as seen in the control dialog.
Note: The file index only comes into play when the capture-command is invoked without parameters.
Capt1FileName
the default capture file name if the "capture" command is executed without parameters
CaptureAsJpeg
well..
JpegQuality
percentage, 0=min 100=max JPEG quality (but also maximum size)