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
-
-p pf
Parameter file name.
-
-r range
This option specifies the mapwidth in degrees and overrides the value from the parameterfile.
-
-l/-L field
This option selects the field for the labels. This overrides the fieldname from the parameter file list tables.
The option -L select the fieldnames for the overlay.
-
-f filename
optional name of postscript file. Default name is /tmp/dbmap_gui.ps
-
-o db.table
This option also displays data from the database table db2.table.
This table must contain at least the fields lat and lon. Other fields for the label and eventually radius (of the circle drawn around each lat,lon pair) can be specified in the parameterfile.
-
-O table
this option selects on of the tables in the input view to be shown as overlay.
-
db
Database name. This is the only required argument. Additionally, a tablename can be specified, otherwise information from the table site is displayed.
Possible tables are (currently) those with fields lat and lon: site, origin, place, idp
-
recno
record number. This allows to specify a single record from the basetable. This is mainly intended to support the execution from dbloc2. See the examples below.
PROGRAM INTERACTION
The currently implemented commands are:
-
O/o
Zoom out.
-
I/i
Zoom in.
-
L/l
Toggle display of labels.
-
C/c
Toggle filling and display of circles.
-
p/P
Create postscript output of window or plot immediately. If not specified on the commandline, the name of the postscript file defaults to /tmp/dbmap_gui.pf.
-
q
Quit
-
Click-Drag
Pan the window following the mouse.
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
/B>
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 -
/B>
-
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