10.5.2 The advanced GMAP

This mode of GMAP is a command line version, that convert SEISAN s-files to input files for Google Earth. It also convert SEISAN STATIONx.HYP files, polygone files and place_names.eev (see GEO command in EEV).

In gmap you can:

  1. Set the colour of the icons.
  2. Show the error ellipse.
  3. Show events as a animation over time.
  4. Set the scale of the icons (default: scale=0.2*mag**0.5).
  5. Set the type of icon used for earthquakes, explosions, probable explosions and for other events.
  6. Include or exclude the S-file.
  7. Rename the output file.
  8. Append text in KML format to the output file (See SEISAN.DEF parameters below).

Example:

  1. Use select to grap data from your Seisan database.
  2. Run the GMAP program:
    unix:/home/seismo/WOR: gmap 
     INPUT FILE NAME 
    select.out 
    Title: 
    West Greenland [2000;2008]
    
    Number of Earthquakes : 945 Explosions : 0 Probable Explosions : 2 Other events : 2 
    Output file is
    gmap.kml
    

  3. In Google Earth open the output file gmap.kml. See Fig. 10.5.

Figure 10.5: Example of mapping with gmap. Events in West Greenland. Note the folder and the subfolders in the Places window.
\begin{figure}
\centerline{\includegraphics[width=0.9\linewidth]{fig/fig32}}
\end{figure}

To make an animation for events over time use the -timespan flag. As an example explosions in the south of Norway from 1983 to 2007 can be downloaded here: http://seis.geus.net/ber-exp.kml Press the play button at the time slider at the top of the Google Earth. Use the ruler to control how the animation is displayed (speed, days shown, etc.).

Figure 10.6: If the Earthquakes and data folder is selected in the Places window S-files can be shown.
\begin{figure}
\centerline{\includegraphics[width=0.9\linewidth]{fig/fig33}}
\end{figure}

Figure 10.7: A map can be saved as raster file (File-Save-Save Image).
\begin{figure}
\centerline{\includegraphics[width=0.9\linewidth]{fig/fig34}}
\end{figure}

GMAP parameters added to SEISAN.DEF: Icon used for earthquake, explosion, probable explosion and other events:


GMAP_ICON_QUAKE                         http://maps.google.com/mapfiles/kml/pal2/icon26.png
GMAP_ICON_EXPLOSION                     http://maps.google.com/mapfiles/kml/shapes/star.png
GMAP_ICON_PROB_EXPL                     http://maps.google.com/mapfiles/kml/shapes/open-diamond.png
GMAP_ICON_OTHER_EVENTS                  http://maps.google.com/mapfiles/kml/shapes/square.png

Events with magnitude smaller than GMAP_ICON_MSIZE will be plottet with size of GMAP_ICON_MSIZE:


GMAP_ICON_MSIZE                         0.5

The scale of the earthquake icons is give by GMAP_ICON_XSIZE*magnitude**GMAP_ICON_YSIZE:


GMAP_ICON_XSIZE                         0.2
GMAP_ICON_YSIZE                         0.5

The scale of other events is furthermore multiplied by 2 Text can be added to the KML file, see this example, note the text must be placed from character no 41 to no 120:


#GMAP_APPEND_KML                         <!-- lines to be appended to the gmap.kml file : -->
GMAP_APPEND_KML                         <ScreenOverlay id="LOGO">
GMAP_APPEND_KML                         <name>Info and links</name>
GMAP_APPEND_KML                         <description> <![CDATA[
GMAP_APPEND_KML                         Data is in Nordic format. The format is <br>
GMAP_APPEND_KML                         described in the Seisan manual at UIB.<br>
GMAP_APPEND_KML                         UIB:  http://www.geo.uib.no/seismo/<br> ]]>
GMAP_APPEND_KML                         </description>
GMAP_APPEND_KML                         <Icon>
GMAP_APPEND_KML                          <href>http://seis.geus.net/geus.png</href>
GMAP_APPEND_KML                         </Icon>
GMAP_APPEND_KML                         <overlayXY x="0" y="1" xunits="fraction" yunits="fraction"/>
GMAP_APPEND_KML                         <screenXY x="-0.01" y="0.99" xunits="fraction" yunits="fraction"/>
GMAP_APPEND_KML                         <rotationXY x="0" y="0" xunits="fraction" yunits="fraction"/>
GMAP_APPEND_KML                         <size x="0.1" y="0.1" xunits="fraction" yunits="fraction"/>
GMAP_APPEND_KML                         </ScreenOverlay>

GMAP -help:


unix:/home/seismo/WOR$ gmap -help

  The GMAP program converts Nordic format to the KML format.
  The output file gmap.kml can be opened with Google Earth.
  The program prompts for a input file in nordic format, the
  input file can be compact.
  The program also convert SEISAN station and polygon files.
  
  Usage: gmap [options]
         input file    
         Title used for kml folder
  
  ## Options ##
    -help         Print this list
    -h            Same as -help
    -color        Define color of epicenters [blue/green/yellow/
                  black/white]. Default color is red          
                  To uses other colors see describtion below  
    -timespan     Events gets timetag scroll in time domain   
    -nodata       kml file will only contain header infomation
    -errorellipse kml file will include error ellipse        
    -ellipsecolor Define color of ellipse in 8 digit hex code
    -ellipsewidth Define width of the ellipse line, in pixels
    -stat         Station locations given in STATION?.HYP files
                  is converted to KML, output is gmapstat.kml  
                  To change color/scale/icon edit gmapstat.kml 
                  and change the content of Style Id=stat      
    -poly         SEISAN polygon files like DAT/SALVADOR.MAP   
                  is converted to KML, output is gmappoly.kml    
                  To change color/width edit gmappoly.kml and    
                  change the content of Style Id=poly            
    -out_file     Define name of output file (default is gmap.kml)
    -verbose      Be more verbose
    -version      Seisan version 
  
  Scale:
  The scale of the icons is set by the SEISAN.DEF 
  parameters GMAP_ICON_MSIZE, GMAP_ICON_XSIZE and 
  GMAP_ICON_YSIZE, see the manual for details.
  
  Color:
  Color and opacity (alpha) values are expressed in 
  hexadecimal notation. The range of values for any 
  one color is 0 to 255 (00 to ff). For alpha, 00 is
  fully transparent and ff is fully opaque. The order
  of expression is aabbggrr, where aa=alpha (00 to ff);
  bb=blue (00 to ff); gg=green (00 to ff); 
  rr=red (00 to ff).For example, if you want to apply
  a blue color with 50 percent opacity to an overlay,
  you would specify the following: 
  <color>7fff0000</color>, where alpha=0x7f, blue=0xff,
  green=0x00, and red=0x00. See also:
  http://code.google.com/apis/kml/
  documentation/kml_tags_21.html#color 
  
  Examples:
            gmap -color blue -nodata -errorellise
            gmap -timespan -color 7eee00ee
            echo "collect.out\nDK events\n" | gmap -out_file dk.kml