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

Type gmap on the command line to start gmap.
Type gmap -help to see the options.
Type gmap -stat to convert a SEISAN station files to kml.
Type gmap -poly to convert a SEISAN polygon files to kml.
Type gmap -place_names to convert a place_names.eev file to kml.

In gmap you can:

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

Example:

Use select to grap data from your Seisan database.

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

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