geoDataClient V1.05

Martin D. Adamiker
Tanbruckgasse 23/50
A-1120 Vienna, AUSTRIA
Phone & Fax: +43-1-8109633
mailto:martin@truflite.com?subject=geoDataClient

This document explains the use of geoDataClient in connection with TruFlite for Windows.

- geoDataClient...a gazetteer application for Windows. Enter coordinates or a U.S. address and the
                  matching data are downloaded from USGS and U.S. Bureau of the Census servers.
- TruFlite........TruFlite for Windows, 3D terrain visualization program.

Start geoDataClient

In the address field, enter (without quotes): "100 Eugene Ave, Mt. Shasta, CA"
Request the coordinates for that address: Pushbutton "Geocode..."
Make sure that output is produced (in the log box in the center of the dialog) reading:
"quad: -122.807675, -121.807675, 41.808410, 40.808410"
Request the data files for those coordinates: Pushbutton "Proceed..."
The download may take a couple of minutes. Watch the various steps and make
sure the output ends with this statement: "Download successfully finished."

Four files were created (with NNNNNNNN being an arbitrary 8 digit number):
NNNNNNNN_el.tga
NNNNNNNN_tx_c.tga
NNNNNNNN_1.trf
NNNNNNNN_2.trf

Close the program: Pushbutton "Close"

Start TruFlite, open one of the *.trf files, say NNNNNNNN_1.trf
(with NNNNNNNN being an arbitrary 8 digit number).

Select "Calculate/Final..." or simply press Ctrl+F.

A series of 100 output files is created: "NNNNNNNN_output_1_nnnn.tga",
where nnnn is a four digit serial number of the still image.

To limit the number of images rendered to one, in the "Frame Number"
groupbox, replace "To: 99" by "To: 0" and then press Ctrl+F again.

To zoom in, double the focal lengths of the "First Frame" and the
"Last Frame" (1200 -> 2400) and then press Ctrl+F again.

To turn the camera horizontally, change the "Heading" value.
To pitch (nod) the camera, change the "Pitch" value and then press
Ctrl+F again.

To flatten the terrain, reduce the "Elev. z scale" value and then press
Ctrl+F again.
-----------------------

If you have any comments, please feel free to contact:


Martin D. Adamiker
Tanbruckgasse 23/50
A-1120 Vienna, AUSTRIA
Phone & Fax: +43-1-8109633
mailto:martin@truflite.com?subject=geoDataClient

-----------------------

Appendix:

The log file that geoDataClient is expected to produce (path names and timestamps may vary):

------------ BEGIN OF geoDataClient LOG FILE ------------
geoDataClientDialog log file created Monday, January 28, 2008 14:15:40 UTC
Opening Internet...
Status Code is 200
Download of "http://geocoder.us/demo.cgi?address=100 Eugene Ave, Mt. Shasta, CA" finished.
  quad: -122.807675, -121.807675, 41.808410, 40.808410
