# EARTHWORM MODULES

August 19, 2011

## Modules Index (updated for Earthworm v7.5)

SYSTEM
STATUS AND ERROR REPORTING
DATA SOURCE
SEISMIC PROCESSING
DATA EXCHANGE
ARCHIVING AND PLAYBACK
DISPLAY
HELPFUL UTILITIES

## SYSTEM MODULES

Module name | Its function, briefly | more info (note 1)
--- | --- | ---
startstop | Starts & stops all `EARTHWORM` modules on a computer. This module is the core of the earthworm system. | 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
stopmodule | Given an `EARTHWORM` module process ID, stopmodule stops it, and startstop marks it as "Stop" to prevent statmgr from restarting it.(new in EW v7.1) | 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 using National Instruments digitizer boards. | overview | commands
gcf2ew | Guralp Digitizers Earthworm feed via direct connection to serial port or TCP terminal server. (Solaris and Linux only) (new in EW v7.0) (Linux capable in v7.3) | overview | commands
grf2ew | NetDas Digitizers Earthworm feed via direct connection to GRF server. (Solaris, Linux, Windows) (new in EW v7.2) | 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
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
nmxptool | nmxptool is an IMPROVED interface through which waveform data collected by the Nanometrics data acquisition software, NaqsServer, can be fed into an Earthworm system in near-real-time. (New in V7.2, contributed by INGV) | overview | commands
psnadsend | PSNadsend for Public Seismic Network (webtronics digitizer) (new in EW v7.1) | overview | commands
q2ew | A Quanterra/COMSERV data feeding program. | overview | commands
q3302ew | A Quanterra Q330 data feeding program, rewritten by ISTI using Lib330 from Quanterra (not MountainAir). | overview | commands
reftek2ew | A Reftek data feeding program | overview | commands
samtac2ew | Imports data from SAMTAC-802U over tcp/ip or serial on windows (new in EW v7.4) | overview | commands
rock2ew | Provides a data relay from a Kinemetrics-Rockhound-compatible instrument into Earthworm via export/import. (new in EW v7.3) | overview | commands
saraadsend | A SARA digitizer earthworm data feeding module (serial input, windows only). (new in EW v7.3) | overview | commands
scream2ew | Scream2ew converts data from Guralp SCREAM server to trace_buf earthworm messages and puts them into an earthworm ring. | overview | commands
srpar2ew | Symmetric Research Digitzer module for parallel port digitizers, formerly known as srparxchewsend. | overview | commands
srusb2ew | Symmetric Research Digitzer module for usb port digitizers. | overview | commands
windsr2ew | Receives data packets from a windsr digitizer (webtronics) using TCP/IP. (new in EW v7.1) | 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
eqassemble | Initiates event processing multiple times (CISN contrib) v7.2 addition | 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
eqverify_assemble | Passes only events verified as earthquakes (part of mega-module with eqassemble) | 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
nll_mgr | Relocates earthquakes using NonLinLoc from Anthony Lomax (tail of mega-module) (New in 7.5) | 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
arc2trig | Takes a hypo arc message as input, and produces a .trg file (also puts trig message on out ring). | 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
ewintegrate | Realtime computation of integration of waveforms, useful for taking acceleration to velocity or velocity to displacement. Also allows filtering. (new in EW v7.4) | overview | commands
ewspectra | Takes data from one or more waveservers, computes and processes their spectra | overview | commands
compute_spectra | Posts a message for ewspectra to begin processing. (Deprecated 5/5/2011; use activate_module instead.) | overview | none
ewthresh | Monitors a ring for TRACEBUF2X messages and generates an alarm message when a SCNL-specific threshold is exceeded. | overview | commands
ewnotify | Monitors a ring for ACTIVATE_MODULE or alarm messages; generates email and posts a message to a ring for an instance of activated_scripts. | overview | commands
ewaccel | An acceleration threshold monitor; reads TRACEBUF2 packets from sensors on different floors of a building, compares the sum of their forces w/ a threshold which, if exceeded, causes an alarm message to be written to a ring. | 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
condenselogo | Reads messages from a list of logos from one transport ring and writes them to another ring using its own installation and module id in the logo. | 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_scnl export_scn_pri export_ack export_scnl_ack export_gen_actv | 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 export_scnl_ack export_gen_actv
ew2file | Converts `EARTHWORM` messages into files. | overview | commands
file2ew | Inserts `EARTHWORM` messages files onto rings. | overview | commands
import_generic import_pasv | Imports `EARTHWORM` messages over Internet (partner to export_generic) | overview | import_generic commands import_pasv 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
pickwasher | Pick format (scnl to global) converter from NEIC(Windows and Solaris compat) (new in EW v7.1) | overview | commands
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/PLAYBACK MODULES

Module name | Its function, briefly | more info (note 1)
--- | --- | ---
archman | archman provides a wrapper for waveman2disk for continuous output of data to file | overview | commands
ew2mseed | ew2mseed is a standalone module that builds continuous miniSEED day files from a wave_serverV connection | overview | commands
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
tankplayer_tools | Tools to assist the user in building a tank. Converters like sac2tb, ms2tank, ring2tank, remux_tbuf and utilities tanksniff,tankcut, and dc2tank. (many new in EW v7.2) | overview |
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
pick_recorder | Records picks SCNL or PICK2K to a file per day in a user specified directory | overview | commands
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 message and prints logo to screen. | overview | none
sniffspectra | Latches onto a user-defined transport ring, reads every spectra message (as from ewspectra); prints information to screen or to a file | overview/setup | 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
activate_module | Puts an ACTIVATE_MODULE message in the specified ring, the body of which starts with the module ID of the specified target module, followed by the remaining command-line arguments. | overview | none
activated_scripts | When it reads an ACTIVATE_MODULE message from the specified ring, the body of which is a list of command-line arguments, it executes a sequence of scripts using those arguments, and write a completion message to a ring when done. | overview | commands | none

## 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.

Originally funded and developed by: U.S. Department of the Interior, U.S. Geological Survey, Reston, VA, USA Contact: