# EARTHWORM MODULES

June 8, 2006

## SYSTEM MODULES

Module name | Its function, briefly | more info (note 1)
--- | --- | ---
startstop | Starts & stops all `EARTHWORM` modules on a computer. | overview | commands: Windows Solaris Linux
restart | Allows manual restarting of individual modules. | overview | commands
reconfigure | Allows adding new modules or rings to a running `EARTHWORM` (new in EW v7.0)`` | overview | commands
pau | Completely shuts down `EARTHWORM` and all modules/ rings | overview | commands
pidpau | Given an `EARTHWORM` module process ID, pidpau stops it. | overview | commands
StarstopConsole | Creates a command prompt window with access to startstop_service (Windows only) | overview | none

## STATUS AND ERROR REPORTING MODULES

Module name | Its function, briefly | more info (note 1)
--- | --- | ---
statmgr | Monitors `EARTHWORM` system integrity via heartbeat and error messages. Sends email and pager messages as required | overview | commands
copystatus | Copies heartbeats and error messages from one shared memory region to another | overview | commands
diskmgr | Monitors the amount of free disk space available | overview | commands
status | Outputs to the screen `EARTHWORM` status of rings and modules. | overview | commands

## DATA SOURCE MODULES

Module name | Its function, briefly | more info (note 1)
--- | --- | ---
adsend | Digitizes analog seismic signals on Win2000 system only | overview | commands
gcf2ew | Guralp Digitizers Earthworm feed via direct connection to serial port or TCP terminal server (Solaris only) (new in EW v7.0) | overview | commands
naqs2ew | Naqs2ew is an interface through which waveform data collected by the Nanometrics data acquisition software, NaqsServer, can be fed into an Earthworm system in near-real-time. | overview | commands
q2ew | A Quanterra/COMSERV data feeding program | overview | commands
q3302ew | A Quanterra Q330 data feeding program | overview | commands
reftek2ew | A Reftek data feeding program | overview | commands
scream2ew | Scream2ew converts data from Guralp SCREAM server to trace_buf earthworm messages and puts them into an earthworm ring. | overview | commands
srparxchewsend | Symmetric Research Digitzer module for SRPARXCH 24-bit digitizers | overview | commands
k2ew | Receives data packets from a Kinemetrics K2 Strong Motion Accelerograph via serial port or TCP on either Solaris or Win2000 | overview | commands

## PROCESSING MODULES

Module name | Its function, briefly | more info (note 1)
--- | --- | ---
pick_ew | Picks P-arrivals and makes coda measurements | overview tuning info | commands
pkfilter | A duplicate pick removal filter. (new in EW v7.0) | overview | commands
binder_ew | Associates P-arrivals into events | overview/setup | commands
eqproc | Initiates final event processing (head of mega-module). | overview | commands
eqprelim | Initiates preliminary event processing (alternate head of mega-module). | overview | commands
eqbuf | Buffers events (part of mega-module) | overview | commands
eqcoda | Performs coda calculations (part of mega-module) | overview | commands
eqverify | Passes only events verified as earthquakes (part of mega-module) | overview | commands
gegqproc | Clone of eqproc designed to work with glass. (new in EW v7.0) | overview | commands
glass | Carl Johnson's Global Associator. See the overview for the Glass Manual written for Hydra by Dave Kragness. (new in EW v7.0) | overview | commands
hyp2000_mgr | Relocates earthquakes using Hypoinverse (tail of mega-module) | overview | commands
hyp2000 | Hyp2000 is the stand-alone version of hypoinverse, an earthquake location program, written and maintained by Fred Klein at USGS, Menlo Park | overview | commands
evanstrig and evansassoc | Evanstrig monitors waveforms for long-period signals; evansassoc associates LP triggers into events. | overview | Evanstrig Commands Evansassoc Commands
carl*trig | The Carl Johnson coincidence trigger for Earthworm consists of two programs. CarlStaTrig produces station trigger messages on a transport ring. CarlSubTrig reads these and writes a TRIGLIST message. | overview | CarlStaTrig CarlSubTrig
rayloc_ew | Ray Buland's global earthquake locator. (new in EW v7.0) | overview | commands
raypicker | Ray Buland's global picker. (new in EW v7.0) | overview | commands
statrigfilter | A pkfilter like module for filtering out duplicate station triggers. (new in EW v7.0) | overview | commands
compress_UA and decompress_UA | The compress_UA and decompress_UA modules implement the gencompress algorithm which is used with permission from Boulder Real Time Technologies, Inc., copyright 1997. | overview | Compress_UA Decompress_UA
decimate | Implements filter and decimate routines. | overview | commands
fir | Implements a general-purpose FIR filter for trace data. | overview | commands
arc2trigII | Takes a hypo arc message as input, uses user specified criteria for selecting snippets (different from arc2trig), and produces a .trg file. | overview | commands
eqfilter | Performs parameter tests on Hypoinverse ARC messages. | overview | commands
eqfilterII | Clone of eqfilterII to work with any of TYPE_HYP2000ARC, TYPE_LOC_GLOBAL, and TYPE_RAYLOC (new in EW v7.0) | overview | commands
localmag | Calculates the Local Magnitude | overview | commands
gmew | Calculates strong motion parameters | overview | commands
wftimefilter | Sanitizer of waveform packets to eliminate out of order and badly timed packets (overlaps and dups etc). (new in EW v7.0) | overview | commands

## DATA EXCHANGE MODULES

