# TopoVista 4.0

This is version 4.0 of the TopoVista package. The TopoVista viewer renders 3-dimensional terrain images synthesized from grids of elevation data. The TopoVista package includes other related components including data converters and network servers.

## Origin

TopoVista was written by Will Evans (University of British Columbia) and Gregg Townsend (University of Arizona). For more information see the TopoVista web page at www.cs.arizona.edu/topovista.

Send problem reports and other e-mail to topovista@cs.arizona.edu.

## Licensing

This is free software. The f123 directory is based on code from the US Bureau of Land Management and is in the public domain. All other components are covered by the statement in this license.

## Organization

The top-level directories in the TopoVista package are:

`doc` | documentation
`src` | source code in the C language
`topovista` | source code in the Java language (package name “topovista”)
`bin` | executable code (scripts, C programs, and Java jar files)
`test` | automated tests
`expt` | manual tests and other experiments
`data` | sample data

## Getting Started

To experiment with TopoVista:

1. Build the code, which can be as simple as just typing `make`. See the full instructions for information about required prerequisites.
2. Add the `bin` directory to your search path.
3. Run the viewer (see documentation) using the supplied test data. Try any of these commands:

   > `topo data/crater/504J309i.tvg data/crater/crater.ppm.gz
   > topo data/supai/252L6279f.tvg data/supai/trail.fp
   > topo data/lemmon/503L465h.tvg data/lemmon/lemmon.fp`

4. Get some data of your own (see instructions) and view it using TopoVista.

## Documentation

Installation | Release Notes Building TopoVista
Usage | Preparing data Running the viewer Summary of all programs
Internals | Tile data file format Current TVRP protocol (“AGILE”)
Historic | Old TVTP protocol Token service website Token service notes