next up previous contents index
Next: 5.5 Instrument response Up: 5. Using SEISAN Previous: 5.3 Interactive work with   Contents   Index

5.4 How EEV works

It is now assumed that data has been entered into the database. The fundamental tool for the database is then the EEV program, which mostly works within the limits of one month in the standard database or with whatever the user has of S-files in his own directory. Optionally, EEV can also work with several months. A special option is to use a list of files in an INDEX file, see end of this section and SELECT program. Some of the commands available within EEV are also available within programs. See below for more details on EEV.

The EEV program reads the file names of all S-files in the database monthly directory (or local directory or index file), positions the pointer at the first event and asks for a command to be performed for the current event or to find another event. If the command is to use a program, control is handed over to that program, which on completion hands control back to EEV. In this way, many different independent programs can be used from within EEV, e.g. several different location programs can be installed.

EEV can be started in several ways:

EEV with one month in default database: EEV yyyymm.
E.g. EEV 199201 would work on January 1992 on the standard BER database. It is here also possible to give a more precise start time like EEV 1992011520 to start with the first event at or after January 15 at 20 hrs.

EEV with one month in alternative database: EEV yyyymm BASE.
BASE is the database. To work on the NAO base, the command would be EEV 199201 NAO.

EEV with several months in default database: EEV yyyymm YYYYMM
yyyymm is start year and month and YYYYMM is end year and month.

EEV with several months in alternative database: EEV yyyymm YYYYMM BASE
yyyymm is start year and month and YYYYMM is end year and month.

EEV to work with events is local directory: EEV
Only the S-files in local directory will be used.