Opening Internet...
Status Code is 200
Adding your request to the queue...
Please wait for the data to be returned.
Redirected to http://extract.cr.usgs.gov/diststatus/servlet/gov.usgs.edc.RequestStatus?zid=20080128.081302537.212041245002
Waiting 10 seconds
Opening Internet...
Status Code is 200
Extracting data...
Please wait for the data to be returned.
Redirected to http://extract.cr.usgs.gov/diststatus/servlet/gov.usgs.edc.RequestStatus?zid=20080128.081302537.212041245002
Waiting 10 seconds
Opening Internet...
Status Code is 200
Extracting data...
Please wait for the data to be returned.
Redirected to http://extract.cr.usgs.gov/diststatus/servlet/gov.usgs.edc.RequestStatus?zid=20080128.081302537.212041245002
Waiting 10 seconds
Opening Internet...
Status Code is 200
Extracting data...
Please wait for the data to be returned.
Redirected to http://extract.cr.usgs.gov/diststatus/servlet/gov.usgs.edc.RequestStatus?zid=20080128.081302537.212041245002
Waiting 10 seconds
Opening Internet...
Status Code is 200
Extracting data...
Please wait for the data to be returned.
Redirected to http://extract.cr.usgs.gov/diststatus/servlet/gov.usgs.edc.RequestStatus?zid=20080128.081302537.212041245002
Waiting 10 seconds
Opening Internet...
Status Code is 200
Raster Extract has completed.
Redirected to http://extract.cr.usgs.gov/diststatus/servlet/gov.usgs.edc.RequestStatus?zid=20080128.081302537.212041245002
Waiting 1 second
Opening Internet...
Status Code is 302
Redirected to http://152.61.128.18:80/Extractor_Output/93953090.zip
Waiting 0 seconds
Opening Internet...
Status Code is 200
Writing file "D:\workspace\geoDataClient\Release\93953090.zip"...
Writing file "D:\workspace\geoDataClient\Release\93953090.zip" finished.
Converting "D:\workspace\geoDataClient\Release\93953090\93953090.bil" to "D:\workspace\geoDataClient\Release\93953090_el.tga".
BIL import successful: "D:\workspace\geoDataClient\Release\93953090_el.tga" written.
Executing HTTP request: "http://tiger.census.gov/cgi-bin/mapper/map.gif?lon=-122.30767500&lat=41.30841000&wid=1.00000000&ht=1.04000000&iwd=1200&iht=1248&on=CITIES,GRID,counties,indian,majroads,miscell,places,railroad,shorelin,streets,interstate,statehwy,ushwy,states,water".
Opening Internet...
Status Code is 200
Writing file "D:\workspace\geoDataClient\Release\93953090_tx_00.gif"...
Writing file "D:\workspace\geoDataClient\Release\93953090_tx_00.gif" finished.
HTTP request was successful.
Converting "D:\workspace\geoDataClient\Release\93953090_tx_00.gif" to "D:\workspace\geoDataClient\Release\93953090_tx_00.tga".
GIF conversion successful: "D:\workspace\geoDataClient\Release\93953090_tx_00.tga" written.
Stretching/shrinking "D:\workspace\geoDataClient\Release\93953090_tx_00.tga" to "D:\workspace\geoDataClient\Release\93953090_tx_r_00.tga".
Stretching/shrinking successful: "D:\workspace\geoDataClient\Release\93953090_tx_r_00.tga" written.
Adding "D:\workspace\geoDataClient\Release\93953090_tx_r_00.tga" to "D:\workspace\geoDataClient\Release\93953090_tx_r.tga" at (0/0).
Adding successful: "D:\workspace\geoDataClient\Release\93953090_tx_r.tga" written.
Converting elevation "D:\workspace\geoDataClient\Release\93953090_el.tga" to color "D:\workspace\geoDataClient\Release\93953090_el_c.tga".
Color conversion successful: "D:\workspace\geoDataClient\Release\93953090_el_c.tga" written.
Combining "D:\workspace\geoDataClient\Release\93953090_tx_r.tga" and "D:\workspace\geoDataClient\Release\93953090_el_c.tga" to "D:\workspace\geoDataClient\Release\93953090_tx_c.tga".
Stretching/shrinking "D:\workspace\geoDataClient\Release\93953090_el_c.tga" to "D:\workspace\geoDataClient\Release\93953090_el_c.tga.stretched.tga".
Stretching/shrinking successful: "D:\workspace\geoDataClient\Release\93953090_el_c.tga.stretched.tga" written.
Combining successful: "D:\workspace\geoDataClient\Release\93953090_tx_c.tga" written.
Result file written: "D:\workspace\geoDataClient\Release\93953090_1.trf".
Result file written: "D:\workspace\geoDataClient\Release\93953090_2.trf".
Download successfully finished.
------------ END OF geoDataClient LOG FILE ------------
