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 9 months ago)

104 views




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)







Au
g., 22, 1994 (revised)


(0) Introduction


This software has been developed to support seismicity analyses by
handling

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
-
time

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
now

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


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

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

network.


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

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

from



ftp.eri.u
-
tokyo.ac.jp (130.69.195.16)


If you would like to get its copy, please ftp to ftp.eri.u
-
tokyo.ac.jp

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
notes.


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

configuration.


-------------------------------------------------------------------------

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
nt/standing
-
alone PC

seisvd |SeisView daemon for a server Sun

-------------------------------------------------------------------------

data (seismicity data: common for PCs and WSs)

----------------------------------------------------------------
---------

pde/pde
-
*.b? |USGS Preliminary Determination of Epicenters (1979
--
)

jma/jma
-
*.b? |Japan Meteorological Agency (1926
--
)

junec/junec
-
*.b?|Japan University Network Earthquake Catalog (July,1985
-
-
)

mkt/mkt
-
*.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


|boundaries)

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

world.nam
,mes |seismic region names and mesh configuration by Flinn


|et al.

-------------------------------------------------------------------------

src (source codes)

-------------------------------------------------------------------------

Make
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
ets


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

ftp.eri.u
-
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
Internet

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
Window

in advance for a WS.


SeisV
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=
\
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
`setup.dat'.

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


( )


Examples:/home/koketsu/seis,c:
\
seis
\
data (DOS),@hostn
ame (server)


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


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


working directory will be assumed.



Printer Type


( ) PS
-

PostS
cript printer.


NEC
-

NEC PR printer.


<IBM
-

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
new

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
above

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

on

karasu.eri.u
-
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 130.69.195.13' 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
`NEC'

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
will

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

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
document,

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

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
iversity

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,
annualy

separated datasets must be saved in an indivi
dual directory.


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

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
PostScript

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

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

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

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

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

ftp.eri.u
-
tokyo.ac.jp
.



(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
copy
-

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

are copyrighted by Kazuki Koketsu and Toshikatsu Yoshii (Earthquake
Research

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
software,

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

authors.


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

perfection. The authors never be responsible for any trouble,
accident,

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
-
tokyo.ac.jp).