A seismicity viewer: SeisView - I. Introduction & Installation - Kazuki Koketsu Earthquake Research Institute University of Tokyo May , 26, 1992 (Ver.1.00) Aug., 11, 1992 (Ver.1.03)

burpfancyElectronics - Devices

Nov 8, 2013 (3 years and 7 months ago)


A seismicity viewer: SeisView


I. Introduction & Installation

Kazuki Koketsu

Earthquake Research Institute

University of Tokyo

May , 26, 1992 (Ver.1.00)

Aug., 11, 1992 (Ver.1.03)

Apr., 13, 1994 (Ver.2.01)

g., 22, 1994 (revised)

(0) Introduction

This software has been developed to support seismicity analyses by

hypocentral information of earthquakes from any institutesand researchers

as seismicity databases. You, users can retrieve the databases
with easy

user interface, and present or analyze retrieval results in several ways

(sorting them, plotting them on maps, making cross
section maps, space

distribution maps, time series charts, magnitude
frequency charts, etc.).

The prototype of this
software had been developed on a mainframe computer

by Miyatake et al. (1980) with the name of `SEIS', and it was converted

to personal computers (PCs) by Koketsu & Yoshii (1985). They kept former

user interface, but they replaced the database driver with

a faster one

for compensating relatively low performance of PCs. Since the converted

software called `micro SEIS' could run only on NEC 9800 series, it has

been rewritten to run on IBM PCs as well as workstations (WS) like Suns.

In addition, a clien
server facility has been built in so that

databases can be kept only on a server computer, and client computers can

ask the server to retrieve the databases and send the results through a


After the above revisions, we changed the nam
e of this software to

`Seismicity Viewer (SeisView)' and make it available by anonymous ftp


tokyo.ac.jp (

If you would like to get its copy, please ftp to ftp.eri.u

with the username `ftp' or `anonymous' and use
your proper e
mail address

as a password. Your ftp access will be rejected unless your password is

proper. Please read carefully any notes printed on your scceeding in ftp

access, since the current status of SeisView may be written in these

You w
ill then find the directory named `/pub/seisv', which has the



bin/BSD386,IBMPC,NECPC,NEWS,SUN} (executables)


seisv |color SeisView for a client/standing
alone WS

seisvm |monochrome SeisView for a client/standing
alone WS

seisv.exe |color SeisView for a standing
alone PC

seisvc.exe |color SeisView for a clie
alone PC

seisvd |SeisView daemon for a server Sun


data (seismicity data: common for PCs and WSs)


*.b? |USGS Preliminary Determination of Epicenters (1979

*.b? |Japan Meteorological Agency (1926

*.b?|Japan University Network Earthquake Catalog (July,1985

*.b? |Catalog of Drs. Matsuura,
Karakama & Tsumura

utsu.b? |Catalog of Dr. Utsu

rika.b |Rika Nenpyo (Scientific Tables published by Maruzen co.)


etc (maps, menus, etc.: common for PCs and WSs)


*.pan |menu panels

earth.m |coarse shorelines on the earth (with trench axes)

japan.f? |active faults in Japan by Katsudanso Kenkyukai

japan.m? |fine shor
elines in Japan by Ms. Kotake (with prefectural


japan.nam,mes |region names and mesh configuration in Japan

|by Dr. Miyatake

jma.s |stations of Japan Meteorological Agency

nwpac.m |shorelines

in the NW Pacific by Dr. Yoshii & Kinoshita

|and ISC (with trench axes)

regions |sample definitions of regions used in SELECT, MAP menus

tmsrb.fon |Microsoft C graphic fonts for PCs

world.m? |world map by ISC

,mes |seismic region names and mesh configuration by Flinn

|et al.


src (source codes)


file.SUN |make script for Suns

Makefile.NEWS |make script for NEWS

Makefile.BSDI |make script for BSD/386

ibm.mak |make script for a standing
alone IBM PC

ibmc.mak |make script for a client/standing
alone IBM PC

nec.mak |make
script for a standing
alone 98

necc.mak |make script for a client/standing
alone 98

seisvd.c |C source of the server daemon

*.c |C sources of client/standing
alone SeisView

|(except for seisvd.c)

*.h |C

header files of client/standing
alone SeisView


doc (documents)


install.doc |Introduction & Installation

(this document)

installj.doc |Introduction & Installation (Japanese, EUC codes)

installj.jis |Introduction & Installation (Japanese, JIS codes)

installj.sjis |Introduction & Installation (Japanese, shift JIS codes)


(1) Installation of programs

For Sun, NEWS, BSD/386, IBM PC or 98 we provided executables so that

you have only to ftp an appropriate one in a corresponding subdirectory

under the `bin' to one of PATH directorie
s of your computer in the

