source: SH_SHM/trunk/doc/util.inf @ 373

Revision 16, 4.5 KB checked in by marcus, 14 years ago (diff)

r1 | svn | 2007-12-13 11:10:29 +0100 (Do, 13 Dez 2007) | 2 lines

Initial import

Line 
1
2
3SH utilities
4============
5
6   K. Stammler, 7-Aug-92
7
8
9
10locdiff
11-------
12
13   Computes difference between two locations.  The correction for ellipticity
14   of the earth is applied.  The locations may be specified either directly
15   or by a station name.
16
17   Syntax:
18      locdiff <lat1> <lon1> <lat2> <lon2>
19      locdiff <lat> <lon> <station>
20      locdiff <station1> <station2>
21
22   Please note that no hyphens are allowed in the command line (Actually hyphens
23   are used for identification of qualifiers --> UNIX).  Negative angles must
24   be specified by a preceding "s" or "w" for latitude and longitude,
25   respectively.
26
27   Examples:
28      locdiff s30.3 w80.5 49.7 11.2
29      locdiff s30.3 w80.5 n49.7 e11.2
30      locdiff s30.3 w80.5 gra1
31      locdiff khc gra1
32
33
34
35locadd
36------
37
38   Adds distance and azimuth to a given location.  No correction is applied
39   for ellipticity of the earth.  The input location may be specified
40   either directly or by a station name.  Result is an output location
41   (latitude, longitude) and the name of the Flinn-Engdahl-Region.
42
43   Syntax:
44      locadd <lat> <lon> <distance> <azimuth>
45      locadd <station> <distance> <azimuth>
46
47   Please note that no hyphens are allowed in the command line (Actually,
48   hyphens are used for identification of qualifiers --> UNIX).  Negative
49   angles must be specified by a preceding "s" or "w" for latitude and
50   longitude, respectively.
51
52   Examples:
53      locadd s30.3 w80.5 100.3 271.1
54      locadd gra1 100.3 271.1
55
56
57
58fereg
59-----
60
61   Returns name of Flinn-Engdahl-Region for a specified location.  The
62   location must be specified directly.
63
64   Syntax:
65      fereg <lat> <lon>
66
67   Please note that no hyphens are allowed in the command line (Actually,
68   hyphens are used for identification of qualifiers --> UNIX).  Negative
69   angles must be specified by a preceding "s" or "w" for latitude and
70   longitude, respectively.
71
72   Example:
73      fereg s30.3 w80.5
74
75
76
77statloc
78-------
79
80   Returns location of a specified station as noted in the file
81   SHC_INPUTS:STATLOC.DAT.  The first two numbers of the output line
82   are station latitude and longitude, respectively.
83
84   Syntax:
85      statloc <station>
86
87   Examples:
88      statloc gra1
89      statloc stu
90
91
92
93pde_select
94----------
95
96   Selects events from PDE files.  Output is a list of events written to screen
97   or to a file.  The list contains one line per event with information
98   about origin time, location, depth, magnitude, distance, azimuth and
99   back-azimuth.  The selection is done by specifying limits for distance,
100   depth, magnitude and year of event.  Distance, azimuth and back-azimuth
101   a referred to a receiving station which has to be entered.  It is
102   possible to specify two cross-reference lists, named "bad events" and
103   "used events", which should also be event lists (created earlier).
104   The events of these two lists are marked in the new created output list
105   if they are selected.  If you don't want to use cross-reference lists
106   enter <Return> on the according prompts.  If no output file is specified
107   the list is printed on the screen.  An output file should be entered
108   without extension.  The default extension for these event files is
109   ".evl"
110
111   Example:
112      pde_select
113         enter name of receiving station: grf
114         enter minimum, maximum distance (in deg.): 40 100
115         enter minimum, maximum depth: 100 200
116         enter minimum, maximum mb: 6 8
117         enter minimum, maximum year: 1989 1991
118            bad events :
119            used events:
120         enter output filename (<CR>=screen): event89_91
121         number of events =            4
122
123   This example creates an output file "event89_91.evl".  The events listed
124   are sorted by date.  The file may be resorted by one of the following
125   sorting routines.
126
127
128
129pdesort_baz
130-----------
131
132   Sorts an ".evl"-file by back-azimuth.  The input file must be specified
133   without extension (it is assumed to be ".evl").  The input file is not
134   changed, as output a new ".evl" file is created.  The name of the
135   output file is the name if the input file, extended by the string "_baz".
136
137   Syntax:
138      pdesort_baz <event-list>
139
140   Example:
141      pdesort_baz event91
142
143   This example reads the file "event91.evl" and creates a resorted output
144   file "event91_baz.evl".
145
146
147
148pdesort_dist
149pdesort_depth
150pdesort_mag
151pdesort_date
152------------
153
154   Analoguous to "pdesort_baz", but resorting is done for distance, depth,
155   magnitude or date, respectively.  The input filenames are extended by
156   the strings "_dist", "_depth", "_mag" or "_date", respectively, to form
157   the output filename.
Note: See TracBrowser for help on using the repository browser.