Zone Technical Background

The best way I can think of to describe the files and directories needed for a new zone is to walk through the creation by hand of a hypothetical new zone called Thule with a new region called Ultima.

1. Get the maps of the zone (along with the latitude and longitude of the corners)
  There are several sources for maps for any given area. Some are free, like www.topozone.com and Terraserver (see http://mapper.acme.com for a nice front end). Of the commercial products, I like TOPO! from National Geographic best, but Delorme has a good product also.
  It is very critical to get the exact latitude and longitude of the top-left and bottom-right corners of the maps. One trick I found is to export maps with lat/long tick marks turned on then trim the map down to the tick marks. (I have a tool available to automatically trim maps down.)
 
2.Create the following directories and files
  Thule.zone\ - a directory to hold all the zone files
  Thule.zone\Maps\ - put the maps into here
  Thule.zone\zone.data - initially this can be empty, later you can add overview images, etc.
  Thule.zone\node.data - initially this can be empty, it will contain roads, nodes and points of interest data
  Thule.zone\Ultima.klr - see below
 
3.Create the Ultima region and other regions within the Thule zone
  You must decide how to divide up the zone into regions. This is an arbitrary decision balancing larger regions that cover more territory versus smaller regions that load faster.
  In our example we need to create a file called Thule.zone\ultima.klr which contains the following (the map numbers are latitude and longitude)
   # KLIMB region data, for more info see
# http://purl.oclc.org/keithv/klimb/klimb.html

name=Ultima
nodes=node.data

map=Maps/thule_ultima01.gif:3:40 24 0 82 48 0 40 12 0 82 36 0
map=Maps/thule_ultima02.gif:3:40 24 0 82 36 0 40 12 0 82 24 0
map=Maps/thule_ultima03.gif:3:40 24 0 82 24 0 40 12 0 82 12 0
 
4.Enter node, road and points of interest data
  At this point you have a working KLIMB zone, but not a very interesting one without any roads on it. Adding in new node and road data is time consuming, but fortunately you can do the task incrementally.
  The more information you have about a node (its altitude) or road (distance, climbing in both directions) the better but KLIMB will work fine without it. I tend to rely on USGS topo maps for altitude information and on KLIMB to make a very good distance estimate. The only good way of getting the climbing data is to actually ride the route.
 
5.Some other non-essential stuff
  Overview maps: one or more maps showing the whole zone (or more)
  Advanced region selection: a zone map which allows you to select one or more regions to show.
  "Bending" roads: making the roads follow the actual road course.
  Points of interest

Home ©2008 Keith Vetter
klimb at klimb.org