• Antelope Release 5.5 Linux 2.6.32-220.el6.x86_64 2015-04-21

 

NAME

dbmap_gui - display geographical information on a map-gui

SYNOPSIS

dbmap_gui [-p pf] [-r range] [-f filename]
                [-o db.table|-O table] [-l/L field]
				db[.table] [record]

SUPPORT


Contributed code: NO BRTT support.
THIS PIECE OF SOFTWARE WAS CONTRIBUTED BY THE ANTELOPE USER COMMUNITY. BRTT DISCLAIMS ALL OWNERSHIP, LIABILITY, AND SUPPORT FOR THIS PIECE OF SOFTWARE.

FOR HELP WITH THIS PIECE OF SOFTWARE, PLEASE CONTACT THE CONTRIBUTING AUTHOR.

DESCRIPTION

The script dbmap_gui displays geographical information stored in database tables on a map-gui. Data from a second database can be displayed for comparison. The syntax was choosen so that it can be invoked from the commandline, from dbe and from dbloc2.

OPTIONS

PROGRAM INTERACTION

The currently implemented commands are:

PARAMETER FILE

the
parameterfile for dbmap_gui contains the array tables to select fieldnames displayed as labels. The mandatory entry label defines the text displayed for each entry. The optional entry circle defines a field which is expected to hold a radius in km. Different colors can be selected for the dot marking the exact position, the label and the circles. Circles are only drawn for tables where the entry circle is specified below.

EXAMPLE

This program can be run from the commandline, from dbe and from dbloc2.
  • commandline
    
    Display site-table from a database
    dbmag_gui /opt/antelope/data/db/demo/demo
    
    Same, but display only 1st record
    dbmap_gui /opt/antelope/data/db/demo/demo 0
    
    display origins
    dbmap_gui mydb.origin
    
    display some origins
    dbsubset mydb.origin "time >'2/2/2003/'"| dbmap_gui -
    
    same, but display also some places
    dbsubset mydb.origin "time >'2/2/2003/'"| \
       dbmap_gui -o /path/to/known_places.place -
    
    display origins and associated stations
    dbjoin $DEMODB.origin assoc arrival site | \
       dbmap_gui -r 10 -O site -
    
    
    
  • dbe
    
    
    graphics &Arr{
            origin &Tbl{
                    Map dbmap_gui -
                    Quarry? dbmap_gui -o /path/to/quarries.tablename -
                    Where? dbmap_gui -o /path/to/places.tablename -
            }
            site &Tbl{
                    Map dbmap_gui -
                    Where? dbmap_gui -o /path/to/places.tablename -
            }
    }
    
    
  • dbloc2
    
    
    origin_menu_items &Tbl{
            Map    dbmap_gui
                    Where? dbmap_gui -o /path/to/places.tablename
                    Blast?  dbmap_gui -o /path/to/quarries.tablename
    }
    station_menu_items &Tbl{
            Map    dbmap_gui
                    Where? dbmap_gui -o /path/to/places.tablename
    }
    
    

BUGS AND CAVEATS

Circle overlays on Solaris may cause problems.

SEE ALSO

dbe(1), dbloc2(1), dbloc_map(1), ptkform(3p), bplot(3p).

AUTHOR

Nikolaus Horn, using the example from the bplot manpage.
ZAMG / Vienna, nikolaus.horn@zamg.ac.at
Antelope User Group Contributed Software