AutoDRM User Guide

The User Guide describes the method and commands used by the GeoNet AutoDRM facility to query or retrieve seismic data.

Sending and receiving electronic mail from AutoDRM

Commands:

• AMI
• ARRIVAL
• AVAIL
• BEGIN
• BULLETIN
• CALIB
• CHAN_LIST
• CHANNEL
• DATE1
• DATE2
• DETEC
• EMAIL
• FTP
• GUIDE
• MSG_ID
• MSG_TYPE
• ORIGIN
• OUTAGE
• PPICK
• RESPONSE
• SLIST
• STA_LIST
• STATION
• STOP
• TIME
• TITLE
• WAVEF
• WAVEFORM

Sending and receiving electronic mail from AutoDRM

In order to obtain seismic data from GeoNet, you simply send an electronic request mail to the Automatic Data Request Manager (AutoDRM). Send your request emails to autodrm @ geonet.org.nz

The request e-mail must contain commands (starting at column 1), depending on what you would like to receive.

Minimum requirements are:

• the first line must start with: BEGIN
• any line in between starts with: EMAIL email-address
• the last line starts with: STOP

where `email-address` is your e-mail address.

The response of the AutoDRM is sent to you via electronic mail. For requests which result in large responses (> ~ 100 kilobytes), you must specify an option (FTP), the response is stored at our computer and you only get a short e-mail, providing you with the filename of the response and a detailed description on how you may transfer the response file by yourself to your computer using FTP (File Transfer Protocol).

In order to avoid endless loops and other inconvenient things, no response mails are sent to requestors with the name POSTMASTER, MAILER-DAEMON or AUTODRM. Furthermore, an identical request from the same user is not processed if the second request arrives within the same 10 minutes.

Commands

The following commands are available through the AutoDRM (not all commands may be implemented yet).

Note:

• All command lines must start on column 1.
• The BEGIN command is absolutely necessary (unless you send the HELP command).
• The commands WAVEF, DETEC, AVAIL and PPICK must be preceded by either the TIME or the DATE1 and DATE2 commands.
• AUTODRM response mails are limited to a size of approximately 100 kilobytes UNLESS the FTP-option is used. If your request would produce a larger response mail, the number of waveforms sent will automatically be reduced and an error message will appear. Therefore use the FTP-option or SPLIT your requests (see below).
• A request mail may contain several requests; each request must start with the command BEGIN, must end with the command STOP and should have the command EMAIL with the e-mail address. The response of each request is sent by a separate e-mail in order to keep the message size small.
• Only one time interval (DATE1 and DATE2) per request is allowed, if you use the old 'WAVEF stn'; if you use the STA_LIST and TIME environment, followed by the WAVEFORM command, you may use multiple TIME intervals!
• The presence of a SUBJECT in the incoming request mail is not necessary. However, if there is a subject, it is ignored.

BEGIN

First line in every request to AutoDRM. This command will cause the AutoDRM to respond in the 'old' AutoDRM-language. However, AutoDRM understands both request commands in the old and the new (GSE2.0) format.

BEGIN GSE2.0

First line in a GSE2.0-request. This command causes the AutoDRM to respond in the 'GSE2.0-AutoDRM-language'. However, AutoDRM understands both request commands in the old and the new (GSE2.0) format.

MSG_TYPE request

Should be the second line of a request, if user wants to follow GSE2.0 formats.

MSG_ID your_msg_id source_id

Third line of a request message, if user wants to follow GSE2.0 formats. The message_ID of the sender; may be up to 20 characters long. This message_id and the source_id will appear as the reference_id (REF_ID) in the response! The source_id's are specified in the GSE2.0 documentation (maximum 7 characters).

EMAIL email@address.of.the.user

E-Mail address where response should be sent to.

E-MAIL email@address.of.the.user

Same as EMAIL command.

E_MAIL email@address.of.the.user

Same as EMAIL command.

GUIDE

Send the user's guide.

INFOR

Same as GUIDE command.

HELP

Same as GUIDE command.

FTP email@address.of.the.user

Instead of the 'E-MAIL' command: Send only short note via e-mail to the requestor and store the response locally on ftp-directory.

