The menu entry Read is the interface to MiniSEED formatted data. It opens a dialog box to let the user select the requested data streams and time window. Necessary information is station list, channel, component, start time, length of time window and location of the directory file sfdfile.sfd:
There is a fixed number of 30 buttons for specifying the list of stations. The stations may be selected either directly one by one or by hitting one of the two subset buttons below these 30 buttons. The Next button switches to another set of stations if defined (see below). The all button is obsolete and should not be used.
Component to read in. The three components can be selected independently. Most common: z or z,n,e.
Channel to read in. Select one or more out of LH, BH, HH or an editable field. The channel name is given by the MiniSEED file. Usually LH data are sampled up to 1Hz, BH is up to 40Hz and HH is more than 40 Hz.
The start time is given by two editable fields holding date and time. It may be edited directly, but please keep to the format <day>-<textmonth>-<year> and <hour>:<min>:<sec>, where <textmonth> is a three-character abbreviation of the month. More convenient it is to use the arrow buttons above and below the edit field changing day, month, year, hour, minutes and seconds separately. If you have a detection list in a text file you may use this text file as an input to the start time field. The text file must have one time per line in the SH time format. By clicking on the text field below the start time field (initially set to eventlist) a file selection box appears, where the detections text file must be specified. Then the arrow buttons left and right to the eventlist-field let the user scan through all detection times of the text file.
The read length is specified in minutes, preferably by dragging the ruler right to the start time field. The range of values is from 1 to 60 minutes. Other values may be entered by editing the read length text field above the ruler.
The MiniSEED interface needs a directory file named sfdfile.sfd listing all available MiniSEED files. This file can be created by the sfdlist utility (see Reading MiniSEED files). Its location must be entered into the sfd text field in the lower right corner of the dialog box. It is recommended to define an environment variable pointing to the directory holding sfdfile.sfd before starting SHM (e.g. setenv SFD /home/gonzo/data). This environment variable (here SFD) should be entered into the sfd text field.
Button Keep Traces: does not delete the traces on display before reading new ones. Useful if data are distributed in different files of different formats. Use this option with care and avoid reading the same stations into SHM twice. Button PC-Sun Sfd: read data on a PC (Linux) using an sfdfile.sfd which was generated on a Sun. Button Fbox: if this button is selected a click on the sfd edit field (to the right of it) opens a file selection box. In this file selection box an sfdfile.sfd may be specified which is used for reading MiniSEED data.
These two buttons perform the reading command of MiniSEED data with the settings made in this dialog box. The difference is that Read Again keeps all analysis parameters derived before this read command while Read New deletes all previous information (phase readings, beam parameters, source locations). Read Again is used for reading additional stations or a different time window while working on the same event, Read New is used for reading a new event. For safety reasons Read New is allowed only after either Final Parameters (LinkNeeded) or Cancel Parameters (from the menu title Work) has been selected for the previous event.
Closes the dialog box without any action.
Resets the buttons of this dialog box to some default value (not configurable yet, sorry).
The names of the 30 station buttons and the 2 subset buttons are read in from a file $SH_GLOBALS/STATLIST_DEFAULT.STX when starting SHM. A click on the Next button of the Read dialog box switches from this file to $SH_GLOBALS/STATLIST_01.STX. Another click on Next switches to $SH_GLOBALS/STATLIST_02.STX and so on. If a file STATLIST_xx.STX does not exist it switches back to STATLIST_01.STX. The format of the STATLIST_... files is:
all lines starting with an exclamation sign ! are comments and ignored
set1: <start> <end> <name> This line defines the name and range of the first subset button (<start> number of first button, starting with 0, <end> number of last button, <name> label of button). A click on this button selects/deselects all station buttons within the specified range.
set2: <start> <end> <name> Name and range of the second subset button. Syntax as above.
* <name> 30 lines of this shape, defining the labels of the 30 station buttons. Please use names less than 5 characters. A name of three hyphens (---) disables the button.
Please see the existing files as examples. A reasonable setup of the STATLIST_... files in $SH_GLOBALS would be: STATLIST_DEFAULT.STX is a link to STATLIST_01.STX. This STATLIST_01.STX contains your station list. STATLIST_02.STX holds an alternative list of stations. Then SHM would start up with your stations as default, the Next button would switch between the two station lists of STATLIST_01.STX and STATLIST_02.STX.
What if the number of buttons is not enough?
In this case use the Next button option as described above or you should create your own station list buttons, i.e. these are buttons which address more than one station. Station list button have names starting with an underscore (like '_N') and have a corresponding station list file in $SH_GLOBALS with extension .STA (e.g. $SH_GLOBALS/_N.STA) . This corresponding text file contains the station list, one station per line (no commas). '_N' could stand for the northern part of you station network. In this way you could create similar buttons '_S', '_W' or '_SW'. Please note that SHM does currently not accept more than one station list button to be selected at a time. If you want to read in more than one station list, repeat reading with always one button while having the Keep Traces button switched on.
To summarize, the steps to insert new stations to SHM are:
insert station code and coordinates into $SH_INPUTS/STATINF.DAT (see How to put station information into SH/SHM)
Modify a STATLIST-file in $SH_GLOBALS and include the new stations so that you get a button to select for each. If you have only one STATLIST, this is $SH_GLOBALS/STATLIST_DEFAULT.STX (at least in more recent SHM versions).
Create files $SEED_INPUTS/seedcalib_<station>-<chan>-<comp> (e.g. for a station GRFO create one file for each channel in $SEED_INPUTS: seedcalib_grfo-bh-z, seedcalib_grfo-bh-n, seedcalib_grf-bh-e, also for other channels like, lh or hh if necessary). In this file you put the time window where the calibration is valid and the calibration value into one line, you can add several lines, one for each time window. Have a look at the existing files for details (NeedLink).
Add the streams of this stations to the file $SH_INPUTS/filter_lookup.txt or create appropriate filter files in $SH_FILTER. Read about working with simulation filters for details.
This page last modified 10-Sep-2005