Guralp Systems Limited

Previous Next

Introduction Installation and Configuration The main window Waveview windows Networking Supplementary windows Configuring digitizers Controlling digitizers Recording and playback Printing options  Logging and notification  Extending Scream! Keyboard shortcuts Inside Scream! Revision history

Inside Scream!

Command line options

Options can be prefixed with either a hyphen - or a forward slash / in both Windows and Linux versions. The option names are case insensitive.

-view filespec [filespec...] : Launch in data viewer mode. The files or directories specified are scanned and displayed in a single WaveView window. Whilst Scream! is scanning the files, a small window displays the progress and estimated completion time.

A WaveView window in data viewer mode is identical to a real-time WaveView window, except that

Everything on the command line after -view is treated as a file specifier. If you need to issue other options, place them before -view.

-i:configuration-file : Use configuration-file instead of scream.ini to load Scream!'s settings.

-FlashLED : Flash the Scroll Lock keyboard LED each time a block is received.

-NoSplash : Do not display Scream!'s splash-screen at startup.

-V31 : Force network packets to be in Scream! 3.1 format. Since Scream 4 is backwards compatible with Scream! 3.1, you should not need to use this option.

-nettx : Display a Transmit Data from Network check box in the My Server pane of the Network Control window. When checked, packets received by Scream! over the network will be forwarded on to network clients together with any local data, if they are not already in Scream!'s stream buffer. Warning: there is no way a client can tell if a copy of Scream! is forwarding network packets—instruments will incorrectly appear under the server's serial port icons. You will not be able to configure these instruments, or access their consoles.

-disknn:image-file : Treat the file image-file as a raw SAM/DFD disk, attached to port nn.

-noaspi : On Windows 98, 95 and ME, Scream! uses the Adaptec ASPI drivers provided with the operating system to control SCSI devices. On other operating systems, the ASPI drivers are not available, so Scream! controls the devices directly. Use this switch to force Scream! to control devices directly even if the ASPI drivers are present.

The calvals.txt file

If a file named calvals.txt exists in the same directory as Scream!'s executable (scream.exe), Scream! will look there for suitable calibration values.

Each stream has its own section in the file, headed by the line [instrument-id]. The instrument-id is the string which identifies the digitizer in the left-hand pane, e.g. GURALP-DEMO. It is formed of up to 6 characters (the system identifier) followed by a dash, then up to 4 characters (the serial number.) Scream! and its extension scripts check to see if the streams being received match any of the instruments in the file. If they do, the computer will apply the correct values for your sensor automatically.

You can edit sections of the calvals.txt file within Scream! by right-clicking on a digitizer icon and selecting Calvals....

The format of each section is given in Section 3.8, page 22.

File and directory locations

Windows version

Scream! creates or uses the following files and directories

scream-directory\scream.exe : The program itself.

windows-directory\scream.ini (e.g. C:\WINDOWS\scream.ini) : The configuration file for Scream!. To restore the application to its factory settings, close down all running copies of Scream! and delete this file.

system-directory\qtintf70.dll (e.g. C:\WINDOWS\SYSTEM32\qtintf70.dll) : The Qt shared library which Scream! requires to run.

scream-directory\calvals.txt : The sensor and digitizer calibration information file.

scream-directory\autoload\ : The directory to take auto-load GCF files from (see Section 9.4, page 113.)

scream-directory\data\ : The default directory for recording data (you can change this: see Chapter 9, page 97.)

scream-directory\html\ : The default directory for Scream!'s online help.

settings-directory\Temp\ : (e.g. C:\Documents and Settings\Administrator\Local Settings\Temp\) : The default directory for log files. You can change this: see Chapter 11, page 121.

Linux version

scream-directory/scream : The program itself.

scream-directory/scream.ini : The configuration file for Scream!. To restore the application to its factory settings, close down all running copies of Scream! and delete this file.

library-directory/libborqt-6.9.0-qt2.3.so : The Qt shared library which Scream! requires to run.

scream-directory/calvals.txt : The sensor and digitizer calibration information file.

scream-directory/autoload/ : The directory to take auto-load GCF files from: see Section 9.4, page 113.

scream-directory/data/ : The default directory for recording data (you can change this: see Chapter 9, page 97.

scream-directory/html/ : The default directory for Scream!'s online help.

scream-directory/ : The default directory for log files. You can change this: see Chapter 11, page 121.

Error messages

Unable to detect configuration

Scream! has not been able to retrieve the current configuration from a digitizer. This can happen because

It is recommended that you wait for data to be received from the digitizer before you attempt to configure it.

Unable to save program status

The Scream.ini file could not be opened for writing. This can happen because

Unable to write to stream

An error occurred when Scream! tried to write a data block to the disk. This can happen because

When this error occurs, Scream! disables recording for that stream. To resume recording, first remove the cause of the error, then enable recording again.

If you have Auto Record-Enable for data streams selected, and you replay a recorded file, Scream! will suppress this error message.

Previous Next

Introduction Installation and Configuration The main window Waveview windows Networking Supplementary windows Configuring digitizers Controlling digitizers Recording and playback Printing options  Logging and notification  Extending Scream! Keyboard shortcuts Inside Scream! Revision history