SIGVIEW supports various command-line parameters enabling you to use some of SIGVIEW
functions from external applications or batch files. Since this feature is based on a simple
command-line invocation, it can be used from any other programming language or environment
capable of using command-line system calls.
This features allows you to start a new SIGVIEW instance with specific parameters, but even
more important, it allows you to pass commands to the already running SIGVIEW instance. This
provides a powerful remote control API which can be used to automate many analysis
Typical application examples for command-line invocation would be to perform the same analysis
on many different files or to perform some live signal analysis according to a time schedule.
General syntax of command-line invocation is of the form:
SIGVIEW.exe <action> <parameters>
Each command invocation checks if there is already SIGVIEW instance running and if yes, sends
command to it. Otherwise, new SIGVIEW instance is started and executes the command. To
make calling SIGVIEW.exe easier, you can use environment variable SIGVIEW_EXE which
contains full path of the SIGVIEW executable. For example, in a batch file it would look like this:
%SIGVIEW_EXE% <action> <parameters>
Instead of providing single function for each analysis feature in SIGVIEW, command-line interface
is based on creating and reusing Sigview WorkSpace files (SWS). This means that you will
always create a workspace file first, containing the basics of analysis you would like to control
remotely. For more details about creating and using SWS files, please proceed here.
command you will use will probably be loading of SWS file, for example:
%SIGVIEW_EXE% -loadsws c:\myworkspace.sws
After the SWS has been loaded, you will be able use various commands to start/stop analysis,
save data to a file etc. For example, to save content of a window to a 16-bit WAV file, you would
%SIGVIEW_EXE% -savewav16 window1 "c:\my dir\file1.wav"
To be able to reference single windows from your workspace, as "window1" in above example,
you have to assign those a new window name before saving your SWS file. It is done by using
"Edit/Change Window title" menu option. Instead ofa default window name, assign window a
name which describes well its usage and can be used in command line calls, for example
"daq_window", "myfft1" or "result".
For detailed information about command-line invocation, please see Reference and Examples