# Earthworm Documentation V7.7

# Table of Contents

Sept 12, 2013

## Index

Section 1 | Overview
Section 2 | User Guide
Section 3 | Programmer Notes
Section 4 | Release Notes
Section 5 | Community and References

Note 7.7 contains both static documentation as well as the contents of the trac wiki: http://www.earthwormcentral.org 7.8 will likely only contain the wiki html

## Section 1: Overview

1. History
2. Design Goals
3. System Architecture
4. How to get the Software Distribution and copy of the Web Documentation:
5. Communicating with other Earthworm Users

## Section 2: User Guide

1. Installation and Configuration
2. Module Description and Configuration

- List of Earthworm Modules and Configuration Files
- List of Contributed Software

3. Starting and Stopping Earthworm
   - Starting, Stopping and Status of Earthworm
   - Earthworm NT Autostart Procedure
   - Earthworm Windows 2000 Autostart Procedure
   - Earthworm Windows startstop service
   - Earthworm Solaris Autostart Procedure
4. Tuning the Earthworm Picking, Assocation, and Location

- Picker Tuning
- BINDER_EW Configuring
- Hypoinverse Documentation
- HYPOINVERSE Station File Format

5. Migration Notes

- V6.3 to V7.1
- V7.0 to V7.1

## Section 3: PROGRAMMER NOTES

New modules and fixes to existing modules are encouraged. Please read the Coding Standards and Software Procedures before you do anything. If you have a new module you'd like included, or a fix to contribute, please send email to the Earthworm List.

1. Coding Standards and Software Procedures
2. How to Compile
3. Increasing the number of Shared Memory Rings under Solaris
4. Earthworm Library Functions

- Libsrc functions: Descriptions and function calls.
- RW_STRONGMOTION_II

5. Transport Layer (The guts of EARTHWORM communications within one computer system)
6. Formats

- Year 2000 Compliant Earthworm Message Formats
- Waveform Message Format
- Strong Motion Message Format
- Global Processing Message Format

7. How Microsoft Windows NT 4.0 handles internal Time
8. How to disable NT disk sharing
9. How to configure multiple ethernet adapters under NT
10. NT USER32.dll initialization errors
11. LOCATION CODE POLICY
12. LOCATION CODE MESSAGE CHANGES
13. Wave Server Protocol Doc

##

## Section 4. Release Notes

- This Release - v7.7 - 9/2013
- v7.6 - 10/2012
- v7.5 - 08/2011
- v7.4 - 04/2010
- v7.3 - 12/2008
- v7.2 (nuff said, eh) - 12/2007
- v7.1 (still Y2K compat) - 4/2007
- v7.0 (still Y2K compat) - 6/2006
- v6.3 (Y2K compatible) - 9/2005 - last non-location code enabled version
- v6.2 (Y2K compatible) - 5/2003 - last tested version of EW interactive
- v6.1 (Y2K compatible) - 4/2002
- v6.0 (Y2K compatible) - 7/2001
- v5.2 (Y2K compatible) - 5/2001
- v5.1 (Y2K compatible) - 9/2000
- v5.0 (Y2K compatible) - 6/2000
- v4.1 (Y2K compatible) - 1/2000
- v4.0 (Y2K compatible) - 8/99

## Section 5. Community and References

1. References, Reports & Links to Articles on Earthworm (updated Feb. 2007)

- INGV report: Tuning an Earthworm Phase Picker: Some Considerations on the Pick_ew Parameters, by Mele et al. 2010 also found here in the release
- ORFEUS Newsletter Vol5 No1, Earle et al., March, 2003
- ORFEUS Newsletter Vol5 No1, Childs and Komec, March, 2003
- Earthworm Article IRIS News Letter Fall, 1995
- Kandilli-Observatory-Earthworm-Performance-Nov-2005 (PDF download)
- Earthworm workshop INGV/ORFEUS/ISTI, Rome, Italy October 2007 (ppts)

2. Some Seismic, Geomagnetic, and Volcanic Observatories using Earthworm (compiled Feb. 2007)*

1. Alaska Volcano Observatory (AVO)
2. Alaska Tsunami Warning Center (ATWC)
3. British Geological Survey (BGS)
4. California Integrated Seismic Network (CI/NC/BK/NP)
5. Cascade Volcano Observatory (CVO)
6. CSIRO Exploration and Mining, Australia
7. Dominican Republic
8. Ecuador (IGEPN)
9. El Salvador (SNET)
10. Hawaii Volcano Observatory (HVO)
11. Hellenic Seismological Broadband Network (HL), Athens Greece
12. Idaho National Laboratory (INL)
13. Infrasound Laboratory University of Hawaii (ISLA)
14. Italian Earthquake Data Center (Centro Nazionale Terremoti) Instituto Nazionale di Geofisica e Vulcanologia (INGV), Italy
15. Institut Geologic de Catalunya, Catalonia Spain
16. Kandilli Observatory, Turkey
17. Lamont-Doherty Cooperative Seismographic Network (LD)
18. Monserrat Volcano Observatory
19. Montana Regional Seismographic Network (MT)
20. Mount Erebus Volcano Observatory
21. New England Seismic Network (NESN)
22. New Mexico Tech Seismic Network
23. National Earthquake Information Center (NEIC)
24. New Mexico Tech Earthworm System
25. New Madrid Seismic Network, CERI
26. Nicaragua Seismic Network Survey (INETER)
27. National Institute for Occupational Safety and Health (NIOSH) Mining Division
28. Norwegian National Seismic Network (NNSN)
29. Volcan Baru (OSOP)
30. Observatorio Vulcanologico y Sismologico de Costa Rica (OVISCORI)
31. Pacific Northwest Seismic Network (PTWC)
32. Pacific Tsunami Warning Center
33. Patras Seismological Laboratory (Greece)
34. Puerto Rico Seismic Network
35. Servicio Seismologico Nacional (Mexico)
36. University of Colima (UC)
37. University of Utah Seismographic Stations (UU)
38. University of Panama
39. Uzbekistan Digital Seismic Network
40. USGS Geomagnetic program
41. Venezuela Seismic Network (FUNVISIS)
42. Autonomous University of Santo Domingo (UASD), Dominican Republic (DR)
43. Center of Volcanology and Geological Risks Assessment
44. French Riviera Observatory, OCA - Geoazur Labs, France

* These are only ones that had links, there are many more, and thus is not all inclusive!

Developers:
EARTHWORM development team was originally headed by Alex Bittenbinder and coordinated by Barbara Bogaert; both with the U.S. Geological Survey. Funding for this release was provided by the USGS and many other contributors.
Principal EARTHWORM development is now provided by members of the the Earthworm Community.
In 2005, ISTI.com and CERI (University of Memphis) have taken on lead roles in software development and user support of Earthworm. Please join the Earthworm community by coming an active developer (join ewdev-subscribe @ isti . com) mailing list.
Send any bug reports or configuration problems to the earthw mailing list.
This software is Open Architecture and more importantly Open Source and is freely available to anyone. Distribute and use as your heart desires.
This software was originally written and funded by the United States Geological Survey.