EEV to work with an index file: EEV index.out
EEV can work with an index file and the command would be EEV index.out, where index.out is the index file name (can have any name as long as it contains a `.' except when used with HYP). For information on index files, see 11.

Databases can have 1-5 letter names and the user specify 1-5 letters. The real names in the directory structure are always 5 letters so if the user specifies e.g. a base name of BA, the real name will be BA___ . The full 5-letter name can also be used.

The commands in EEV mainly use only one letter unless a date or a number has to be given. To get a short explanation, type ? and you will get:

 Help on EEV

 ?         Print this help file
 #xx:      Go to event # xx, also works without the #
 Axx:      Append event # xx to current event, original event
 AA:       Append current event to next event, original event remains
 ARC:      Add an archive line
 ARC _:    Add an virtual network archive line using the name given 
           after the _ like: ARC _GSN
 ARCDEL:   Delete all archive lines
 ARX:      Extract waveform file from archive and put in S-file
 AMPRATIO: Automatic amplitudes for ratio
 AR:       Same as above
 AUTOSIG:  Automatic processing with autosig
 AUTOMAG:  Automatic magnitude, all defualts 
 AM:       Same as automag
 AMI:      Automag with questions about window lengths
 AUTOPHASE Automatice phase picking with Lomax routine in AUTOPHASE
 AP:       Same as autophase
 B:        Back one event
 BOUCH:    Run Bouchon's modeling program
 BOUSEI:   Make SEISAN file from Bouchon synthetic file
 C:        Copy event to another data base or to current directory
 CM:       Copy out several events to eev.out
 COMMENT:  Write comment lines in S-file
 COM:      Same as COMMENT
 COMF:     Add one or several felt information lines
 COML:     Add one geographical location line
 COMP:     Write province comment line in S-file
 COMT:     Write intensity comment line in S-file
 D:        Delete current event, you will be prompted to confirm
 DD:       Duplicate header line in S_file
 DELS:     Delete specific phase lines in S-file, like P-phases
 DUP:      Duplicate current event in data base, different id
 Dxxxxxx:  Go to first event on date xx, hour xx, min xx
 E:        Edit S-file
 EM:       Edit ISO file in ISO directory
 EP:       Edit print.out file
 EXP:      Enter explosion information
 Eyyyymm:  Let EEV session end with year yyyy and month mm
 F:        Make a fault plane solution with FOCMEC
 FH:       Make a fault plane solution with HASH
 FI:       Make a fault plane solution with PINV
 FP:       Make a fault plane solution with FPFIT
 FPFIT:    -------------------------------------
 FO:       Plot all fault plane solutions, no questions, with polarities
 FOO       Plot all fault plane solutions, no polarities needed
 FQ:       Enter quality and position prime fps at top
 FD(IF):   Compare P and T axis from two different fps
 FIX:      Fix, unfix or set fixed depth
 GRID:     Locate by grid search
 GMAP:     Make epicenter maps with Google Map or Google Earth
 GMTMAP:   Makes a GMT map  like the MAP commnad
 HERRMANN: Run Herrmann's modelling program (not PC)
 HERSEI:   Make SEISAN file from Herrmann synthetic file (not PC)
 H:        Locate with Hypoinverse
 HYPO71:   Locate with Hypo71
 IASP:     Generate arrival times using IASPEI91 tables
 IC:       Insert comment as specified in SEISAN.DEF
 IL:       ISC location program (unix only)
 INPUTEPI: Input hypocenter and origin time in S-file from st. input
 INPUTONE: Input an additional type one line (hypocenter line)
 INPUTFPS: Input complete fault plane solution line
 IFP:      Input fault plane solution strike, dip, rake, Ag., Prog, Q.
 INPUTX:   Input of xnear and xfar, RESET TEST 107 must be 1.0
 INVRAD:   Make moment ternsor inversion with Invrad
 Jyyyymm BAS:Jump to year yy and month mm in base BAS
 L:        Locate event, will also calculate magnitude if not
           locatable but distance is present, Hypocenter
 LR:       Reject outliers and locate, see also command UR
 LL:       Locate current and next event together
 Lxx:      Locate current and event xx together
 M:        Input model indicator on header line
 MTD:      Delete all mt and synt lines
 MTE:      Edit MT parameters in S-file
 MTP:      Make Moment Tensor (MT) parameters
 MTG:      Make Green's function for MT
 MTI:      Invert for MT solution
 MAC:      Input macroseismic information
 MACROMAP: Make a GMT based map of felt information, Unix only
 MAP:      Make a map of current location with EPIMAP
 MAPF:     ------------------------------------- showing fps if there
 MODELS:   List MODEL.DEF file in DAT
 NEW:      Add a new event to data base
 WKBJ:     Make synthetic seismograms with WKBJ program
 O:        Operating system command, e.g. ols is ls, ocd test is cd test
           do not currently work on command with prompt input like epimap and  
 P:        Plot event, also make hard copies and pic phases
 PO:       Plot event with defaults, multi trace mode
 POL:      Plot vertical channels P onset with polarities
 POO:      Plot event with defaults, single trace mode
 PB:       Plot Bouch synthetics
 PH:       Plot Herrmann synthetics
 PW:       Plot wkbj synthetics
 PM:       Plot moment tensor synthetics
 PD:       Plot extracted data file mulplt.wav
 PG:       Ploty Greens's functions when doing MT
 PF(IT):   Get back azimuth and app. Velocity for network P-arrival
 PITSA:    Start Pitsa program (not on PC)
 PRINT:    Print S-file on printer
 PMAC:     Macroseismic Windows program
 PMM:      Plot moment vs time
 PML:      Plot Ml vs distance
 PP:       Plot picture file in PIC or in local dir
 PS:       Plot spectra and WA pickssk made with command AM
 PSPEC:    Same as PS
 PUT:      Register event
 Q:        Quit EEV
 QUARRY:   Quarry check command
 R:        Rename event type, must be L, R or D 
 REG:      Register event
 RMSDEP:   Calculates and plots RMS as a function of depth
 SAC:      Run SAC
 Sxxxxxx:  Search for next two events which are within xxxxxx seconds. If time  
           blank, a default of 180 secs is used
 STD:      Set or unset start location depth flag, also set depth
 STE:      Set or unset start location epicenter flag
 SS:       Find next unprocessed event in base
 SYNT:     Make parameters for synthetic modelling
 T:        Type event
 TT:       Type only header line of event
 TTPLOT:   Make travel time plot
 U(PDATE): Updates S-file with hypocenter etc.
 UPDREJ:   Update event eleiminating rejected phases
 UR:       Reject outliers and update S-file with hypocenter etc.
 USERCOM:  Start user defined command as 'usercom -sfile <sfile-name> '
 WAD:      Make a wadati diagram
 UP:       Update list of S-files
 W:        Show location of waveform files
 Z:        Auto pic current event, if readings available, new pics
           will be added with a flag 

 jh feb 10  2017

Note: Command letters can be upper or lower case.

Comments to commands:

#XXX : Go to event by number. When giving a number, only give the number of digits needed, no formatting. Thus e.g. to find event 7 or 777, write 7 or 777 respectively. If there is not an event corresponding to the parameter specified, EEV will go back to event #1. In the number command, # can be omitted.

Axxx: Append another event to current event. The event specified is appended to current event. All header and lines in both files are saved and put in order in the current event. The main first header is from the current event. The ID line for the appended event is saved as a comment line. The user will be questioned if the appended event is to be deleted.

AA: Same as above using next event.

ARC: Adds an archive line so event can be plotted, see SEISAN.DEF for defaults to set. Use 'ARC _VNET' (where VNET is an example of virtual network) to create ARC line with the virtual network.

ARC _: Adds an archive line for the virtual network name given after the _ like ARC _GSN for the GSN virtual network.

ARCDEL: Deletes all ARC lines in the S-file

ARX: Extract waveform file corresponding to S-file and adds thew waveform file name to the S-file. See program GET_ARC for details.

AMPRATIO: Run program AUTORATIO 25 to measure P and S amplitudes to be used as amplitude ratios in FOCMEC and HASH.

AUTOSIG: Automatic processing with autosig program.

AUTOMAG and AM: Automatic amplitude for Ml and automatic spectral analysis. Only S-waves are used and fixed windows are used.The results are overwriting result in S-file. For more details see program AUTOMAG.

AMI: AUTOMAG, but questions about spectral window and window for Ml are asked. Type of spectrum (P or S) is also asked.

AUTOPHASE and AP: Automatic phase picking with Lomax picker.

AUTORATIO and AR: Automatically calculates amplitudes from spectra and time domain for use with FOCMEC.

B: Back one event

BOUCH: Run Bouchon's modeling program

BOUSEI: Make SEISAN file from Bouchon synthetic file

C: Copy events
There are two options, copy the event to another database given by a 1-5 letter name (upper case) or to a file EEV.OUT in your working directory. Several files can be extracted within one EEV session to the same EEV.OUT file. A new EEV session deletes the previous eev.out file. The C option can be used to recover files from the DELET database of deleted events. In addition to making the EEV.OUT file, an index file is also made called indexeev.out. THIS FILE IS NOT DELETED WHEN EEV STARTS UP since the intention is to be able to use EEV to make an index file of interesting events from several months. You can then start eev with the selected events with command EEV eevindex.out. Note: The other data base can also be a local data base ``,,'' in which case EEV should not operate on the same local data base. CM: Copy many files to eev.out. The copying starts at current file and the user is asked for the number of files to copy. COMMENT: Comment are written into S-file, terminated by a blank line.

DXXXXX; The D-command is used to jump to another event at a given date and time, normally only day is used: The hour can optionally be specified. E.g. d2205 will find the event nearest in time after day 22 at 05 hours. If both day and hour is used 4 digits MUST be given e.g. 0708. Highest accuracy is the nearest minute.

D: Delete event You are asked for confirmation. After the event has been deleted, all S-file names are read in again and all event numbers after the deleted event are therefore changed. The deleted event is automatically saved in the DELET database. If the event is present in the CAT file, it remains there until the next update is done, see UPDATE command in 14.

DD: Duplicates the header line

DUP: Duplicates an event in the database. The duplicated event has an ID, which is one second different from the original event. The command can be used to split an event in two and then manually deleting phase lines in each. E: Edit the event. As default on SUN vi is used and on PC edit is used. The editor can be changed, see section 3. When control goes back to EEV, the file is checked for possible typing errors or other format problems. If a problem is encountered, the line with the problem is displayed with an indication of where the mistake might be, and the user is returned to the editor. Alternatively the error can be ignored. The file is also checked for missing iD and consistency between file name and ID. Problem: Some editors will keep a backup copy of the original file so 2 files might be present with one e.g. with the additional extension .BAK. EEV (from version 7.2) will only use the original file, but there is no check on what backup files might accumulate.

EM: Edit ISO file in ISO directory. The ISO file name must be listed in the S-file.

Eyyyymm: Giving this command will make the current EEV session end with year yyyy and month mm within the same data base. When EEV gets to the end of the month, pressing return will move EEV to the first event of the following month instead of to the first event of the same month.

EXP: Input of explosion information. This command creates 3 new lines (see format description in Appendix A) and changes the main header line event type to explosion (E). The user is asked for location, time, charge and comments. The explosion agency is used to classify types of sites and can be used by SELECT for searching. If no event is available, a new event must be created with EEV command NEW.-

F: Make a fault plane solution. The program uses polarities. See section 23.1 for more details.

FO: Just plot a solution in S-file. It must have data so it can be located. Polarities are shown.

FOO: Plot solutions even if no phases in S-file. Polarities are not plotted.

FD: Calculate the difference in orientation of P and T axis of any two fps

FI: Fault plane solution using PINV

FH: Fault plane solution using HASH.

FP: Fault plane solution using FPFIT.

FQ: Enter quality of fault plane solution. It is also possible to order the solutions so the prime comes first.

FIX: Fix or unfix depth. It is also possible to give the depth.

GMTMAP: Start gmtmap.exp program (not included in SEISAN) to plot GMT map. GMTMAP automatically creates a map using GMT. (UNIX only)

GMAP: Make an epicenter map of current event using Google Earth or Google Map. It is also possible to make maps with many epicenters using GMAP outside EEV, see section 10.3 for more details.

GRID:. Hypocenter is started up and will ask for the grid: Latitude and longitude range and grid spacing. A maximum of 71 points can be used in each direction. The point with the lowest RMS is found and the corresponding location and residual is printed on the screen. It is now optionally possible to plot the contours on the screen. The map coordinates used are as defined in SEISAN.DEF. Note that the grid search is using exactly the same parameters as Hypocenter. This includes all weights and phase types. The depth is fixed to the depth given in the S-file header line. For more details and an example, see application note epi.pdf in INF.

H: Locate with Hypoinverse, no database update is made, no Nordic output format file.

HERRMAN: Herrmann's modeling programs, only on Sun, might work on Linux, not tested.

HERSEI: Make a SEISAN waveform file from output of Herrmann modeling, only tested on Sun.

HYPO71: Locate with HYPO71. The database is not updated (not well tested on PC).

IASP: Generate a file with theoretical arrival times for the current event for stations listed in S-file. . The command will only work if the event has an epicenter and origin time in header line or a subsequent type 1 line, see also HERSEI: Make a SEISAN waveform file from output of Herrmann modeling, only tested on Sun.

HYPO71: Locate with HYPO71. The database is not updated (not well tested on PC).

IASP: Generate a file with theoretical arrival times for the current event for stations listed in S-file. . The command will only work if the event has an epicenter and origin time in header line or a subsequent type 1 line, see also INPUTEPI and INPUTONE. These theoretical times will then be displayed with mulplt, the next time command P is used in EEV. The theoretical times are listed in file iasp.out. See section 30.3 for more information. The command can also be used directly from MULPLT and in this case theoretical travel times are calculated for all stations in waveform file(s).

IC: Enter one of predefined comments. The comments are given in SEISAN.DEF and any number of comments can be predefined. Example:

    7  1 Jan 2015 13:35 39  LQ 78.312   7.560 15.0    0.9 2.0LBER    8  ? ic

Predefined comments are:


1 Calculated depth is 0km, fixated to 10km due to uncertain depth

2 Calculated depth is 31km, fixated to 10km due to uncertain depth

3 Calculated depth is >31km, fixated to10km due to uncertain depth

4 Probable explosion due to spectrogram and waveform

5 Induced event rapported on,

6 Probably explosion at Rana Gruber, Storforshei

7 Probably explosion at Titania

8 Probably explosion at Norsk Stein

9 Probably explosion at Slovaag, Sogn & Fjoradn

10 Probably explosion at Eikefet quarry


enter number

IL: Makes a location with the ISC location program. For more info, see section 7.3

INPUTONE: Makes an additional type one line (hypocenter line) in the file. Enter the data exactly under the columns indicated. The line will be entered exactly as written, so it is possible to enter any part of the information.

INPUTEPI: Works like INPUTONE, except that it overwrites information on the first header line if non-blank information is given. Use INPUTEPI to add information to the first header line like e.g. the depth. If existing nonblank characters on the line are to be replaced by blanks (e.g. remove a magnitude), use underscore ``_''.

INPUTX: Makes a comment line with xnear, xfar and start depth values. Note that RESET TEST(107) must be set for this option to work.

INVRAD: Runs the moment tensor inversion program, see section 23.7.

Jyyyymm BAS: This command makes it possible to change month and database during an EEV session by giving a new year yyyy and month mm and optionally a new database BAS. If no database is given, the same database is assumed.

L: Locate event with HYPOCENTER (same as HYP). The location does not update the S-file.

LR: Reject outliers and locate. Outliers remain in file. Can be removed with command UR. see HYPOCENTER section for more details.

Lxx: Locate current event with event number xx. This is used to check if two events belong together.

LL: Locate current and following event together.

MAC: Enter macroseismic information, you will be prompted for all information. For details of the type of information, see definition of Nordic format, Appendix A. See also command PMAC.

MACROMAP: Felt information is read from a file with macroseismic information and plotted with GMT. The file name of the file with macroseimic observations is given in the S-file.

MAP: Start EPIMAP program to produce a map of current location. If a location is given in the S-file, this location is plotted, otherwise the event is located if possible and the resulting location used for plotting. The parameters for generating the map are set in the SEISAN.DEF file (see 3.10).

MODELS: Lists MODEL.DEF file in DAT that assigns names to single characters in STATIONx.HYP file.

NEW: Creates a new event in the database. The user is asked to give date and time and the event is created in the current monthly database.

O: Give a command to the operating system. This is a very useful command, since it is possible to do almost anything without leaving EEV, including starting a new session of EEV !! E.g. the command ols on Sun and odir on PC would make a directory listing. The name and path of the current s-file is copied to a file named eev.cur.sfile, this makes it easy to write your own programs to handel seisan data.

PF or PFIT: Calculate the apparent velocity and back azimuth using the P-arrival times stored in the S-file. The calculation is done by a free standing program PFIT, which also can be called outside eev. It is assumed that the arriving wave can be approximated with a plane wave so this option is intended to be used with events which are far away relative to the size of the network which then can be considered a seismic array. The station coordinates are taken from the default station file and there is no correction for station elevation. When starting the pfit option, the user will be given a choice of reference station and maximum distance from the reference station. Linear distances will then be calculated from the reference station and possible results will be associated with the reference station. All P-phases given as P, Pn, PN, Pg, PG, PKP, PB and Pb will be used and it is up to the user to ensure that the event file only contains the phases to be used. The output is displayed on the screen and the linear fit can be shown on a plot, which also can be used to interactively check individual station values, see example below.

Example run of PFIT

 Give reference station, enter for using first station in list
 Maximum distance from reference station, default is 1000 km

 2007  1 5 1652 23.3 D  55.991-159.065 13.5  BER 19 1.2 5.3SBER 5.5BBER 5.4BPDE
 Stations available: 18  Stations used: 14
 Stat      Delta t  Latitude Longitude         x         y
 HYA         0.000    61.165     6.182     0.000     0.000
 LOF       -44.970    68.132    13.541   394.668   774.733
 MOR8      -34.220    66.285    14.732   458.521   569.318
 NSS       -23.720    64.531    11.967   310.275   374.227
 MOL        -9.540    62.570     7.547    73.220   156.192
 DOMB       -6.840    62.073     9.112   157.158   100.965
 ASK         0.810    60.472     5.201   -52.618   -77.095
 RUND        4.060    60.414     5.367   -43.680   -83.581
 BER         4.820    60.384     5.335   -45.414   -86.880
 EGD         3.270    60.270     5.223   -51.403   -99.501
 ODD1        5.600    59.911     6.627    23.891  -139.457
 BLS5        9.920    59.423     6.456    14.712  -193.739
 KONO        9.630    59.649     9.598   183.221  -168.571
 SNART      18.280    58.339     7.210    55.130  -314.293
 Reference station is: HYA  
 Back azimuth =358.8  Apparent velocity =19.81  corr =-0.99  rms =   0.03

Relative to the reference station, the above output gives relative P-times and relative x and y-coordinates (km). It is also seen that only 14 station were available within 1000 km from the reference station HYA. These results are also available in an output file array.out. See also array processing section 6.29 on FK-analysis.

Figure 5.1: The linear fit of P-arrival times to a plane wave. For more details, see Havskov and Ottemöller [2010].

PMM: Plot moment as a function of time. The values are taken from the SPEC lines. The intention is to get an idea if the attenuation is correct by seeing the trend. If the line has a negative slope, then the Q value is too and vise versa. On top of the plot the corresponding Q correction needed to make the moment distance independent is shown. It is calculated at a third of the corner frequency. This value is only an indication. On the plot it is possible to click on a symbold to get the corresponding channel used.

PML: Plot Ml as a function of distance. The plot can be used to judge any diance biars in the magnitude calculations. On the plot it is possible to click on a symbold to get the corresponding channel used.

PUT: Register event. This option is mainly meant to be used with the SEISNET data collection system. The command cleans up the S-file for all SEISNET operations. It removes commented out ID-lines and copies the waveform files given for the event from the current directory to WAV. The command is equivalent to the register command in MULPLT. If events are auto registered with AUTOREG, the command can be used to clean up and inspect incoming data without using MULPLT directly.

PMAC: Windows only program PROMAC for processing macroseismic information to calculate intensities from felt information and model the macroseismic intensities. The program can also plot associated pictures (in directory PIC). All information is stored in the S-file. The program was written by Bladimir Moreno, and has a separate manual, see INF directory. Program must be installed separately, zip file in SUP.

P: Plot event with MULPLT

PO: Use MULPLT with defaults. This means that no questions will be asked and the plot appears in multi trace mode with default channels and default filters as given in the MULPLT.DEF file in DAT. Useful option for routine inspection of raw data.

POO: Same as PO with the difference that the user enters MULPLT single mode directly.

POL: Plot vertical channels P onset with polarities using program PLOTPOLARITY 24.

PP: Plot picture files with file names stored on type P-lines. The picture files must be in working directory or PIC directory. Several files can be defined in the S-file and the user will be prompted for which one to plot. The system command used for displaying the file must be defined in SEISAN.DEF, parameter PLOT_PICTURE_COMMAND bitmap types and PLOT_PDF_COMMAND for PDF files. An example is found for test event JUNE 3, 1996 at 19:55.

PRINT: The current S-file is printed on the default printer, to set up printer command, see SEISAN.DEF (section 3.10).

PS: Plot spectra and WA picks made with AM command. The bad fits that the user wants to deselect can be deleted interactively.

Q: Quit EEV

REG: Same as PUT.

R: Rename event type - Giving an event a new type requires changing the header in the S-file and the S-file name. All this is done with R-command. You are prompted for a new type (can be the same in which case nothing is done). A new S-file is made and the old deleted. The CAT-file is NOT changed so if no UPDATE is done, the event there will remain with wrong type. Event types are L: Local event, R: Regional event and D: Distant event. Change events id - By adding a second charater to the event type the event id will be changed too. E.g. changing the event to a local explosion one must type LE. Use LB to replace the E with a blank. Standard event id's are: E = Explosion, P = Probable explosion, V = Volcanic and Q = Confirmed earthquake

RMSDEP: Calculates and plots RMS as a function of depth for current event. Note: Program starts by reading STATION0.HYP so if current events uses e.g. STATION1.HYP, STATION0.HYP must be there also.

SAC: Convert all data to SAC format and starts the SAC processing system ( not distributed with SEISAN, must be obtained separately), not on PC.

Sxxxxxx: Search for next pairs of events separated in time by xxxxxx secs (max 999999). If no value is given, 180 secs is used. The command is intended for finding events to be merged after putting together two different data sets with SPLIT. If a new time instead of the default 180 is entered, it will remain in effect for the whole

EEV session. NOTE, that the search starts with the current event, so after using S, one return to go to the next event must be given to start a new search.

STE: Set or unset the start location flag for epicenter

STD: Set or unset the start location flag for depth. The dept can also be entered.

SS: Find next unprocessed event in database. Events, which have status in ID line as follows: SPL: split with SPLIT program, HYP: auto-located with HYP, NEW: new event from EEV or ARG: registered by AUTOREG. The idea is that when new unprocessed data have entered the database by one of these programs, it should be easy for the operator to find the event. In EEV, an N near the end of the prompt line indicates an event with this status.

T: Type event.

TT: Type only header of event.

TTPLOT: The program reads P and S-arrival times from S-file and makes a travel time plots. The program is useful for checking readings, see section 30.3. The lines connect the computed first arrivals for P and S, respectively.

UPDATE: Updates (overwrite) S-file with hypocenter, magnitudes, residuals etc. Note that the CAT file IS NOT UPDATED . This can only be done with stand-alone command UPDATE, see section 14.

U: Update EEV event list. All S-file names are read in again. Is useful if data arrives during an EEV session, like when using Copy command from another data base.

UR: Reject outliers and update S-file with hypocenter etc. Outliers are removed. See Hypocenter section for more details.

USERCOM: Starts user defined program with command usercom -sfile \bgroup\color{black}$ <$\egroup sfile-name \bgroup\color{black}$ >$\egroup , where usercom is the command name. This command is useful for example if you want to start your program to create a report based on the S-file, from EEV. Note: the usercom is not a SEISAN program.

W: Check if event has waveform files. If so, check in which directory they are if present on the system. The search will start in current directory, then WAV followed by all directories defined with keyword WAVEFORM_BASE in SEISAN.DEF in DAT.

WAD: The program reads the data for the event and then asks if all phases are going to be used or only phases of the same type like Pg and Sg. Ideally, only phases of the same type should be used, however in practice it might be interesting so see all data, it might give an idea about phase identification. The Wadati parameters will now be calculated and shown on the screen. Optionally a plot can now be made. The plot shows the Wadati diagram. On the left is shown all stations with corresponding S-P times. Any station on the plot can be identified with the cursor. Point the cursor near a symbol and click and the station data will be shown in the upper right hand corner. This facility is used to identify bad picks. The plot output file is called wad_plot.eps.

Z: Automatic phase picking. A waveform file must be present. See also the AUTO program section 21.

Below is shown a session with EEV on PC.

Example of using EEV for November 1993

eev 199311

1993 11 Reading events for base AGA          18
#    1  2 Nov 1993 17:06 48 L   60.443    4.512  2.0  1.5 N 1.8CBER    6  ? 
#    2  5 Nov 1993 22:37 21 D                                          1  ? 
#    3  5 Nov 1993 22:37 23 D                                          1  ? 
#    4  5 Nov   93 22:39  2 L                                             ? 
#    5  5 Nov   93 22:40 58 L                                             ? 
#    6  7 Nov 1993 23:40 43 L   67.837   20.059 15.0  0.7  2.5CBER     7  ? 
#    7  7 Nov 1993 23:43 17 L   66.307    6.919 31.0  1.4  3.1CBER     8  ? 17
#   17 19 Nov 1993 01:45 29 D   70.069  139.780   .1  0.1              7  ? t
File name: \seismo\REA\AGA__\1993\11\19 0145-29D.S199302                                         
1993 1119 0145 29.0 D  70.069 139.780   .1  BER  7  .1                        1
                .19     999.9   821.9999.9   .3206E+06   .2536E+07   .2639E+08E
ACTION:UPD 97 03 25 21:28 OP:jh   STATUS:               ID:19931119014529     I
93111901.K41                                                                  6
  93 1119  153  6.5 D                                                         1
9311 19 0153 06S.NSN_09                                                       6
KBS  SZ EP        151 54.8                                     13.4 0 3365 161 
TRO  SZ EP        153 03.0                                       .010 4420 169 
MOL  SZ EP        153 50.51                                      .010 5070 165 
ASK  SZ EP        154 04.0                                       .010 5262 164 
BER  SZ EP        154 05.0                                       .110 5274 165 
EGD  SZ EP        154 05.5                                       .110 5285 165 
KONO BZ EP   9    153 49.21                                    25.5 0 5413 167 

#   17 19 Nov 1993 01:45 29 D   70.069  139.780   .1                     7  ? 
#   18 21 Nov 1993 01:53 56 L   60.184    4.965 15.0  N 0.5  2.6CBER    11  ? 
 1993 11 Reading events for base AGA          18
    1  2 Nov 1993 17:06 48 L   60.443    4.512  2.0     2.2  1.8CBER     6  ? q

In the above example (PC), the month has 18 events. For each event, vital information is displayed: Date, type, hypocenter, RMS, first magnitude and number of stations (number in S-file which might be larger than number used for location as given in S-file header line after a location). In this way the user can quickly search for events wanted and get important information without looking at all the details. The first event in the list is newly entered into the database as indicated with the N near the end of the line. In the above example, a return was made to go to next event until event #7 after which a jump was made to event 17. For this event, all parameter data was displayed with the 't' command. A return was made to event 18, another return and the event list was read in again and event #1 again became the current event. Note that not all events had a location.

Below are shown examples of the commands (C)opy, (D)ate, a(S)sociate and (A)ppend. Comment are preceded by '!' and written in bold. The database is EAF.

EEV 199405 EAF

1994  5 Reading events for base EAF         613   ! the month has 613 events
#    1  1 May 1994  1:18  8 D                                               ? 
#    2  1 May 1994 11:37  6 L                                               ? 
#    3  1 May 1994 12:00 33 D   36.607   68.449 15.0  2.4    ! go to day 20 ? d20
#  366 20 May 1994  5: 2  8 R                                               ? c
                                                ! copy an event to working dir.
 Copy event: Other database, give 1-5 letter name
             Working directory in file eev.out: return

#  366 20 May 1994  5: 2  8 R                                              ? 
#  367 20 May 1994 10:59 32 D      ! jump to 530                           ? 530
#  530 26 May 1994  8:55 11 D      ! look for time association             ? s
  549 27 May 1994  9:27 41 L                                        Associated
  548 27 May 1994  9:27  1 L       ! append to next event            ? aa
 Event #  549 appended to event #  548   Appended event still present
 Do you want to delete appended event(y/n=return)y   ! delete appended event

Backup copy saved as: \seismo\REA\DELET\1994\05\27 0927-41L.S199405 ! del. ev. save   
Deleted file          \seismo\REA\EAF__\1994\05\27 0927-41L.S199405 ! app.ev. del.
1994 05 Reading events for base EAF         612    ! event list updated
#  548 27 May 1994  9:27  1 L                     ! jump to 222            ? 222
#  222 12 May 1994 23:28 10 L                     ! change event type      ? r
 Change event type to L,R or D ?r

New file       \seismo\REA\EAF__\1994\05\12 2328-10R.S199405      
Deleted file:  \seismo\REA\EAF__\1994\05\12 2328-10L.S199405    
Reading events for base EAF         612
#  222 12 May 1994 23:28 10 R                                        ? 
#  223 13 May 1994  1: 1 37 L                                        ? 
#  224 13 May 1994  1:16 44 L                                        ? q

Stop   Program terminated.

When the interactive location is finished, the database should be updated, see section 7.

Using EEV on a subset of events or using alternative databases:

Since the EEV procedure or the HYP program will work on an index file, the user can create a subset of his own interesting events to work with by creating his own index file with just these events. The index file can be created by searching through the database using SELECT or it can be created manually with the C-command in EEV.

Local database:

If data is extracted by using the COLLECT or SELECT and then split up again using SPLIT, it is possible to keep all files in a working directory by not specifying database when splitting up. Another simple way is to use the Copy function in EEV and copy directly from a named data base to the local data base. Programs will then look for S-files in the current directory instead of in the database.

In addition to working with index files, there is also the possibility of storing data in different databases. By default, the data is always stored in BER. However, the user can also create another database structure (file structure) with another name and programs and procedures will work on that database too. There are some restrictions: The new database, which is a subdirectory under SEISMO/REA, just like BER, MUST have a 1-5 letter name. Currently, the alternative database is used in our Institute to store data from other agencies like NAO, which in some cases are copied to our own database (C-command under EEV). The name DELET is reserved for the DELET database, which is always present.

next up previous contents index
Next: 5.5 Instrument response Up: 5. Using SEISAN Previous: 5.3 Interactive work with   Contents   Index
Peter Voss : Mon Feb 27 10:16:12 UTC 2017