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

 

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
Printer icon