FetchSyn usage » History » Version 18

Alexander Hutko, 01/07/2016 05:25 PM

1 1 Alexander Hutko
h1. FetchSyn usage
2 1 Alexander Hutko
3 10 Chad Trabant
{{>toc}}
4 6 Alexander Hutko
5 7 Alexander Hutko
h2. Download
6 7 Alexander Hutko
7 7 Alexander Hutko
Users should download the latest version:  "FetchSyn":https://seiscode.iris.washington.edu/projects/ws-fetch-scripts/files
8 1 Alexander Hutko
9 12 Alexander Hutko
h2. Python dependencies
10 12 Alexander Hutko
11 14 Alexander Hutko
The requests library is needed.  Currently FetchSyn is compatible with python 2 & 3.
12 12 Alexander Hutko
13 1 Alexander Hutko
h2. Executing the scripts
14 1 Alexander Hutko
15 1 Alexander Hutko
After downloading the scripts they can be executed from the command line either by explicitly invoking python or by making the scripts executable and installing the path to python in the first line.  To explicitly invoke python to execute a script type the following:
16 1 Alexander Hutko
17 1 Alexander Hutko
<pre>
18 1 Alexander Hutko
$ python FetchSyn
19 11 Alexander Hutko
</pre>
20 11 Alexander Hutko
21 2 Alexander Hutko
h2. Help menu to list parameters
22 1 Alexander Hutko
23 1 Alexander Hutko
To access the help menu, which lists all input parameters:
24 1 Alexander Hutko
25 1 Alexander Hutko
<pre>
26 15 Alexander Hutko
$ FetchSyn -u
27 1 Alexander Hutko
</pre>
28 1 Alexander Hutko
29 1 Alexander Hutko
h2. Examples
30 1 Alexander Hutko
31 2 Alexander Hutko
To generate a synthetic for IU.ANMO for the Tohoku earthquake using it's GCMT origin and moment tensor:
32 1 Alexander Hutko
33 1 Alexander Hutko
<pre>
34 15 Alexander Hutko
$ FetchSyn -N IU -S ANMO -evid GCMT:M201103110546A
35 2 Alexander Hutko
</pre>
36 2 Alexander Hutko
37 2 Alexander Hutko
Same request, but add station KIP and make the source depth 35km and return the vertical (Z), radial (R) and transverse (T) components rather than the default ZNE components:
38 2 Alexander Hutko
39 2 Alexander Hutko
<pre>
40 15 Alexander Hutko
$ FetchSyn -N IU -S ANMO,KIP -C ZRT -evid GCMT:M201103110546A -sdepm 35000
41 2 Alexander Hutko
</pre>
42 2 Alexander Hutko
43 2 Alexander Hutko
44 2 Alexander Hutko
Same request, but:
45 2 Alexander Hutko
*include all stations in the virtual network _GSN
46 13 Alexander Hutko
*use a different "model":http://ds.iris.edu/ds/products/syngine/#models
47 2 Alexander Hutko
*change the sample rate to 0.05 sps
48 2 Alexander Hutko
*make the output miniseed rather than saczip
49 2 Alexander Hutko
*return velocity not the default (displacement)
50 2 Alexander Hutko
*cut the traces to 10 seconds before P
51 2 Alexander Hutko
*make traces 300 seconds in duration
52 17 Alexander Hutko
*add user-agent identification to help if there are problems
53 2 Alexander Hutko
54 1 Alexander Hutko
<pre>
55 18 Alexander Hutko
$ FetchSyn -N _GSN -model prem_a_20s -dt 0.05 -format mseed -units velocity -start P-10 -end 300 -A "Joe Seismologist" -C ZRT -evid GCMT:M201103110546A -sdepm 35000
56 2 Alexander Hutko
</pre>
57 1 Alexander Hutko
58 8 Alexander Hutko
h3. Manually input source and use a file with a list of receivers
59 1 Alexander Hutko
60 4 Alexander Hutko
Example using a text file with receiver names.  Each line of the receiver file is an example of valid formatting.  The networkcode, stationcode, locationcode in the later lines is optional.
61 4 Alexander Hutko
62 16 Alexander Hutko
rec.txt:
63 1 Alexander Hutko
<pre>
64 4 Alexander Hutko
IU ANMO 
65 4 Alexander Hutko
II *
66 4 Alexander Hutko
-89 -179
67 4 Alexander Hutko
-89 -178 S0002
68 4 Alexander Hutko
-89 -177 N2 S0003 L2
69 1 Alexander Hutko
</pre>
70 2 Alexander Hutko
71 4 Alexander Hutko
Manually input the origin using a double couple source (strike,dip,rake[,optional_scalar_moment_in_NM])
72 2 Alexander Hutko
73 2 Alexander Hutko
<pre>
74 15 Alexander Hutko
$ FetchSyn -recfile rec.txt -origin 2011,03,11,05,46,24 -slat 38.3 -slon 142.3 -sdepm 24400 -dc 203,10,88,5.3e22 -C Z
75 1 Alexander Hutko
</pre>