wiki:ShmDocMenuFileRead

Version 2 (modified by MarcusWalther, 14 years ago) (diff)

--

Menu Entry Read

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.

Station list

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

Component to read in. The three components can be selected independently. Most common: z or z,n,e.

Channel

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.

Start time

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. A second string in such a time entry, separated by one or more blanks, may exist and contain the (absolute) path and name of an existing evt-file. Then a Read New on this line will automatically read the content of this evt-file into SHM. This includes an automatic display of all given phases in the evt-file.

Read length

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.

Location of the directory file sfdfile.sfd

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.

Additional options

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.

Buttons Read Again and Read New

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 or Cancel Parameters has been selected for the previous event.

Button Cancel

Closes the dialog box without any action.

Button Reset

Resets the buttons of this dialog box to some default value (not configurable yet, sorry).

back to documentation index