source: trunk/README.txt @ 5054

Revision 4986, 5.7 KB checked in by stefan, 5 years ago (diff)

test

Line 
1
2OVERVIEW
3
4Earthworm is a free open source waveform and automatic Earthquake processing software package written primarily in the C language.
5
6Originally developed by the United States Geological Survey (USGS), Earthworm now has modules contributed by users all over the world.
7 
8Earthworm has been an active open source project since 1993. In the last number of years, the USGS has funded continued releases and maintenance by ISTI. University of Memphis and ISTI host the Earthworm documentation and distribution.
9
10Digitizers from different hardware manufacturers export their data into shared memory rings
11
12Various open source processing modules can operate in conjunction on shared memory data
13
14Earthworm provides a common protocol for regional networks to share waveforms, picks, etc.
15
16If you have at least 4 stations, Earthworm can attempt to associate phase arrivals and compute earthquake locations.
17
18DOCUMENTATION
19
20The Earthworm documentation can be found within this distribution at
21
22ewdoc/WEB_DOC/index.html
23
24The same documentation can be found
25online at
26http://folkworm.ceri.memphis.edu/ew-doc/
27and
28http://isti2.com/ew/
29
30GET EARTHWORM
31
32If a software distribution is available for your operating system and hardware architecture, the easiest thing is to download the Earthworm software from
33http://folkworm.ceri.memphis.edu/ew-dist/
34or
35http://www.isti2.com/ew/distribution/
36
37If your operating system isn't listed, you may try and compile the binary executables for Earthworm yourself. (See COMPILING below.)
38
39GETTING STARTED
40
41Earthworm Minimum Setup Overview:
42- Create parameter and log directories
43- Acquire or decide on an installation id
44- Set environment variables (run script)
45- Add all modules you want to use to the startstop configuration file
46- Make sure all modules you want to use have a module ID in the earthworm.d config file
47- Add all modules you want to monitor to the statmgr configuration
48- Configure modules
49
50
51The easiest way to get started with Earthworm is to run an existing Earthworm configuration, see how it works, and then modify it for your own needs. Start with the Memphis Test Suite, you can get it from:
52http://www.isti2.com/ew/distribution/earthworm_test.memphis.tar.gz
53or
54http://www.isti2.com/ew/distribution/earthworm_test.memphis.zip
55or possibly from
56http://folkworm.ceri.memphis.edu/ew-dist/v7.5/earthworm_test.memphis.tar.gz
57
58Read the README within the test suite, and try running the test suite. Note that a minor difference in the depth value (ie: 11.74 vs. 11.71) are acceptable.
59
60Once you're done with that, and you've gotten the correct test results, you can request a new Installation ID from Mitch. (See instructions at the top of earthworm_global.d for how to do this. earthworm_global.d lives in the environment directory of the distribution, but needs to be placed in your parameters directory to become active) The new Installation ID will need to go in your .desc files as sell as some .d files. You can modify the files in the Test Suite params directory to replace INST_MEMPHIS with your installation ID, or you can get a fresh set of parameters from the distribution's 'params' directory.
61
62It's cleaner to only copy over parameters for the programs that you need to your 'params' directory from the distribution's 'params' directory.
63
64Two key programs are the core of Earthworm. Startstop and statmgr. Startstop contains the command line to run each module you'd like to use, and specifies the module name and the corresponding .d configuration file. Statmgr monitors the health of all running earthworm programs, as configured in it's own .d file. It uses the .desc file for each module to configure how it runs.
65
66See the module documentation in ewdoc/WEB_DOC/index.html for more on configuring startstop, statmgr or other modules
67
68As you've seen from the test suite, just type 'starstop' to run Earthworm. (To have Earthworm automatically start, you can make a unix startup script for /etc/init.d or you can use Starstop Service on Windows.)
69
70If Earthworm doesn't run properly, check the logs directory if the error output of startstop isn't helpful. If you can't figure it out, join and then email the Google Groups Earthworm list
71http://groups.google.com/group/earthworm_forum
72
73If you want to learn more about Earthworm and the documentation isn't enough, or if you want to learn how to program your own Earthworm modules, ISTI runs an Earthworm class approximately yearly. Contact ISTI to see about the current schedule, availability and cost for the course. http://www.isti.com/contact-info
74
75COMPILING
76
77See the src/README for a some additional information.
78
79If you want to compile the Earthworm binaries yourself, you must run or source the ew_* file ("environment file") appropriate to your platform. It's located in the environment directory; you may copy it to your params directory.
80
81ew_cygwin.bash   ew_macosx_intel.sh   ew_nt.cmd   ew_sol_sparc.bash ew_linux.bash   ew_macosx_ppc.sh    ew_sol_intel.cmd  ew_sol_sparc.cmd
82Note that ew_nt is for all Microsoft Windows operating systems.
83
84Before you run or source your ew_* file, you must make sure all the directories actually exist that are specified by EW_HOME EW_PARAMS and EW_LOG. Also, you may need to specify the compiler you've got installed, especially if you're using Windows. The directory path must match what you've got. If you don't have a Fortran compiler you won't be able to compile Hypoinverse used to locate earthquakes, but you should be able to compile most other modules. You may need to comment hypoinverse out of the makefiles.
85
86To compile, after you've run or sourced your environment file, run the following command, depending on your platform.
87nmake nt --- For Windows
88make unix  --- this is for the many flavors of Linux or MacOSX
89make solaris  --- this works for both Sparc or Intel architectures
90
91
92
Note: See TracBrowser for help on using the repository browser.