NAME

trdefaults.pf - default initialization values for the trace library

DESCRIPTION

The trace library specializes in the manipulation of trace data, especially reading and writing data between databases on disk and an internal database specially designed for trace manipulation. A few of the default values may occasionally need to be overridden for some special purpose. The trdefaults parameter file provides a central location to perform such modifications. It also figures in the procedure for adding a new waveform type.

Foreign Keys

When importing and exporting data, some data may use keys other than station and channel codes to uniquely identify a datastream. SEED uses net and loc codes to disambiguate these situations; autodrm uses net and aux codes. The css 3.0 schema uses only sta and chan to uniquely identify a data stream, and does not include net and loc codes. This might lead potentially to multiple data streams with the same sta and chan codes.

Antelope addresses this problem by providing a mechanism for folding the network code into the station key, and the loc/aux code into the channel key, when required. This is handled by the routines map_autodrm_netsta(3), map_seed_chanloc(3), map_autodrm_chanaux(3), map_seed_netsta(3), autodrm_net(3), seed_net(3), autodrm_aux(3), and seed_loc(3).

These routines first consult the foreignkeys database, the location of which is specified here. This database provides explicit mappings between foreign and local keys. If no mapping exists in the database, the routines consult defaults from trdefaults.

When mapping from foreign keys into local keys, the lists seed_net_sta, seed_sta_chan_loc, autodrm_net_sta, and autodrm_sta_chan_aux provide default mappings using regular expressions. Each entry in the list consists of a regular expression followed by the appropriate remapping. (See morphtbl(3) for more examples). For each list, a name is formed by joining the appropriate keys (i.e., net and foreign station code fsta) with underscores (i.e., net_fsta). Then the list is inspected for a matching regular expression. If a match is found, the corresponding remapping is used to obtain the local key (either sta or chan).

If a match is found, and the foreignkeys database is writable, the routines add an appropriate entry to that database.

When mapping from local keys into foreign keys, the foreignkeys database is first consulted. If no match is found, then the values of default_autodrm_network, default_aux_code, default_seed_network, and default_loc_code are used.

Unlike the the foreign to local mapping, entries are not automatically added to foreignkeys tables by the inverse (local to foreign) mapping. trmapnames(1) can also be used to show this inverse mapping.

You can interactively query the foreignkeys database (or add to it) with the program trmapnames(1).

autodrm

LIBRARY

$(TRLIBS)

SEE ALSO

trsave_wf(3)
trsplice(3)
orb2db(1)
autodrm_net(3)

BUGS AND CAVEATS

PFPATH can be used to override the default location of this file.

AUTHOR

Daniel Quinlan

Table of Contents
Antelope Release 4.11 Linux 2.6.22.5-31-bigsmp 2010-01-13
Boulder Real Time Technologies, Inc For more information, contact support@brtt.com