-
Notifications
You must be signed in to change notification settings - Fork 4
/
Copy pathINSTALL.txt
69 lines (49 loc) · 3.43 KB
/
INSTALL.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
Incorporated Research Institutions for Seismology (IRIS)
Data Management Center (DMC)
Data Products Team
Ground Motion Visualization (GMV)
2020-09-03
------------------------------------------------------------------------------------------------------------------------
DESCRIPTION:
An IRIS DMC Python code bundle to produce Ground Motion Visualization (GMV) for different geographical regions,
sensors. The script can be configured via its parameter file (gmv_param.py) or command line arguments.
Currently parameters are optimized for use with the Lambert conformal map projection and seismic channels.
Change in projection and/or technology may require additional parameter tuning. The code uses the FDSN Web Services
(https://www.fdsn.org/webservices/) to retrieve waveform data.
PYTHON REQUIREMENTS:
- this bundle has been tested under Python 3.8.3, Anaconda3-2020.07 on macOS 10.14.6, Windows 10.1903, and Linux CentOS7.
- additional required Python module(s):
. obspy 1.2.2
. scipy 1.5.2
. numpy 1.19.1
. matplotlib 3.3.1
. basemap 1.2.2
. ffmpeg 4.3.1
BUNDLE INSTALLATION:
- unpack the package
- "src" directory contains all the necessary codes. Other directories will be created and populated as required by
the package.
CONFIGURE THE PACKAGE:
With Python configured, you should be able to run the package examples without any modifications. However:
- if necessary, update the Python path on the first line of the src/gmv_generalized.py
- if desired, configure the package by updating src/gmv_param.py file
PACKAGE TEST:
- To test the package, run src/gmv_generalized.py with -h option (assuming you have properly configured your
Python installation) and it will print a USAGE messages. Try the the examples provided under usage to verify
the installation. As indicated above, examples 1 & 2 will take 1-2 hours and example 3 over 3 hours to complete.
0. A quick (~ 5 minutes) GMV test (not a production run, note how --band, -d and -D are used to make this a quck run)
gmv_generalized.py --band=LH --comp=1 -n AK -t 2020-06-18T12:49:53
-T "June 18, 2020, South Of Kermadec Islands, M 7.4" -m 7.4 -z 10.0 -e -33.29,-177.84 -r ak -d 1200.0
-s 6.0 -p 466.0 -q 2.5 -g 5 -D 0.5 -G -o GMV_Example_Short_Z
1. Sample run with the least number of arguments:
gmv_generalized.py -e 55.1046,-158.4725 -z 10.0 -m 7.8 -t 2020-07-22T06:12:42 -o GMV_Example_Default
2. Sample complete run:
gmv_generalized.py --band=LH,BH --comp=1 -n all -t 2020-07-22T06:12:42 -T "July 22, 2020, Alaska Peninsula, M 7.8" -m 7.8 -z 10.0 -e 55.1046,-158.4725 -r ak -d 1200 -s 6.0 -p -180 -q 3.5 -g 3 -D 0.05 -G -o GMV_Example_Custom
3. Sample 3C run:
gmv_generalized.py --band=LH,BH --comp=3 -n all -t 2020-06-18T12:49:53 -T "June 18, 2020, South Of Kermadec Islands, M 7.4" -m 7.4 -z 10.0 -e -33.2938,-177.8383 -r ak -d 4129.103856185302 -s 6.0 -p 466.17595138658135 -q 2.5 -g 5 -D 0.05 -G -o GMV_Example_3C
- Simply run any of the examples provided in the usage message.
CREDITS:
- Chuck Ammon, Professor of Geosciences at Penn State’s original concept and visualizations
- Bob Woodward at IRIS – adapted the visualization code to MATLAB
- IRIS DMC Data products expanded and enhanced the MATLAB code.
- IRIS DMC Data products created the Python code based on the code in MATLAB.