Control (Ctrl)

Once sources have been set up, they are controlled in the following manner. All controls are in the “Ctrl” menubar dropdown, but are most effectively used via the shortcuts.

Start / Stop Source

Starting the will begin pulling data from the source and the plots will start updating. Any previous data in the plots will be cleared.

If multiple sources are set up, they will all be started in parallel.

The data stream will continue until until one of the following:

  • The source is stopped

  • A source error occurs

  • The end of file is reached (if file source)

Pause / Resume Plots

When a source is running (started, but not stopped) it can be paused.

Pausing will stop all the plots from updating, but data acquisition (and potential recording) and all data analysis/processing will continue in the background.

While paused one can freely manipulated the plotted data as if the source was stopped.

Resuming, will make the plots update again including all the processed results while paused.

Start / Stop Recording

Start recording will create a new data file in the recording directory and start streaming data to the file. See recording settings to change the directory.

The software can only record to “.h5”-files, but they can later be converted to other types. See Exporting and File formats.

Recording file name

The recording file is named “SAVA_Recording” followed by a time stamp (format YYYYMMDDhhmmss)

The recording will continue until one of the following:

  • Recording is stopped

  • The source is stopped (or has an error)

  • The max. file length is reached (see recording settings).

When the max. file length is reached a new file is created and the recording continues (no data is lost).

If the source is not already running on start recording, it will be started automatically.

External control

The most basic features of the application can be controlled externally via pipe/socket communication.

The following commands are possible:

  • “start” :Start the source(s)

  • “startRecording” :Start recording (and the source(s) if not already running)

  • “stop” :Stop the source(s) (and recording, if recording)

  • “stopRecording” :Stop Recording

  • “pause” :pause the plots update

  • “resume” :resume the plots update

  • “clearPlots” :clear all the plots

  • “screenCapture :take screendump of the application and save to disk

Tip

An example of how to implement external control (“extCommunication_example.py”) is located at: “Help”->”External Module Examples”.