NAME

dbbuild_batch - commands for running dbbuild non-interactively

SYNOPSIS

dbbuild -b [-v] db input

DESCRIPTION

The batch mode of dbbuild reads input from files and adds to the database db accordingly. Primarily, the input specifies settings for the various entries on the interactive window. Then (as with the interactive gui) once the parameters are set properly, the input command add generates the appropriate rows in site, sitechan, sensor, instrument, stage, calibration, snetsta and schanloc.

COMMANDS

Generally speaking, the batch commands should appear in the same order as the corresponding fields on the dbbuild user interface window: time, net, sta, datalogger, sensor, axis, samplerate, channel. However, the sensor, axis, samplerate and channel statements may appear multiple times. When at least one sensor has been specified, there is always a selected sensor, and a selected axis (component) of that sensor. Following statements apply to the selected sensor and axis, until a new sensor is selected. (The axis statement causes the next component of the sensor to be selected on the completion). Axis statements must proceed channel statements.

Similarly, when at least one samplerate has been specified, there is always a selected samplerate. Channel statements apply to this selected samplerate.

For convenience in specifying networks with a standard instrument setup, it is possible to specify the datalogger and sensor configuration first, and then to have a series of statements which modify only certain variable elements of the configuration: the start time, the station coordinates, the serial numbers, and perhaps individual sensor component gains.

The commands have positional parameters; when you're modifying just one of several positional parameters, you may use a dash "-" for other parameters, to avoid repeating or changing the existing value for those other parameters.

General Commands

Network and Station parameters

Data logger parameters

Sensor parameters

Each axis statement specifies settings for the selected instrument and the axis with the currently specified label. To simply associate a sensor axis with a particular set of leads, as when the actual sensitivities and dataloggers gains will be looked up in a serial number specific parameter file, you might use an axis statement like this:


axis N - - - ch2

FILES

By default, the dbbuild database is kept in $ANTELOPE/data/instruments; however this may be changed in the dbbuild parameter file.

EXAMPLE

% cat input
time  1/01/1995   0:00:00.000
net XA Fake example of field miniseed volume
sta AAK   42.6333   74.4944    1.6800 Ala-Archa, Kyrgyzstan

datalogger rt130 aak-rt130-serial X1_101 # Reftek 130 Datalogger

sensor sts2 0.0 aak-sts2-serial  # Streckeisen STS-2
   samplerate 20sps
    channel Z  BHZ -   213_21
    channel N  BHN -   212_21
    channel E  BHE -   211_21
add

sta ADK   51.8837 -176.6844    0.1160 Adak, Aleutian Islands, Alaska
rt130 adk-rt130-serial X1_121

sts2 0.0 adk-sts2-serial
   samplerate 20sps
    channel Z  BHZ -   213_21
    channel N  BHN -   212_21
    channel E  BHE -   211_21
add

% dbbuild -v -b db input

: loading input
->
-> time  1/01/1995   0:00:00.000
-> net XA Fake example of field miniseed volume
-> sta AAK   42.6333   74.4944    1.6800 Ala-Archa, Kyrgyzstan
->
-> datalogger rt130 aak-rt130-serial X1_101 # Reftek 130 Datalogger
->
-> sensor sts2 0.0 aak-sts2-serial  # Streckeisen STS-2
->    samplerate 20sps
->     channel Z  BHZ -   213_21
->     channel N  BHN -   212_21
->     channel E  BHE -   211_21
-> add

Added 3 records to calibration
Added 1 records to instrument
Added 1 records to network
Added 3 records to sensor
Added 1 records to site
Added 3 records to sitechan
Added 33 records to stage
->
-> sta ADK   51.8837 -176.6844    0.1160 Adak, Aleutian Islands, Alaska
-> rt130 adk-rt130-serial X1_121
->
-> sts2 0.0 adk-sts2-serial
->    samplerate 20sps
->     channel Z  BHZ -   213_21
->     channel N  BHN -   212_21
->     channel E  BHE -   211_21
-> add

Added 3 records to calibration
Added 3 records to sensor
Added 1 records to site
Added 3 records to sitechan
Added 33 records to stage

SEE ALSO

dbbuild(1)
dbbuild(5)

AUTHOR

Daniel Quinlan

Table of Contents
Antelope Release 4.7 Darwin 7.9.0 2005-07-19
Boulder Real Time Technologies, Inc For more information, contact support@brtt.com