• Antelope Release 5.10 Linux CentOS release 7.6.1810 (Core) 3.10.0 2020-05-12

 

NAME

dbevents - Graphical event display for seismic events in Datascope database

SYNOPSIS

dbevents [-allow_remote_fs] [-nfsok] [-pf pffile] [-pftraceview traceview_pffile]
         [-show_traces] dbname

DESCRIPTION

dbevents displays seismic events out of a Datascope relational database, updating the view as the Database changes. Three panels show, from left to right: first an overview map of the entire database; second a detail map highlighting the currently selected event; and third an origins map showing the hypocenters (origin table entries) for the currently selected event. Two spreadsheets are provided with the maps. The first spreadsheet lies just below the overview map, listing distinct events in the database, with metadata from their preferred-origin. The second spreadsheet lies under the selected-event and origin maps, listing metadata for each origin for the selected event. The dividers separating the three maps and the spreadsheets may be moved, optionally hiding entire sections from display. The dbevents display will update based on changes in the database dbname, unless the update_interval value in the parameter-file is set to 0.0. A right-click with the mouse on an event or origin glyph will launch the command specified in the parameter-file external_commands array. See the PARAMETER FILE section for details.

OPTIONS

Color Codes

Extensive information about events in a database is directly visible through the symbol characteristics used in the dbevents display. Symbols vary by size, shape, color, and opacity. These symbols update dynamically as the database changes, providing a powerful diagnostic for database health and real-time-process tuning. Some of the most useful codes are as follows:

PARAMETER FILE

Parameter-file Parameters

Parameter-file Example

update_interval             1.0
width                       0.9s
height                      0.8s
mapevents_width             0.333
mapevent_width              0.333
maporigins_width            0.0
traces_width                0.333
mapevents_height            0.6
mapevents_range             140.0
mapevent_height             0.75
auto_select_event           mostrecent

mapevents_taskbar_states &Tbl{
    basemap:demw
    projection:globe
    boundaries:on
    urban:on
    parks:on
    roads:on
    rivers:on
}

mapevent_taskbar_states &Tbl{
    basemap:bluemarble
    projection:merc
    boundaries:on
    rivers:on
}

traceview_taskbar_states &Tbl{
    pal:on
    spa:on
    stad:on
    filter:0.01HP
}

external_commands	&Arr{
	event &Tbl{
		echo	echo Event dbname,evid are %dbname,%evid
	}
	origin &Tbl{
		echo	echo Origin dbname,orid are %dbname,%orid
	}
}

traceview_scsift	.* .*       # station-channel sifter for the traceview display
traceview_commands &Tbl{	    # these traceview commands will be executed when the display is created
    traces maximum 33
    traces configure predicted_phases P,S
    traces auto_distance_sort yes
    display time_window 1800
    display palign yes
    traces filter BW 0.8 4 3.0 4 \#0.8-3 BP
}

