• Antelope Release 5.4 Mac OS X 10.8.5 2014-05-02

 

NAME

dbevents_pre - New version of dbevents

SYNOPSIS

dbevents_pre [-pf pfname] dbname

DESCRIPTION

dbevents_pre displays seismic events out of a Datascope relational database, updating the view as the Database changes. The dbevents_pre display is divided into sevaral horizontal sections. After the menubar and clock at the top row, an event banner shows vital statistics for the event being viewed, including magnitude, geographic region, lat/lon/depth, and time since the event (shown as "T + delta" where delta is a string indicating the time elapsed since the event's origin time, as determined from the computer's internal clock). The event banner's information comes from the currently-selected preferred origin for the event. The magnitude shown by the event banner is a "best guess" as described below for the function:bestmag_string capability of the events_spreadsheet_columns parameter. The next panel consists of a "Focus Map" on the left, then an information-panel on the right. The focus map shows the hypocenter and detecting stations for the event currently highlighted. The information panel shows vital statistics for this earthquake as well as a table of data for each hypocentral solution for the earthquake. Contents of this table are specified in the dbevents_pre parameter file. The information panel contains a table in the upper right showing the latest magnitudes announced by each author for the given earthquake. From left to right the magnitudes are listed in order specified by the magnitude_preference_order parameter of the paramter file. If any of the authors for this latest-magnitude table match regular expressions used as keys in the author_translations array of the dbevents_pre parameter file, the short author name is displayed instead of the actual auth field, and magnitudes for all authors matching this regular expression are coalesced into a single row. If a color is specified for this author in the colors array of the parameter file, the row of the latest-magnitudes table is colored accordingly. Below the latest-magnitudes table, the information panel contains a section for the "best" moment tensor. If there is a moment tensor stored in the mt table associated with the current preferred origin, that moment tensor is displayed. Otherwise, the latest moment tensor issued for any hypocenter for this event is displayed. The bottom panel consists of a regional or global overview map, then a spreadsheet of data with one entry per seismic event. The contents of the spreadsheet are customizable via the dbevents_pre parameter file. Below the bottom panel a status bar shows how long it has been since the database changed (as judged by a subset of monitored tables listed in the parameter file), as well as the names of the tables most recently changed.

OPTIONS

PARAMETER FILE

Parameter-file Parameters

Parameter-file Example


allow_edits              yes

time_format              %Y-%j (%d %b)  %H:%M:%S %Z
timezone                 GMT

topheight_pixels         600
bottomheight_pixels      400

center_focusmap          focusevent
center_overviewmap       40:-115

dist_deg_focusmap        60
dist_deg_overviewmap     180

update_interval_sec      5
clock_tick_sec           1

show_waveforms           0
dbpickgeom               480x662-100+100
dbpicktypeingeom         100x20-0-0
dbpick_nchannels         33
dbpick_phases            P,pP,S
dbpick_filter            0
dbpick_twin_sec          4000
dbpick_tstart_sec        -800.0
dbpick_additional        swa

station_symbol           triangle

focus_event_symbol       beachball | star
overview_event_symbol    beachball | square

focus_station_size       8
focus_event_size         16
focus_event_bb_size      16

overview_station_size    4
overview_event_size      2
overview_event_bb_size   8

magnitude_precision      .1

magnitude_preference_order &Tbl{
        mw
        mww
        mwb
        mwp
        mwr
        me
        mi
        mn
        ml
        ms
        mb
        md
        mlg
        mblg
}

monitor_tables &Tbl{
        event
        origin
        origerr
        netmag
        mt
}

author_translations &Arr{
#       Regex           Short-name      Long-name
        Ot.*                Antelope        Antelope Real-time System
        USGS.*                USGS                U.S. Geological Survey
        SCSN.*                SCSN                Southern California Seismic Network
        NCSN.*                NCSN                Northern California Seismic Network
        CERI.*                CERI                Center for Earthquake Research and Information
        GSC.*                 GSC                 Geological Survey of Canada
        NBE.*                 NBE                 Nevada Seismological Laboratory
        LCSN.*                LCSN                Lamont-Doherty Cooperative Seismographic Network
        MTECH.*               MTECH               Montana Tech
        UUSS.*                UUSS                University of Utah
}

