7.2 The Hypoinverse program, HYPINV

The latest version of Hypoinverse-2000 program (version 1.40, 2014) has been implemented in SEISAN to be use within EEV and as standalone. The original program has not been changed except to increase number of stations (25k). The original manual is found in INF. The main program has been given the name HYPINV (original version was HYP in conflict with HYP for HYPOCENTER) and can be run according to the original manual (Klein, 2014) and will not be described here. With a new driver program HYPINV_SEISAN, Hypoinverse can be run using Nordic files as input and output. Only the archive format for input and output is used directly with Hypoinverse.

The program does not work well at large distances ( \bgroup\color{black}$> 1000km$\egroup) so use it only for local earthquakes.

If original data, station and control files are available, it is just typing HYPINV and the program will run according to the manual. If none of these files are available, they can be made with the conversion programs, see below.

HYPINV can be operated in 3 ways:

Alternative 1: Manually do all steps:

1: Convert a CAT file a Hypoinverse input file with the program NORHIN, e.g. norhin collect.out. The input file in Nordic format is converted to a file norhin.out in Hypoinverse format. The following limitations and additions apply:

2. Make the control files with the program MAKEHIN. This creates the instruction file hypinst, station file hypinv.sta and model file hypinv.mod. These files are standard HYPOINVERSE files. The information is taken from the STATION0.HYP file in either the working directory or DAT. MAKEHIN cannot work with an alternative STATIONx.HYP file. If the hypinv.sta or hypinst files are present, they will not be generated. This allows for changes in the Hypocenter parameters to be used in subsequent runs. On the other hand, if the STATION0.HYP file is changed, the hypinst and hypinv.sta files must be deleted before the changes in STATION0.HYP will be used. The following parameters are partly generated from STATION0.HYP:

3. Type HYPINV and the program runs. There is a one-line output per event on the screen and the full output is in a file called print.out.

The output file from HYPINV is now hypinv.out and it can be converted back to Nordic format with program HINNOR, however, some of the original information is lost (like e.g. amplitudes). To avoid this, see alternative 2. HINNOR transfers the following information:

Alternative 2: Run the whole process using the driver program HYPINV_SEISAN. The program does the following:

Using alternative 2 makes it very easy since Nordic file is both input and output.

Alternative 3: Running HYPINV from EEV using the command H. The steps are:

It is thus possible to use HYPINV to update the data base of local events with the limitations mentioned under alternative 1.

Note: Hypoinverse use residual weighing by default so rms and errors might be smaller than locating with Hypocenter.


No magnitudes are transferred from Nordic files to Hypoinverse files. Coda magnitude is calculated with Hypoinverse using the Hypoinverse default relations. If the magnitudes have to be updated due to significantly changed location, it must be done with SEISAN EEV command 'u' and with the hypocenter fixed so the original HYPINV location is preserved.

How to run Hypoinverse with other parameters

Hypoinverse has many options of which the multiple models might be the most interesting. Generate the standard input files as in alternative 1 and then modify them according to the Hypoinverse manual. Then run HYPINV directly or, as the hypinst file is not changed if it exists, using alternative 2 or 3.

sectionHYP_ISC (Unix and Linux only)

Program written by Richard Luckett

ISC has for many years used a standard procedure to locate earthquakes and the ISC locations have often been used as a reference. The earth model used is the Bullen tables. ISC has recently rewritten the old location program and it was therefore possible to also port it to SEISAN. The purpose is that it should be possible to compare standard ISC locations with location using other programs and models. The implementation in SEISAN was done using the standard hyp program where only the location routines have been changed. The program then behaves almost identical to HYP and uses the same format input and output files.

Parameter files: STASTION0.HYP is used for station coordinates, magnitude scales and agency code. The crustal model information is not used and only the RESET TEST parameters related to magnitude are used. In addition, there is a new parameter file (in DAT) iscloc.def with parameters specific for the ISC location routines, see file for explanation of parameters.

Input data files: Just like for HYP

Output files: Hyp.out is like before, print.out is different.

Not all crustal phases used with HYP may be available. The weights used in SEISAN do not apply since the program uses residual weighing only, see parameter file.

Magnitudes are calculated exactly like in SEISAN.

In eev, the command to locate with HYP_ISC is `il'.

For more information about the ISC location program, see http://www.isc.ac.uk/Documents/Location/