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.

  1. 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)
  2. 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/
  3. 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.
  4. Download the SeisGram2K class archive file http://maipo.unice.fr/sismo/Moniteur/SeisGram2K30.jar to your directory liveseis/java/
  5. 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.