Scream! is a data visualisation and recording tool. It is not intended for performing detailed analysis on the data received. However, extensions are available for Scream! which can carry out calculations on seismic data. These extensions can be stand-alone programs, or scripts written in MATLAB. Some sample extension scripts are supplied in the Scream! program distribution.
To install a program extension:
Place the program file in a suitable directory, preferably in your PATH (i.e. you can launch it by typing its name at a command prompt.)
Make sure Scream! is not running, and open the scream.ini file (see section 13.3, page 126, for help finding this file.)
Look for a section beginning with the line
[custom]
If it does not exist, add the following lines at the end of the file:
[custom]
SelectionMenu=executable-name
new-extension-name should be the name of the program if it is in your PATH, and the full filename otherwise.
If you want the displayed menu entry to be different from the filename, use the form
[custom]
SelectionMenu=executable-name|displayed-name
e.g.
SelectionMenu=art.exe|ART 2.0 Analysis Package
If the line [custom] exists, add the name of the new extension to the list after SelectionMenu, separating names with commas, e.g.
SelectionMenu=art.exe|ART 2.0 Analysis Package,myextension. exe|My Analysis Extension
To install a MATLAB extension:
Make sure MATLAB 5 or later is installed on your computer, together with the MATLAB signal processing toolbox.
If you have not done so, register MATLAB as an “automation server”. See the MATLAB documentation for more details.
Place the script file in MATLAB's PATH, so that MATLAB can see it.
Make sure Scream! is not running, and open the scream.ini file in Scream!' s directory.
Add the name of the script to the SelectionMenu as detailed above.
When an extension is launched, Scream first saves the data to a file samplesn.txt in the standard temporary directory (using the TEMP environment variable, or /tmp under Linux.) A second file, scrhdr.txt, is saved at the same time, which directs the script to the location of the data. The script or program is expected to fetch the data from this file. If you have problems, make sure that Scream! has the right permissions to create these files, and that your temporary space is not full.
To export data to a Scream! extension:
Open a Waveview window on the stream or streams of interest, and find the data you want to analyse.
Click the Pause button 
to pause the window.
Whilst holding down SHIFT, drag a box across the streams. The selected data will be highlighted. Alternatively, drag with CTRL to select two streams (see “Paused mode”, page 29.)
When you release the mouse button, a menu will pop up showing the extensions available.
Click on the name of the extension you want to run. The standard Scream! package includes a number of useful extensions:
ART Analysis Package : Güralp Systems' suite of tools for strong motion analysis. See the separate ART documentation for full details of this package.
PSD in Velocity Units and PSD in Acceleration Units : These extensions produce instant power spectral density plots of the selected time series.
Sine Wave Calibration and Broadband Noise Calibration : These extensions help you to calibrate sensors using an input sinusoidal or pseudo-random noise signal. These signals can be generated by Güralp Systems DM24 and CD24 digitizers, allowing you to calibrate sensors quickly and easily.
Relative Orientation : This extension applies the Güralp-Blacknest correlation method to determine the orientation of an instrument (usually a borehole instrument.) It uses coherence techniques to estimate the angle between the horizontal components of two sensors, where one is rotated with respect to the other.