Module name | Its function, briefly | more info (note 1)
--- | --- | ---
coaxtoring | Reads `EARTHWORM` messages from Ethernet and places them into shared memory | overview | commands
ringtocoax | Reads `EARTHWORM` messages from shared memory and broadcasts them onto Ethernet | overview | commands
ringtocoaxII | Same as ringtocoax but with an input queue (new in EW v7.0) | overview | commands
menlo_report | Transfers single-event HYPOINVERSE archive files to a remote machine | overview | commands
export_generic export_scn export_scn_pri export_ack export_scnl_ack | Exports `EARTHWORM` messages over Internet (partner to import_generic) (export_ack and export_scnl_ack are new in EW v7.0) | overview | export_generic export_scn export_scn_pri export_ack export_scnl_ack
import_generic | Imports `EARTHWORM` messages over Internet (partner to export_generic) | overview | commands
vdl_ew | This is the Earthworm encapsulation of the USNSN code written by Dave Ketchum, USNSN. | overview | commands
import_ida | This program enables an Earthworm to retrieve and process continuous trace data from numerous IDA data servers. | overview | commands
rcv_ew | The module permits turn-key, two-way trace data exchange between the USNSN and regional networks. | overview | commands
liss2ew | Liss2ew is the earthworm module for receiving trace data from the Live Internet Seismic Server. | overview | commands
liss2ew_scnl | Liss2ew_scnl is the earthworm module for receiving trace data from the Live Internet Seismic Server. This is a rewrite of liss2ew for SCNL and has only been tested under windows (new in EWv7.0) | overview | commands
ew2liss | Ew2liss is the Earthworm module for serving Earthworm trace data in LISS (Live Internet Seismic Server) format. | overview | commands
ringdup | Ringdup is a program to read messages (with user specified logos) from one ring and deposit them in another. This is actually two program, ringdup_generic and ringdup_scn. | none | Ringdup_generic commands Ringdup_scn commands
scn2scnl scnl2scn | SCN 2 SCNL converters for waveform packets (new in EW v7.0) | overview | scn2scnl scnl2scn
slink2ew | Seedlink importer module from Chad Trabant (Windows and Solaris compat) (new in EW v7.0) | overview | commands
sendfileII getfileII makehbfile | Set of programs used to transfer files between computers running Windows 2000 and/or Sun Solaris. These programs do not require an Earthworm setup. | overview | ----

## ARCHIVING MODULES

Module name | Its function, briefly | more info (note 1)
--- | --- | ---
wave_serverV | Wave_serverV provides a network-based service for trace data. It acquires Earthworm trace data messages for specified channels and maintains a disk-based circular buffer for each channel. | overview | commands
tankplayer | Simulates an adsend module: reads a waveform file and puts waveform messages in shared memory in pseudo-real-time | overview | commands
trig2disk | Trig2disk module reads trigger messages and retrieves waveform data from wave_serverV into AH or SAC format files. | overview | commands
waveman2disk | Manual, interactive program to save trace data from Earthworm Wave_servers to disk. | overview | commands

## DISPLAY MODULES

Module name | Its function, briefly | more info (note 1)
--- | --- | ---
wave_viewer | Wave_viewer, which runs under Win2000, acts as an electronic develecorder. It retrieves waveform data from wave_serverV and displays it. | overview | commands
heli_ewII | heli_ewII is designed to autmatically provide GIF images of waveforms for display on the WWW. It can run as an Earthworm module or a standalone program | Heli_ew Overview | Heli_ew Commands
sgram | Creates spectrogram displays for the WWW | overview | commands
latency_mon | Logs and displays latency and outages of data from a specified ring (Windows only) | overview | commands

## HELPFUL PROGRAMS

##

Module name | Its function, briefly | more info (note 1)
--- | --- | ---
cleandir | Windows directory cleaning module as a windows service. (new in EW v7.0) | overview | commands
config_ws | Create the WaveServerV tankfiles based on polling of a WAVE_RING. (new in EW v7.0) | overview | commands
dumpwave | Dump a waveform data file to the screen. | overview | none
file2ring | Load contents of file into a ring. | overview | none
ellipse2arc | ellipse2arc -- convert from HypoEllipse (Hypo71) Message into Hypoinverse format Message | none | commands
findwave | Program to listen to a ring, and write to a file the `SCN(L)`'s of all `TRACEBUF` or `TRACEBUF2` messages found there and some statistics about the `SCN(L)`. | overview | none
gaplist | Program to search for gaps in `TRACEBUF` or `TRACEBUF2` messages and print tables. Developed by Will Kohler at USGS, Menlo Park. | none | commands
getmenu [UW] | Retrieves and prints the menu from the wave server. | overview | none
getstation | Retrieves and prints a station list from the wave server. A subset of getmenu. | overview | commands
maketrace | Trace data load test component | overview | none
putpick | Reads a file containing a series of pick/coda msgs and writes them to shared memory ring | overview | none
sniffring | Latches onto a user-defined transport ring, reads every nessage and prints logo to screen. | overview | none
sniffwave | Reads waveform messages from Earthworm transport ring and for each message, prints the logo and header information to the screen. | overview | none
template | A template module for programmers who want to create ther own Earthworm module | overview | none
wave_probe | Sends a trace request for one station in a waveserver, creating a debugging file | overview | none
wsv_test | Program to request menu from a list of wave_serverVs and report to the status manager if any wave server process is dead. Developed by Will Kohler at USGS, Menlo Park. | none | commands

## CONTRIBUTED SOFTWARE

Note 1: The configuration files in this table should be verified by comparison with the configuration file examples in the source directory of each module.

U.S. Department of the Interior, U.S. Geological Survey, Reston, VA, USA Contact: Privacy Statement || Disclaimer || FOIA || Accessibility |