| 1 | |
|---|
| 2 | |
|---|
| 3 | SH utilities |
|---|
| 4 | ============ |
|---|
| 5 | |
|---|
| 6 | K. Stammler, 7-Aug-92 |
|---|
| 7 | |
|---|
| 8 | |
|---|
| 9 | |
|---|
| 10 | locdiff |
|---|
| 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 | |
|---|
| 35 | locadd |
|---|
| 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 | |
|---|
| 58 | fereg |
|---|
| 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 | |
|---|
| 77 | statloc |
|---|
| 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 | |
|---|
| 93 | pde_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 | |
|---|
| 129 | pdesort_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 | |
|---|
| 148 | pdesort_dist |
|---|
| 149 | pdesort_depth |
|---|
| 150 | pdesort_mag |
|---|
| 151 | pdesort_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. |
|---|