events_tableview &Arr{           # specifications for events spreadsheet
    column_definitions &Arr{
        event_row &Arr{
            label         event_row
            text_template XXXXXXXXXXX
            source        events[%index].recno_event
            sort          recno_event
            alignment     e
            format        %9d
        }
        origin_row &Arr{
            label         origin_row
            text_template XXXXXXXXXXX
            source        events[%index].recno_event
            sort          recno_event
            source        events[%index].origins[pref_origin].recno_origin
            sort          origins[pref_origin].recno_origin
            alignment     e
            format        %9d
        }
        time &Arr{
            label         time
            text_template XXXXXXX XX/XX XX:XX:XX.XXX
            source        events[%index].origins[pref_origin].record_origin{epoch2str(time, "%Y%j %m/%d %T")}
            sort          origins[pref_origin].time
            alignment     e
        }
        lat &Arr{
            label         latitude
            text_template XXX.XXXX
            source        events[%index].origins[pref_origin].record_origin{lat}
            sort          origins[pref_origin].record_origin{lat}
            format        %8.4f
            alignment     e
        }
        lon &Arr{
            label         longitude
            text_template XXXX.XXXX
            source        events[%index].origins[pref_origin].record_origin{lon}
            sort          origins[pref_origin].record_origin{lon}
            format        %9.4f
            alignment     e
        }
        depth &Arr{
            label         depth
            text_template XXX.XX
            source        events[%index].origins[pref_origin].record_origin{depth}
            sort          origins[pref_origin].record_origin{depth}
            format        %6.2f
            alignment     e
        }
        evid &Arr{
            label         evid
            text_template XXXXXXXXX
            source        events[%index].evid
            sort          evid
            format        %9d
            alignment     e
        }
        orid &Arr{
            label         orid
            text_template XXXXXXXXX
            source        events[%index].prefor
            sort          prefor
            format        %9d
            alignment     e
        }
        ndef &Arr{
            label         ndef
            text_template XXXX
            source        events[%index].origins[pref_origin].record_origin{ndef}
            sort          origins[pref_origin].record_origin{ndef}
            format        %4d
            alignment     e
        }
        nass &Arr{
            label         nass
            text_template XXXX
            source        events[%index].origins[pref_origin].record_origin{nass}
            sort          origins[pref_origin].record_origin{nass}
            format        %4d
            alignment     e
        }
        auth &Arr{
            label         auth
            text_template XXXXXXXXXXXX
            source        events[%index].origins[pref_origin].record_origin{auth}
            sort          origins[pref_origin].record_origin{auth}
            alignment     e
        }
        region &Arr{
            label         region
            text_template XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
            source        events[%index].origins[pref_origin].record_origin{grname(lat,lon)}
            sort          origins[pref_origin].record_origin{grname(lat,lon)}
            alignment     e
        }
        magnitude &Arr{
            label         magnitude
            text_template XXXXXXXXXX
            source        events[%index].magnitude;events[%index].magtype
            sort          magnitude;magtype
            format        %4.2f;(%s)
            alignment     e
            null          -999.00()
        }
    }
    column_names &Tbl{
        evid
        magnitude
        auth
        time
        region
        lat
        lon
        depth
        ndef
        nass
        event_row
        origin_row
    }
}

origins_tableview &Arr{           # specifications for origins spreadsheet
    column_definitions &Arr{
        origin_row &Arr{
            label         origin_row
            text_template XXXXXXXXXXX
            source        origins[%index].recno_origin
            sort          recno_origin
            format        %9d
        }
        time &Arr{
            label         time
            text_template XXXXXXX XX/XX XX:XX:XX.XXX
            source        origins[%index].record_origin{epoch2str(time, "%Y%j %m/%d %T")}
            sort          time
            alignment     e
        }
        latency &Arr{
            label         latency
            text_template XXX:XX:XX:XX.XXX
            source        origins[%index].record_origin{strtdelta(lddate-time)}
            sort          record_origin{lddate-time}
            alignment     e
        }
        lat &Arr{
            label         latitude
            text_template XXX.XXXX
            source        origins[%index].record_origin{lat}
            sort          record_origin{lat}
            format        %8.4f
            alignment     e
        }
        lon &Arr{
            label         longitude
            text_template XXXX.XXXX
            source        origins[%index].record_origin{lon}
            sort          record_origin{lon}
            format        %9.4f
            alignment     e
        }
        depth &Arr{
            label         depth
            text_template XXX.XX
            source        origins[%index].record_origin{depth}
            source+sort          record_origin{depth}
            format        %6.2f
            alignment     e
        }
        orid &Arr{
            label         orid
            text_template XXXXXXXXX
            source        origins[%index].orid
            sort          orid
            format        %9d
            alignment     e
        }
        ndef &Arr{
            label         ndef
            text_template XXXX
            source        origins[%index].record_origin{ndef}
            sort          record_origin{ndef}
            format        %4d
            alignment     e
        }
        nass &Arr{
            label         nass
            text_template XXXX
            source        origins[%index].record_origin{nass}
            sort          record_origin{nass}
            format        %4d
            alignment     e
        }
        auth &Arr{
            label         auth
            text_template XXXXXXXXXXXX
            source        origins[%index].record_origin{auth}
            sort          record_origin{auth}
            alignment     e
        }
        magnitude &Arr{
            label         magnitude
            text_template XXXXXXXXXX
            source        origins[%index].magnitude;origins[%index].magtype
            sort          magnitude;magtype
            format        %4.2f;(%s)
            alignment     e
            null          -999.00()
        }
    }
    column_names &Tbl{
        orid
        latency
        auth
        magnitude
        depth
        time
        lat
        lon
        ndef
        nass
        origin_row
    }
}

EXAMPLE


% dbevents db/gsn

SEE ALSO

dbevents_dep(1), dbevents_dep2(1), install_mapdata(1), traceview(1), BQMapLayer(3)

AUTHOR

Danny Harvey
Kent Lindquist
Printer icon