Band type
Selects one or several band types
| Usage: | BAND | BANDS |
BANDS |
List of band codes separated by spaces, commas, colons, or semicolons. Example: "B,S,LH" |
|
Channel type
Selects one or several channel (component) types
| Usage: | CHANNEL | CHANS |
CHANS |
List of band codes separated by spaces, commas, colons, or semicolons. Unix-style wildcards are allowed. Keyword "=all=" corresponds to all channels (equivalent to "*"). Examples: "BHZ,*N,B?E", "=all=" |
|
Database tables
This list specifies custom database table names used by SOD
| Usage: | DBTABLE | WHAT NAME |
WHAT |
Type of table whose name is given in NAME |
|
NAME |
Name of the table in the database. By default, "$stations" is used for station table, "$networks" - for network table, "$channels" - for channel table, "$events" - for event table. |
|
Dictionary
Provides descriptions of database table and field names, and also elements of the local SQL flavor. This dictionary is specific to SOD and used before the dictionary included in DBASE call
| Usage: | DICTNRY | (No parameters) |
IDENT |
Common identifiers assigned to table and column names, time stamp formats, etc. |
|
VALUE |
Replacement for IDENT in the current database |
|
Distance
Restricts the origin-receiver distance
| Usage: | DIST | MIN MAX |
MIN |
Minimum distance, in current units (values <= 0.0 mean no limit) |
|
MAX |
Maximum distance, in current units (values <= 0.0 mean no limit) |
|
Azimuth (origin-station)
Restricts the origin-station azimuth range
| Usage: | ESAZ | MIN MAX |
MIN |
Minimum azimuth, in degrees, measured from the direction to the North eastwise |
|
MAX |
Maximum azimuth, in degrees, measured from the direction to the North eastwise |
|
Origin
Restricts the origin time and coordinates
| Usage: | EV-AREA | LONMIN LONMAX LATMIN LATMAX DEPTMIN DEPTMAX |
LONMIN |
Minimum longitude of the origin (deg) |
|
LONMAX |
Maximum longitude of the origin (deg) |
|
LATMIN |
Minimum latitude of the origin (deg) |
|
LATMAX |
Maximum latitude of the origin (deg) |
|
DEPTMIN |
Minimum depth of the origin (km) |
|
DEPTMAX |
Maximum depth of the origin (km) |
|
Additional event area blocks
LONMIN |
Minimum longitude of the origin (deg) |
|
LONMAX |
Maximum longitude of the origin (deg) |
|
LATMIN |
Minimum latitude of the origin (deg) |
|
LATMAX |
Maximum latitude of the origin (deg) |
|
DEPTMIN |
Minimum depth of the origin (km) |
|
DEPTMAX |
Maximum depth of the origin (km) |
|
Event grid
Selects events near regular grid points. All events are checked for proximity to the grid points. For each grid point, and only one event nearest to it is used
| Usage: | EV-GRID | MAXDIST LON0 LAT0 LONINC LATINC |
MAXDIST |
Maximum distance from the grid points considered. Negative values mean no limit. |
|
LON0 |
Longitude of the origin of the grid, relative to the western edge of event area. Note that this value only gives an offset within the [0,LONINC] range. The whole event will be covered with grid points. |
|
LAT0 |
Latitude of the origin of the grid, relative to the southern edge of event area. Note that this value only gives an offset within the [0,LATINC] range. The whole event will be covered with grid points. |
|
LONINC |
Longitude increment in the grid |
|
LATINC |
Latitude increment in the grid |
|
Event magnitude
Selects one or several events from various catalogs
| Usage: | EV-MAG | MAGMIN MAGMAX CATALOG |
MAGMIN |
Smallest selected magnitude (values <= 0.0 mean no limit) |
|
MAGMAX |
Largest selected magnitude (values <= 0.0 mean no limit) |
|
CATALOG |
Catalog names, separated by spaces, commas, or semicolons. Unix-style wildcards are allowed. Name "=all=" means all catalogs known on the server. |
|
CATALOG |
Continuation of the catalog list. |
|
Event Time
Restricts the origin time(s)
| Usage: | EV-TIME | FORMAT |
FORMAT |
SQL-style time format string for the input and output times |
|
START |
Start date and time of origin selection |
|
END |
End date and time of origin selection |
|
Extract
This list extracts data traces and saves metadata tables received from the database in text files
| Usage: | EXTRACT | WHAT FNAME |
WHAT |
Item to extract: |
|
FNAME |
File name for saving each item. This file name may include "%d" token for the number of the SOD session. For example, name "network.%d.txt" will save network lists in files "network.1.txt", "network.2.txt", etc. |
|
Network
Selects one or several networks. Use this list if you whish to specify a networks explicitely. Normally, networks are obtained from the lists of stations.
| Usage: | NETWORK | NAMES |
NAMES |
List of network codes separated by spaces, commas, colons, or semicolons. Example: "II,IU,SR". Name "=all=" means all networks known on the server. |
|
NAMES |
Continuation of the network list. |
|
Azimuth (station-origin)
Restricts the station-azimuth azimuth range
| Usage: | SEAZ | MIN MAX |
MIN |
Minimum azimuth, in degrees, measured from the direction to the North eastwise |
|
MAX |
Maximum azimuth, in degrees, measured from the direction to the North eastwise |
|
SQL query
Appends an arbitrary SQL string to the query
| Usage: | SQL | (No parameters) |
SQLSTR |
One line of the SQL string. All lines are concatenated. |
|
Station area
Restricts the geographic area of stations
| Usage: | ST-AREA | LONMIN LONMAX LATMIN LATMAX |
LONMIN |
Minimum longitude of the origin (deg) |
|
LONMAX |
Maximum longitude of the origin (deg) |
|
LATMIN |
Minimum latitude of the origin (deg) |
|
LATMAX |
Maximum latitude of the origin (deg) |
|
Additional station area blocks
LONMIN |
Minimum longitude of the origin (deg) |
|
LONMAX |
Maximum longitude of the origin (deg) |
|
LATMIN |
Minimum latitude of the origin (deg) |
|
LATMAX |
Maximum latitude of the origin (deg) |
|
Station names
List of stations to request by name
| Usage: | ST-NAME | NAMES |
NAMES |
List of items to select, separated by spaces, commas, colons, or semicolons. Dots may indicate names of tables, for example: "TABLE1.entry1, TABLE2.entry2" |
|
NAMES |
Continuation of the selection list |
|
Stand
Specifies the intervals between periodic re-checking the database and time of termination
| Usage: | STAND | TINT COUNT END |
TINT |
Time interval between re-checking the db, in minutes |
|
COUNT |
Name of integer trace header in which the session counter is written. At the beginnging, this counter is set eqqual 1, and incremented each time SOD wakes up. By using this counter, you can separate the incremental outputs into different files. |
|
END |
Date/time string at which to stop checking for new data, in "Month Day, Year Hour:Min:Sec" format (Example: Aug 24, 2009 12:00). If no end time is given but TINT > 0, the process never stops. |
|
Time gate
Specified the time gate of interest. Both start and end times may be set relative to the origin time or to the time of arrivals in ISAP91 model.
| Usage: | TGATE | START TSTART END TEND KEY KEYVAL MODEL |
START |
Base time relative to which the beginning of the arrival time range is specified |
|
TSTART |
Start of the waveform time window, in current time units |
|
END |
Base time relative to which the end of arrival time range is specified |
|
TEND |
End of the waveform time window, in current time units. If time end turns out to be earlier than start, no waveform data is retrieved. |
|
KEY |
Name of an integer trace header created in the output traces in order to differentiate between multiple time gates extracted. |
|
KEYVAL |
Value set in KEY header field in output traces |
|
MODEL |
Earth model in which the travel-times are calculated |
|
Traces
Parameters of the output traces (waveform anchors). These trace headers can also be used for quick plotting without contacting the database again.
| Usage: | TRACES | EVID EVLON EVLAT STID STLON STLAT CHID WFTAB TRID DIST SAMPINT |
EVID |
Name of integer trace header in which the event ID number is output (corresponding to the primary key of event table in the database |
|
EVLON |
Name of trace header in which event longitude is output |
|
EVLAT |
Name of trace header in which event latitude is output |
|
STID |
Name of integer trace header in which the station ID number is output (corresponding to the primary key of station table in the database |
|
STLON |
Name of trace header in which station longitude is output |
|
STLAT |
Name of trace header in which station latitude is output |
|
CHID |
Name of integer trace header in which the channel ID number is output (corresponding to the primary key of channel table in the database |
|
WFTAB |
Name of character trace header in which the name of waveform table in the database is output |
|
TRID |
Name of integer trace header in which the trace ID number in table WFTAB is output (this entry corresponds to the the primary key of trace table in the database) |
|
DIST |
Name of floating-point trace header to output the source-receiver distance. |
|
SAMPINT |
Sampling interval for the output anchor trace. Its value is usually not important. |
|
Trace table
Obtains trace parameters from the specified database table
| Usage: | TRCTAB | TABNAME |
TABNAME |
Name of database table from which the traces are taken. If the table name is given as "=generate=", traces are generated for each origin-station pair and arrival time window |
|