NAME

dbbuild - build the station related tables for a css3.0 database

SYNOPSIS

dbbuild [-v] [-p pf] db [template|input-file]
dbbuild [-v] [-p pf] -b db input-file ...

DESCRIPTION

dbbuild assists in creating or adding to the CSS 3.0 tables which describe the stations and instruments: site, sitechan, sensor, instrument, calibration, stage, snetsta and schanloc. It uses a database of parameter files for dataloggers and sensors. These parameter files specify nominal responses and other characteristics of the instruments. The user must select the instruments used, specify the station name, location and orientation, and specify the configured sample rates. Then dbbuild constructs the relevant records in the various tables to correspond with these specs.

There are two modes, interactive and batch. The interactive mode presents a GUI where the user specifies the necessary input information. In batch mode, the user supplies the same information using a simple command language, defined in dbbuild_batch(5).

After successfully adding new records to a database, dbbuild creates or appends to a configuration file associated with the database, and named after it: db-dbbuild. This configuration file can be a record of the database creation, and can be run as a dbbuild batch file to recreate the core tables.

Using dbbuild

Start dbbuild, providing the name of the database to which you wish to add new stations or new configurations. There are three panels: Station, Sensor and Data Logger.

OPTIONS

FILES

Certain characteristics of data loggers and sensors are provided to dbbuild in a parameter file format, one file per sensor or data logger variety. (If an instrument is an integrated sensor and data logger, like a Kinemetrics K2, then both a sensor parameter file and a data logger parameter file are required). dbbuild(5) contains the detailed description of the contents of these files, which are primarily response information, but also other configuration information.

PARAMETER FILE

The instrument parameter files (for sensors and data loggers) are described in dbbuild(5). However, dbbuild itself has a simple parameter file containing the following parameters:

SEE ALSO

dbbuild(5)
dbbuild_batch(5)
dbbuild_examples(5)

BUGS AND CAVEATS

The dbbuild software facilitates construction of the station side of the database. We have made an effort to verify the datalogger and sensor parameters which together with the user specs are the raw materials used to construct the database. However, the user must themselves verify that the provided parameters are correct and adequate for their instruments. If you believe a parameter is wrong, please notify support@brtt.com. However, many dataloggers and sensors come in a variety of configurations, and responses and sensitivities may have changed. You must check the calibration and response from the database against your instruments.

AUTHOR

Daniel Quinlan

Table of Contents
Antelope Release 4.8 Darwin 8.7.0 2006-09-26
Boulder Real Time Technologies, Inc For more information, contact support@brtt.com