colors &Arr{
        activebackground           darkgray
        activeforeground           red
        default                    #e0e0e0
        background_evenrows        #f0f0ff
        background_eventbanner     chartreuse
        background_infopanel_focus white
        background_oddrows         white
        background_selected        chartreuse
        background_statusbar       #ffe0e0
        background_scrollbar       lightblue
        boundaries_national        red
        boundaries_minor           #ff00ff
        boundaries_provincial      #00a000
        fill_land                  #fff2e5
        fill_water                 #e0e0ff
        focus_event_bb_fill        yellow
        focus_event_fill           chartreuse
        focus_event_outline        black
        overview_event_bb_fill     yellow
        overview_event_fill        blue
        overview_event_outline     black
        rowedit_warning            red
        station_assoc_fill         lightgreen
        station_defining_fill      blue
        station_fill               gray
        station_outline            black
        USGS                       wheat
        Antelope                   alice blue
        SCSN                       seashell
        NCSN                       honeydew
        CERI                       ivory
        GSC                        pink
        NBE                        light yellow
        LCSN                       mint cream
        MTECH                      light coral
        UUSS                       light salmon
        warning_editable           orange1
}

fonts &Arr{
        spreadsheet                helvetica 10
        statusbar                  helvetica 16
        eventbanner                helvetica 16
        infopanel                  helvetica 12
        infopanel_titles           helvetica 10 bold
}

origins_spreadsheet_columns &Tbl{
        &Arr{
                name                pref
                displayfield        orid == prefor ? "*" : ""
        }
        &Arr{
                name                author
                displayfield        function:short_author
                anchor              w
                width               15
        }
        &Arr{
                name                orid
        }
        &Arr{
                name                depth
                formatter           lambda val: "%.0f km" % val
                width               8
        }
        &Arr{
                name                ndef
        }
        &Arr{
                name                mt
                displayfield        function:beachball
                width               4
        }
        &Arr{
                name                mags
                displayfield        function:mags_string
                anchor              w
                width               21
        }
        &Arr{
                name                latency
                displayfield        strtdelta(origin.lddate-origin.time)
                width               20
        }
        &Arr{
                name                auth
                displayfield        origin.auth
                anchor              w
                width               15
        }
        &Arr{
                name                lat
                formatter           lambda val: "%.4f" % val
        }
        &Arr{
                name                lon
                formatter           lambda val: "%.4f" % val
        }
        &Arr{
                name                time
                formatter           lambda val: stock.epoch2str( val, "%H:%M:%S.%s %Z" )
        }
        &Arr{
                name                nass
        }
        &Arr{
                name                smajax
                formatter           lambda val: "%.1f km" % val
        }
        &Arr{
                name                sdepth
                formatter           lambda val: "%.1f km" % val
        }
        &Arr{
                name                stime
                formatter           lambda val: "%.1f sec" % val
        }
        &Arr{
                name                algorithm
        }
}

events_spreadsheet_columns &Tbl{
        &Arr{
                name                time
                title               origin time
                formatter           lambda val: stock.epoch2str( val, "%Y-%j (%d %b) %H:%M:%S %Z" )
                anchor              w
        }
        &Arr{
                name                evid
        }
        &Arr{
                name                ndef
        }
        &Arr{
                name                reviewed
                title               R
                displayfield        review == 'M' ? '*' : ( review == 'y' ? 'r' : '' )
        }
        &Arr{
                name                prefauth
                displayfield        function:short_author
                anchor              w
                width               15
        }
        &Arr{
                name                mag
                displayfield        function:bestmag_string
                anchor              w
                width               8
        }
        &Arr{
                name                region
                displayfield        grname(lat,lon)
        }
}

EXAMPLE


% dbevents_pre db/gsn

SEE ALSO

dbevents(1)

BUGS AND CAVEATS

The "best magnitude' shown in the event banner and possibly in the events spreadsheet may not show up in the "Latest Magnitudes" table of the information panel, if multiple magnitude-bearing hypocenters for a given author are present and the preferred origin is not the latest-released origin for this author. More sophisticated algorithms would in principle be possible for selection of the "best" moment-tensor for a given event. Often, multiple moment-tensors are releaseed for a single event and it is not always clear which one to give primacy.

AUTHOR

Kent Lindquist
Printer icon