`binary' mode. For a WS, please then execute

chmod +x seisv

or so to set an flag indicating the obtained file to be executable.

Similary to `seisv' of WSs `seisvc.exe' has the standing
alone facility

as well as the client faci
lity. So, you need not install `seisv.exe'

in addition to it. However, since `seisv.exe' consumes less memories,

`seisv.exe' can retrieve more earthquakes than `seisvc.exe' in stnading

alone use.

`seisvc.exe' can work as a client only if you use the Al
lied Telesis

Ethernet board with the PC/TCP driver. This is not true for other

manufacturers' boards or the Allied Telesis one with the SLIM TCP

drivers (because their libraries are not compatible to the WS one).

(2) Loading of etc files

Whether your c
omputer is a client or standing alone, All the files in

the directory `etc' are essentially required except that `tmsrb.fon'

is not necessary for WSs. Please ftp them to your suitable directory

(for example, we assume `/seis/etc') in the `binary' mode. I
n this

case it is easier to use `mget' after issuing `prompt off'.

Meanwhile, menu panels for unused functions are actually unnecessary,

and `japan.f?' are also unnecessary unless you will show Japanese active

faults. Even `world.m?' (world map) are not
necessary if you are trapped

around Japan. However, the MAP function adopts `world.m?' as the default

of `Map Dataset' so that you have to change the Map Dataset from `world'

to `nwpac' (North
Western Pacific) or `japan'.

(3) Loading of seismicity datas

If you use SeisView standing alone, please ftp necessary datasets

in the directory `data' to your suitable directory (for example we

assume /seis/data) in the `binary' mode. Annualy separated datasets

(pde, jma, junec) are saved in individual subdire
ctories at

tokyo.ac.jp, but they should be in the same directory

(/seis/data) when in standing
alone use.

The Japan Meteorological Agency datasets have been applied restriction.

They are available only if you get access from a computer with an

address ended by `ac.jp' with the username `guest'. This restriction is

so tentative that it may be changed without advance notice.

Please contact koketsu@eri.u
tokyo.ac.jp about access from outside

`ac.jp' or the International Seismological Cen
tre datasets.

(4) How to start

SeisView can essentially work just by your typing parameters as menus

instruct (arrow keys are available for this typing) and your pressing

the Enter (Return) key. Thus, we will indicate only some points to

which you part
icularly pay attention. Please consult the volume

II. How to Use for details.

SeisView starts by entering the filename of an executable (seisv, seisvc,

etc.) as a DOS or UNIX command. You must start up OpenWindows or X

in advance for a WS.

iew first assumes that etc files exist in the current directory,

but if you set the name of some directory to the environmental variable

SEIS, SeisView will refer to this directory. So, if you want to use

SeisView at any working directory, please add a li
ne like

set SEIS=
etc (for the above example)

to `autoexec.bat' of a PC, or a line like

setenv SEIS /seis/etc (for the above example)

to .cshrc of a WS.

In order to keep parameters of the SELECT function or so for next use,

SeisView writes them i
n the file `_seis' though micro SEIS used

Since SeisView refers to the environmental variable HOME for this file,

it is always saved in your home directory of a WS. However, it is saved

on your current directory for a PC unless you explicitly

define the HOME

variable. Anyway, The name of `Map Dataset', parameters for plotting

symbols in the MAP function, etc. are newly to be saved in addition to

the parameters saved by micro SEIS.


Request : OPTION

Specify options in () as you like and press Enter.

Pathname of the directory for SEIS data files

( )

data (DOS),@hostn
ame (server)

If you keep this blank, the value of the SEIS environment

will be taken. If both this and the variable are blank, a

working directory will be assumed.

Printer Type

( ) PS

cript printer.


NEC PR printer.


IBM Proprinter or EPSON LQ printer.>

Printer Name

( ) LPT1, LPT2, ...... on DOS.

A printcap entry on UNIX.



Fig.1 Menu panel of the OPTION function

The OPTION function is a new feature in SeisView rather than in micro

SEIS. When you enter SeisView at the first time and press any key on

the initial panel, or when you type `option' or `a' (capital letters also

allowed) and press the Enter key at the command prompt wether you are a

