OVERVIEW OF ANTELOPE 5.10
-------------------------
The new rtd(1) is a program to replace orbrtd(1) and before that
orbmonrtd(1). Expanded functionality relative to orbrtd(1) includes
display of seismic detections, arrivals, and seismic event
associations, all in real time as the data is being acquired and
the events processed. Also in rtd(1) data channels can be duplicated
with different processing for each duplicated channel. As an example,
a channel could be duplicated N times and processed through different
filters for each of the N duplicates. This program is meant to provide
expanded functionality as orbrtd(1) using Qt-based display graphics,
including dynamic channel displays while retaining the ability
to specify particular cannels to display in particular orders. rtd(1)
uses a BQTraceview(3) class object to effect the main display
graphics. Most of the BQTraceview object GUIs have been
disabled. The intent of rtd(1) is to show data acquisition in real
time with little or no user interaction. Unlike orbrtd(1), rtd(1)
operates in three different modes so that real time waveforms and
event processing results can be shown from either a database,
or from an ORB, or from a hybrid of a database and an ORB. Glyphs
showing detections, arrivals and predicted arrivals can be displayed.
Most recent and last modified events can be displayed with color
coded arrivals indicating association status, as well as predicted
arrivals. Traces can be automatically ordered by distance as new
events become available.
We have rewritten the orb2orb(1) program from the ground up. At first
glance, the new version will look very similar to the old -- the same
command line, same base features, and almost the same parameter file
(the main change to the parameter file is that the 'name' parameter
for each connection must be specified explicitly, rather than generated
automatically). Internally, we have made numerous improvements. The
orb2orb(1) application now supports dlcmd(1)-style commands, notably pausing
and continuing individual connection threads. Match and reject
expressions are supported on both input and output connections. The
statefile mechanism has the ability to track and preserve old statefile
entries, purging them after a user-specified amount of time if they remain
unused. The underlying Oorb(3) library used to create orb2orb(1) has been
rewritten from scratch and fully documented. A new program orb2orb_pfconvert(1)
assists in converting an Antelope version 5.9 orb2orb.pf parameter-file
to the new Antelope 5.10 version.
In addition to adding sophistication to operations-center function, the
new orb2orb(1) is better suited to data acquisition with new the Kinemetrics Q8
datalogger, which now fully supports the Antelope orb(3) protocol.
The new orb2orb also supports data acquisition from the Kinemetrics Rock and Rock+
series data acquisition systems.
In keeping with our switch to the Qt graphics platform, we have upgraded
to the latest version (5.14.1) of Qt.
The native BRTT mapping has changed significantly. We have reprocessed the
coastline polygons, originating from a CIA public domain database, by removing
the many duplicated points and line crossings, both of which caused problems
with the polygon filling algorithms used within Qt. Hopefully the flashing
and loss of proper polygon fills caused by these data irregularities will be
a thing of the past.
More significantly we have completely replaced the old cultural vector
databases, for national and state boundaries, with expanded national,
state/province/canton/prefecture boundaries world-wide. As well we include
county boundaries in the US along with roads world-wide, urban areas and
major parks in the US. The new data for these cultural features come
from the US Census Tiger project,
https://www.census.gov/programs-surveys/geography/guidance/tiger-data-products-guide.html
and the Natural Earth Data project, https://www.naturalearthdata.com.
We have tuned our demo dbevents(1) instances to use these new mapping
features.
Initial support towards using machine learning algorithms through an Antelope
interface using Tensorflow and Keras has been implemented.
Development continues on FDSN Webservices based on Antelope databases, which are
included as beta release in this version of Antelope.
IMPORTANT CAVEATS
-----------------
Due to Apple security changes, ISO images downloaded for OSX systems should be
sanitized with the following command-line command before installing:
xattr -d com.apple.quarantine Antelope5.10.Production.iso
rtdbclean was significantly changed to make it more configurable. This
required the addition of two new Tbl entries in the parameter file named protected_tables
and nojoin_order. All instances of rtdblean parameter files need to have these
tables set up properly. The program will fail otherwise. Details are in the
rtdbclean(1) man page.
rtdbclean was significantly changed to make it more configurable. This
required the addition of two new Tbl entries in the parameter file named protected_tables
and nojoin_order. All instances of rtdblean parameter files need to have these
tables set up properly. The program will fail otherwise. Details are in the
rtdbclean(1) man page.
Before switching to the new orb2orb, the parameter file must be modified for the
new version. Most importantly, every entry in the connections table must have
an explicit name (the 'auto' naming of connections has been removed). For example, what
was in the old parameter file
connections &Tbl{
&Arr{
read_from_orbtag inputorb
}
&Arr{
write_to_orbtag outputorb
}
}
should now be something like this:
connections &Tbl{
&Arr{
name reader_main
read_from_orbtag inputorb
}
&Arr{
name writer_main
write_to_orbtag outputorb
}
}
A convenient way to perform the bulk of the updates to an Antelope 5.9 parameter-file
for orb2orb(1) is to run the new program orb2orb_pfconvert(1) on the parameter-file
to be converted.
A convenient way to perform the bulk of the updates to an Antelope 5.9 parameter-file
for orb2orb(1) is to run the new program orb2orb_pfconvert(1) on the parameter-file
to be converted.
5.10 COMPARED to 5.9
-------------------
Programs Added:
rtd orb2orb_pfconvert
Programs Removed:
cdorb2db check_visual dbevents_exp
dlmontxt tcpmonitor tkdbpick
Programs With Changed Command Lines:
dbdisplaystations added options [-pf pffile] and [-nomenubar]
dlcmd added [-noexpand]
orb2orb added [-q] and [-x]
traceview added [-sc_reject stachans_reject]
[-width display_width]
[-height display_height]
[-full_screen]
[-show_events]
Libraries Added:
liboorb libmex_orb_R2019b libantelope_mex_R2019b
libcrypto libgcc_s libstdc++
libnettle liblzma python__buassoc
Library Differences:
libstock added zstr2deltime
libds added dbgetv_noerrmsg, dbtmp_noshare
libtr added printauth
Include Files Added:
BUAssoc.h oorb_sourcecounter.h oorb_taverage.h
oorb.h
Man Pages Added:
BUAssoc.3 Oorb.3 OorbBasics.3
OorbCommandMgrTask.3 OorbConfigMgrTask.3 OorbConfigure.3
OorbConnection.3 OorbConnectionTask.3 OorbExceptions.3
OorbFilter.3 OorbFilters.3 OorbLogMgrTask.3
OorbMaster.3 OorbPacket.3 OorbQueue.3
OorbReaderTask.3 OorbSignalMgrTask.3 OorbStateMgrTask.3
OorbStatusMgrTask.3 OorbTask.3 OorbWriterTask.3
orb2orb_pfconvert.1 pktdlcmd.3 rtd.1
webservice_fdsn.1
Man Pages Removed:
cdorb2db.1 check_visual.1 dbevents_exp.1
dlmontxt.1 javadoc tcpmonitor.1
tkdbpick.1
Schema file changes:
Added tcpmonitor1.0
Parameter Files Added:
bqdraworigins_defaults.pf dbdisplaystations.pf bqmap_defaults.pf
event2qml.pf buassoc.pf rtd.pf
Parameter Files Removed:
cdorb2db.pf tcpmonitor.pf tkdbpick.pf
Parameter Files Changed:
dbevents.pf Small change to a field text alignment
dbverify.pf Added additional valid channel codes
dlmon.pf Added support for orb2orb state changes
install_mapdata.pf Added new "naturalearth" enhanced map file
orb2orb Multiple changes, see orb2orb(1) and orb2orb_pfconvert(1)
name of 'auto' no longer allowed
all read/write connections must have a unique name
default max_queue changed to 10000
new parameter 'acknowledge' to use orbputx(3)
log_create array renamed to logs
new parameter connections_special{logs}{verbose}
status_create array renamed to status
new parameter connections_special{status}{verbose}
new array connections_special{commands}
new array connections_special{state}
new time-interval retain_unused_stateinfo
rtdbclean New arrays protected_tables and nojoin_order
rtexec.pf Added macOS X11 to path; changed antelope_update_dep to antelope_update
traceview.pf Many alias and hotkey additions to ease transition from dbpick and improve usage
new parameters width, height for display size at startup
new parameter tw for initial display time window
webservice_fdsn.pf Added app_log_dir parameter
