NAME

dbbuild tables - description of sensor and data logger parameter files for dbbuild

DESCRIPTION

dbbuild(1) uses parameter file descriptions of data loggers and sensors to help interactively build a database from scratch. The user must provide installation information like station (and perhaps channel) names, station location, sensor orientation, and sensor and data logger serial numbers. The user must also choose the data logger and sensor models from the list supported by dbbuild. When a particular model is not already supported, the user must first construct files which describe the data logger and/or sensor, and install these files in the proper directories.

Because the names of these files are saved into the calibration database table, the parameter file names must be less than 32 characters (not counting the .pf suffix).

This document describes the format of the data logger and sensor parameter files.

Sensor Descriptions

Sensor description files must provide the following information:

Data logger Descriptions

Data logger description files provide the following information:

EXAMPLE

This is an example of a sensor parameter file. The response file is contained in the file $ANTELOPE/data/responses/example.

description     a non-existent sensor
dfile   example

rsptype V       # velocity instrument
band    b       # broad band

gtype           sensor
gnom            15e-7  # equivalent to 1500 V/m/sec sensor
iunits          nm/s
ounits          V

orientations    &Tbl{
Z       0       0
N       0       90
E       90      90
}

response        &datafile(responses/example)

Here's an example of a data logger parameter file which contains a possible_streams subroutine.

description     some non-existent data logger
dfile RT130

streams         200sps 100sps 40sps 20sps 10sps 5sps 1sps

# definitions of streams
200sps  200  cf1 cf2 cf2 cf2 cf2 cf2 cf3
100sps  100  cf1 cf2 cf2 cf2 cf2 cf2 cf3 RT72A_2_f
40sps    40  cf1 cf2 cf2 cf2 cf2 cf2 cf3 RT72A_5_f
20sps    20  cf1 cf2 cf2 cf2 cf2 cf2 cf3 RT72A_5_f RT72A_2_f
10sps    10  cf1 cf2 cf2 cf2 cf2 cf2 cf3 RT72A_5_f RT72A_2_f RT72A_2_f
5sps      5  cf1 cf2 cf2 cf2 cf2 cf2 cf3 RT72A_5_f RT72A_2_f RT72A_2_f RT72A_2_f
1sps      1  cf1 cf2 cf2 cf2 cf2 cf2 cf3 RT72A_5_f RT72A_2_f RT72A_2_f RT72A_2_f RT72A_5_f

possible_streams &Literal{
    my @chosen = @_ ;
    my @ok = () ;
    my %chosen ;
    foreach (@chosen) {
        $chosen{$_} = 1 ;
    }
    if ( defined $chosen{"200sps"}
        || defined $chosen{"40sps"}
        || defined $chosen{"20sps"} ) {
        @ok = qw(200sps 40sps 20sps) ;
    } elsif ( defined $chosen{"100sps"}
        || defined $chosen{"10sps"}
        || defined $chosen{"5sps"}
        || defined $chosen{"1sps"} ) {
        @ok = qw(100sps 10sps 5sps 1sps) ;
    } else {
        @ok = qw(200sps 100sps 40sps 20sps 10sps 5sps 1sps) ;
    }
    return (@ok) ;
}

# Stages
a/d     &Arr{
samprate        102400
gtype           digitizer
gnom            526315  # in units of counts/volt
iunits          V
ounits          counts
}

cf1     &Arr{
gtype   FIR_decimator
decifac 8
response        &datafile(responses/cf1)
}

cf2     &Arr{
gtype   FIR_decimator
decifac 2
response        &datafile(responses/cf2)
}

cf3     &Arr{
gtype   FIR_decimator
decifac 2
response        &datafile(responses/cf3)
}

RT72A_5_f       &Arr{
gtype   FIR_decimator
decifac 5
response        &datafile(responses/RT72A_5_f)
}

RT72A_2_f       &Arr{
gtype   FIR_decimator
decifac 2
response        &datafile(responses/RT72A_2_f)
}

SEE ALSO

dbbuild(1)

AUTHOR

Daniel Quinlan

Table of Contents
Antelope Release 4.6 Linux 2.4.19-4GB 2004-11-01
Boulder Real Time Technologies, Inc For more information, contact support@brtt.com