comer or not, the menu shown in Fig.1 appear. The first field specifies

the directory where data files a
re kept. It is `/seis/data' for the

example, and you may add a PC disk drive letter as shown in the menu.

If you give `@' at the top, following letters are understood as the host

name of a SeisView server. The SeisView server is currenly running


tokyo.ac.jp, and so a machine connected to the Internet

can be used as a client by giving `@karasu' at this field if you have

the entry of `karasu' in your /etc/hosts.

You can specify the type and name of printer at the second
and third

fields, respectively. Since SeisView newly supports a PostScript printer

in addition to an NEC PR printer for micro SEIS, you can give `PS' or

as the printer type. An NEC PR printer is available even on a WS if it

is connected. IBM Propr
inters (EPSON LQ printers) and an HP LaserJets

be supported as soon as we will know their specifications. For the

name on a PC, you should specify the parallel port to where a printer is

connected as LPT1, LPT2, or so. However, 98 has only o
ne parallel port,

this specification is always ignored. Please give an entry name of

`/etc/printcap' to the printer name field on a WS.

If you set PS, the file named `seis.prn' in the current directory will be

used as a working file. So, you can include

this file in a LaTeX

revise it by SunDraw, or so after making a hard copy of the graphic

and quiting SeisView.

(5) Installation of a server

Since the SeisView server is running on `karasu' as described above,

machines connected to Inte
rnet can utilize the client facilities without

installing a new server. However, repeated retrievals should affect the

Internet backbones, though one retrieval costs around 100KB. So, please

run your own server if you want to use a machine outside the Un

of Tokyo as a client. You need only to ftp `bin/seisvd' and execute it

if you use a Sun and locate seismicity data in `/usr/ftp/SEIS/data' as

we do on `karasu'. OpenWindows is not necessary.

In case of locating in a different directory, we need

poperly rewrite

the line

#define HOME "/usr/ftp/SEIS/data/"

in `seisvd.c' and compile it. The directory you locate the data must

have the same configuration as `/pub/seisv/data'. In other words,

separated datasets must be saved in an indivi
dual directory.

The SeisView server forces to take logs so that the logs will become

and bigger. For avoiding this we recommend to appropriately modify the

script `bin/trimlog' and execute it by `cron' once a day.

The SeisView server forks a new
process in response to each retrieval

request in order to handle several retrieval requests at the same time.

Therefore it cannot run in the DOS environment on a PC.

(6) Coversion for other machines

Although SeisView should not be necessary to be conver
ted for other PCs

than IBM PC and 98, it is quite likely to be requested the conversion

for other WSs than Sun, NEWS and BSD/386. Since SeisView never use

special libraries except for `Xlib' of X Window, it can be converted

with few modifications for a WS

associated with BSD UNIX and X Window.

On the hand, we do not have a plan to support other printers than

printers, NEC PR printers, IBM Proprinters (in preparation), and HP

(in preparation). For an unsupported printer (for example, N
533 of

please install `Ghostscript' of the Free Software Foundation (GNU) with

printer driver and do `make' after properly rewrite the part of

in `device.c'. `Ghostscript' is available in `/pub/src/misc' of


(7) Problems

Strange things may happen on retrieving earthquakes on a map across

the day line.

(8) Cautions

Data etc., of which author institutes or persons are written above, are

righted by these institutes or persons. The other programs an
d data,

are copyrighted by Kazuki Koketsu and Toshikatsu Yoshii (Earthquake

Institute, University of Tokyo). You can freely distribute copies of the

latter to any person without modification. For the former, please follow

instructions writt
en in the files `README' in the directories where the

former are saved.

If you publish documents including results obtained by using this

please note `SeisView by Kazuki Koketsu and Toshikatsu Yoshii (Earthquake

Research Institute, University of

Tokyo) was used.' Please follow again

the instructions in the `READMEs' for the data etc. copyrighted by other


This software was made to be perfect, the authors never guarantee its

perfection. The authors never be responsible for any trouble,

etc. caused by this software.

If you find problems or points to be improved in this software, please

inform K. Koketsu by e
mail (koketsu@eri.u