TIME [StartDateTime] TO [EndDateTime]

Definition of Start- and End-DateTime Format: 1994/02/24 16:23:50.20 If EndDateTime is omitted, the current DateTime is assumed. Instead of the TIME command you may also use the DATE1 and DATE2 commands.

DATE1 yyyymmddhhmm

Define start of the time interval ('yyyy': year, 'mm': month, 'dd': day, 'hh': hour, 'mm': minute; Example: 24 Feb 1992 15:46 is: DATE1 199202241546).

DATE2 yyyymmddhhmm

Define end of the time interval ('yyyy': year, 'mm': month, 'dd': day, 'hh': hour, 'mm': minute; Example: 24 Feb 1992 15:46 is: DATE2 199202241546).

STA_LIST ABC [,DEFG] [,HIJK]

Definition of stations desired (multiple station codes must be separated by commas). No default.

CHAN_LIST SHZ [,SHN] [,SLZ]

Definition of channels desired (multiple channel IDs must be separated by commas). Default: *Z

WAVEFORM [GSE2.0|SEED|MSEED]

Get waveforms for specified Time/Channels Waveforms are supplied from our continous recordings - if no continous data is available, the event-file archive is searched for data. Data may be requested in the following formats GSE2.0, SEED, MSEED (miniSEED).

WAVEF stn

Similar to command WAVEFORM GSE2.0, but no STA_LIST is required (station stn is defined on the command line). Valid station names may be obtained using the command SLIST (see there). Multiple lines with this command (for additional stations) are allowed. This command must be preceded by either the command TIME or the commands DATE1 and DATE2.

STATION GSE2.0

Get station-info for specified stations (specifiy by using STA_LIST and CHAN_LIST environment commands).

CHANNEL GSE2.0

Get channel-info for specified channels (specifiy by using STA_LIST and CHAN_LIST environment commands).

RESPONSE GSE2.0

Get response-data (calibration) of the specified stations/channels (specifiy by using STA_LIST and CHAN_LIST environment commands).

BULLETIN GSE2.0

Get bulletin-data for the specified TIME environment.

ORIGIN GSE2.0

Get origin-data for the specified TIME environment.

ARRIVAL GSE2.0

Get arrival-data for the specified TIME environment.

CALIB stn

Similar to command RESPONSE GSE2.0, but but no STA_LIST is required (station stn is defined on the command line). The calibration is sent as poles and zeros (PAZ) plus a scale factor and allows you, to deconvolute the received waveform into displacement. If a DATE1 command is received, then the transfer function for this date is sent; otherwise the transfer function for the current date is used (Note: At the Swiss Seismological Service we keep track of any changes in the transfer functions with respect of time). Multiple lines with this command (for additional stations) are allowed.

OUTAGE GSE2.0

Get outage-info on specified channels (TIME and STA_LIST environment required).

TITLE your subject

The response mail returned to you will have the subject you specify here; if not specified, a default subject is used (Swiss AUTO_DRM Response).

SUBJE your subject

Same as command TITLE.

DETEC

Send a list of all detections (and locations, if the event was located) made within the specified time interval. (For each detection we store 180 seconds of data of all channels.) This command must be preceded by either the command TIME or the commands DATE1 and DATE2.

AMI A

Send a list of the most recent locations of the 'Alert Message Informations received. Locations possibly belonging to same event are grouped together. Optionally a time interval (TIME or DATE1 and DATE2) may be specified to filter the output. If no time interval is specified, the first 100 lines are sent.

PPICK stn

Send the P-picks of station 'stn' for all the detected events within a time interval. The P-picks (arrival times) are marked as 'manual' or 'automatic' picks. This command must be preceded by either the command TIME or the commands DATE1 and DATE2.

AVAIL

Send a list of detections (without locations) of which (within the specified time interval) waveform data is available. This command must be preceded by either the command TIME or the commands DATE1 and DATE2.

SLIST

Send a list of stations for which waveforms and/or calibration data is available. The station list also contains the coordinates of the stations.

STOP

This must be the last line of any request.

This information is based on the original user guide from the Swiss Seismological Service, 17 June 1998.