Open main menu
SUPPORT DOCUMENTATION

DrumPlot 3.2

DrumPlot is a display and printing utility which presents seismic data as a series of images, creating one page (or set of pages) at regular intervals, configurable between one every ten minutes and one every 24 hours. The data are drawn in 24 rows of one hour each, with a red cursor indicating the last update, as in the sample shown below (click for a full-resolution version):

Sample output from DrumPlot

DrumPlot receives the data by listening on a network port, and creating a 24 hour buffer for each stream received. In this way, it can be an ‘add-on’ for Scream!, offering an alternative output type.

Two output options are available: page print or PNG image generation.

As many streams as desired can be selected independently for printing or image generation. A printout of is automatically generated at midnight UTC, and the PNG images are generated at 00:00 and 12:00 UTC (configurable – see below). An optional post-processor allows user-controlled handling of the generated PNG images (e.g. transferring them via FTP to a web server).

Download

If you have installed Scream, DrumPlot will have been installed as part of the Scream installation. You may still wish to use the links below if you do not have the latest version.

DrumPlot v3.2 for Windows (332 K .zip)

This windows binary uses the QT runtime DLL file qtintf70.dll. This is normally installed with Scream but, if it is not installed on your system, you will receive an error message when you try to run this software. You can download this DLL from here. It should be placed either in the same directory as the program or in the system32 directory.

or

DrumPlot v3.2 for Linux (373 K .gz)

This linux binary needs access to the Qt runtime library (a 2.4 M .gz), either in your normal library path or in the current directory. If the library cannot be loaded, the following error is displayed:
Runtime error 230 at 080677E9 Segmentation fault (core dumped)
This 32-bit linux software runs on 32-bit and 64-bit operating systems. To install it on a 64-bit Linux platform, please follow these instructions to install the relevant libraries.

The program is self contained and stand-alone. It does not need any explicit installation, and can be run "as is". (The Linux version is delivered in gzip format so the command gunzip DrumPlot.gz should be run after downloading the file.)

Installation

The DrumPlot executable can be placed anywhere but a reasonable choice is to place it in the same directory as Scream:

C:\Program Files (x86)\Guralp Systems\Scream4.6\

under Windows or

/usr/lib/Scream4.6/

under Linux.

The program creates configuration and data buffer files in the directory from which it is started. This should not normally be the same location as the executable file. If DrumPlot is used to print .png image files, these are also created in the directory from which it is started. For this reason, it is recommended to create a new directory to hold these files. The user who runs DrumPlot must have permission to create files in this directory.

A number of operational parameters are set by means of command line options. These are defined under "Usage", below.

See below for an explanation of the possible arguments.

Usage

DrumPlot can obtain data to plot in two ways. It always listens on a UDP port so, if you arrange Scream to send data to the correct port, DrumPlot will automatically receive them. In addition, DrumPlot can be configured to pull data over the network from a specified IP address and UDP port, given as command-line options.

The network port that DrumPlot listens on is selected in the following priority order:

  1. The user specifies a command-line option as the port number to listen on. For example: drumplot 1568

  2. DrumPlot searches for a scream.ini file, and uses the port number found there. If DrumPlot is run on the same PC as Scream!, this option will auto-match the ports used by Scream! and DrumPlot.

  3. The default port, 1567, will be used.

By default, Scream and DrumPlot will both try to listen on port 1567 and the second program to be started will, therefore, fail. It is recommended to use a different port for DrumPlot.

DrumPlot can also ‘pull’ data from one or more Scream! servers. To set up a data pull, simply add a parameter to the command-line for each server, in the form -s:a.a.a.a:p, where a.a.a.a is the IP address of the Scream server PC, and p is the port number that the Scream server is listening on. For example, to request data from server 192.168.12.34, port 1567, you might use the command line drumplot 1568 -s:192.168.12.34:1567

If you do not specify a "listening port" on the command line, DrumPlot will try to listen on port 1567. This may cause a conflict if Scream is running on the same PC. In such cases, it is recommended that a "listening port" is specified, as above, even if unused.

The Main Screen

Once running, a window is displayed, which is divided into two areas: a stream list on the left and a waveform display on the right (initially blank):

DrumPlot main screen

The program will pick up all streams from the listening port and from any specified 'pull' sources. For each stream, an entry will be added to the stream list, a buffer file will be created (in the directory from which DrumPlot was started), and the data placed in the buffers.

In the stream list, streams are listed in alphabetical order. To the left of each stream ID is a set of icons:

The features of the main screen, once data are displayed, are shown below:

DrumPlot main screen

Menu options

Above the stream list is a menu.

DrumPlot File menu

The _File Menu options are:

Command-line options

The program's behaviour is controlled by a number of command-line arguments, described below.

Stream selection

If you wish to limit the number of streams displayed and, perhaps more importantly, avoid having to provide buffer space for streams which you will never print, you can provide a list of wanted streams as a command-line option. Specifying

-A:StreamID-1,StreamID-2[,StreamID-n…]

will limit the streams displayed and buffered to only those in the supplied comma-separated list.

Re-draw rate

By default, the on-screen display will refresh every minute with the currently selected file. A red vertical marker indicates the current time (last data received). Any gaps in the data are shown as blank spaces. To change the one-minute default, use the command line option

-redraw:n

where n is the redraw rate in seconds. A value of 0 will cause DrumPlot to refresh the display every time a new block is received, which is the default.

Hard-copy printing

To enable a stream for automatic printout (to the system's default printer) at midnight, click the ‘print’ icon (DrumPlot print icon) to the left of the stream-name. Any number of streams may be selected for printing. A laser printer is recommended to achieve best resolution and performance.

‘Printing’ to .png files

To enable a stream for automatic PNG image generation, click the ‘PNG’ icon (DrumPlot PNG icon) to the left of the stream-name. Any number of streams may be selected for PNG generation. If a post-processor has been installed (see below) then it will be called when the PNG file is created.

The size of the images created are independent of the size of the window, and can be controlled with command-line parameters -imgX:x and -imgY:y, where x and y are the width and height of the generated image, in pixels. For example, to generate PNG images that are 640×480, use the command line

drumplot -imgX:640 -imgY:480

If you do not specify a size, the resulting images will be 512 pixels wide and 400 pixels high.

Print frequency

By default, an image will be generated every 12 hours. To change this, use the command line option -genpng:n, where n is the interval between image generation in minutes. The valid range is from 10 minutes to 24 hours (1440 minutes).

Post-processing

To use the post-processor option for PNG images:

DrumPlot calls this program each time it generates a PNG image, passing the PNG file-name as a parameter.

This program can be used for may different purposes. The most common application, however, is to transfer the generated file to a web-server for display. A sample Windows program to do this using FTP can be downloaded from here. It consists of a program, ftpfile.exe, and a template configuration file, ftpfile.ini. Fill in the blanks in the configuration file to specify the FTP options.

The file ftpfile.ini should be placed in the directory from which DrumPlot is started. The file ftpfile.exe should be placed in the same directory as DrumPlot.

Technical notes

For more information, first contact your local distributor or email .