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