SeisGram2K
LiveSeis - installation instructions
To install the LiveSeis near-real time data monitor first
see LiveSeis
- how it works for more details of the data flow, and then follow
the
installation steps below.
-
Prepare the LiveSeis directory structure in your public http
space.
Use a structure of the following form:
liveseis/
(base directory containing *.html
,
seis_view_n_03.js
)
liveseis/data
(data directories, which will be further
subdivided
for each data channel as is convenient for you, i.e. liveseis/data/nework/station/channel/format/
)
liveseis/java/
(directory containing SiesGram2K class
archive file: SeisGram2KXX.jar
)
- Create the circular disk-file buffer "segment preparation
script".
(The buffer consists of a fixed number of data segment files and a
pointer
file
liveseis.last
, all of which reside in a public
http:// directory
that is accessed through a standard web server. The data segment
files include an index number in their filenames; they contain data
segments
written in order of this index number, looping back to 0 after the
highest
number. The pointer file "liveseis.last" contains the index
number
of the last written segment file.) You must create the automatic
scripts and other tools necessary to 1) prepare your data at
regular
time intervals into contiguous, possibly overlapping data segments
in a format supported by SeisGram2K, 2) write the data segments to
files
in a public http:// data directory that is BELOW the base directory
that
will contain the LiveSeis HTML page that will launch liveseis, and 3)
update the file liveseis.last
in each data directory
so that the
first line starts with an integer number that corresponds to the last
written
data segment index number (the rest of the file is ignored). The
data files must follow the LiveSeis naming convention (template with
index
number) and may be compressed in GZIP format (must then end in .gz
).
For an example of a circular disk buffer, see the set of files in http://maipo.unice.fr/sismo/Moniteur/liveseis_data/CALF/HH/sac/
- Create the LiveSeis HTML page that describes your network
and the
available near-real time data and with links which allow the user to
select
stations / components / time window lengths for viewing. When the
user clicks on a viewing link, the JavaScript
seis_view_n_03.js
is
called to set up and lauch SeisGram2K in a new browser window.
Download
and examine the files http://maipo.unice.fr/sismo/Moniteur/moniteur_tgrs.html
,
http://maipo.unice.fr/sismo/Moniteur/moniteur_tgrs_main_frame.html
and http://maipo.unice.fr/sismo/Moniteur/seis_view_n_04.js
for more information.
It is easiest to copy and modify the file http://maipo.unice.fr/sismo/Moniteur/moniteur_tgrs.html
and its frames to make your LiveSeis HTML page. Probably you will
not need to modify
the file seis_view_n_04.js
, see the comments inside this
file for more information.
- Download the SeisGram2K class archive file
http://maipo.unice.fr/sismo/Moniteur/SeisGram2K30.jar
to your
directory liveseis/java/
- With all this in place, the LiveSeis display should launch when
you click
on one of the viewing links on your LiveSeis HTML page...
Questions? Comments? Suggestions? Please
e-mail to Anthony Lomax.