SIGVIEW Help Home

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 procedures.

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. First 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 use:

%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 chapters.