home *** CD-ROM | disk | FTP | other *** search
/ Graphics Plus / Graphics Plus.iso / amiga / mapping / wdbank.lzh / WorldDataBank / source.lha / source / WDB-II.Data.Doc < prev    next >
Encoding:
Text File  |  1991-12-18  |  5.3 KB  |  156 lines
  1. WDB-II DATA DOCUMENTATION
  2.  
  3. Contents:
  4.  
  5.      Overview
  6.      Micro WDB-II File and Record Structures
  7.      Field Definitions
  8.  
  9.  
  10.  
  11.  
  12. Overview
  13. ========
  14.  
  15.      This file documents the data structure used in WDB-II.  It
  16.      is from the original MS-DOS version by Fred Pospeschil and
  17.      Antonio Riveria.  Note that in this distribution for the
  18.      Amiga, the data appears in a different form than the original
  19.      in several respects:
  20.  
  21.      First, the original data was in Intel low order - high order
  22.      format.  For this release the data has been converted for use
  23.      with the Motorola chip set (high order - low order).
  24.  
  25.      Second, individual groupings of data for coastlines, islands,
  26.      rivers, lakes, and political boundaries as they appeared in
  27.      the original, have been consolidated into WDB.?.ALL files
  28.      consisting of data from all 6 groups.
  29.  
  30.      And lastly, the largest of the original data files did not
  31.      contain any data points from the lesser files; the complete
  32.      data set was only available by summing the data from each of
  33.      five detail levels.  This release differs in that the largest
  34.      file now contains all data, including that from each of the
  35.      lower four detail levels.  Each of the lower level files is a
  36.      subset of The Big File and, indeed, each lower level data
  37.      file is a subset of all higher level files.
  38.  
  39. _____________________________________________________________________
  40. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  41.  
  42. Micro WDB-II File and Record Structures
  43. =======================================
  44.  
  45. All Micro WDB-II files are sequential files composed of fixed length
  46. six byte records which can be accessed randomly.  Each record is
  47. composed of three 16-bit signed integer fields which can be read by
  48. all microcomputer languages.  There are no record seperators used in
  49. these files.  The record layout is :
  50.  
  51.    | Code | Latitude | Longitude |
  52.  
  53. In Pascal, the record definition is :
  54.  
  55. POINT = RECORD
  56. CODE      : INTEGER;
  57. LATITUDE  : INTEGER;
  58. LONGITUDE : INTEGER;
  59.    END;
  60.  
  61. Within the MWDBII files the records are stored as shown below.
  62. In some cases there may be hundreds of points in a single line
  63. segment.  In other cases there may be consecutive header records
  64. which locate individual points to be plotted.
  65.  
  66. |Header|Point1|Point2|PointN|Header|Point1|Point2|PointN|Header
  67. |Point1|Point2|Header|Header|Header|Point1|Point2|PointN|
  68.  
  69.  
  70. The same format is used for both the line header records and
  71. point records.  The usage of each field is as follows :
  72.  
  73.  
  74. Field Definitions
  75. =================
  76.  
  77. CODE - Line Header Records.
  78.  
  79. The CODE field is used to :
  80.  
  81.    1.  Identify the type of line segment which is described by
  82.        the point records which follow it,
  83.  
  84.    2.  Identify the line or point within the line type, and
  85.  
  86.    3.  Provide the coordinates if the record describes a point.
  87.  
  88. In header records the CODE field is always a positive four digit
  89. number in the form of : ABBB where
  90.  
  91. A =                         BBB =           CODE =
  92.   1 = Coast lines         001 -> 208     1001 -> 1208
  93.   2 = Country boundries   001 -> 301     2001 -> 2301
  94.   4 = State boundries     001 -> 111     4001 -> 4111
  95.   5 = Islands             001 -> 344     5001 -> 5344
  96.   6 = Lakes               001 -> 103     6001 -> 6103
  97.   7 = Rivers              001 -> 196     7001 -> 7196
  98.  
  99.  
  100. CODE - Point records.
  101.  
  102. In point records the CODE field contains the detail level.  The
  103. detail level is a value in the range of 1 through 5.  To properly
  104. retrieve points at any detail level use the following comparison :
  105.  
  106.    IF CODE >= DESIRED_DETAIL_LEVEL THEN ...
  107.  
  108.  
  109. LATITUDE and LONGITUDE - In both header and point records.
  110.  
  111. The latitude and longitude fields contain the coordinate values
  112. expressed in signed minutes.  The values in these fields are computed
  113. with the formula COORD_VALUE := (Degrees * 60) + Minutes.  Thus, the
  114. ranges of coordinate values in MWDBII are :
  115.  
  116.  90 00N =    5400
  117.  90 00S =   -5400
  118. 180 00E =   10800
  119. 180 00W =  -10800
  120.  
  121. MWDBII uses the standard four quadrant cartesian coordinate
  122. system in which north, south, east, and west are referenced to the
  123. equator and the Greenwich meridian.
  124.  
  125. When a header record is followed by point records the coordinates in
  126. the header record are the beginning of the line.  When a header record
  127. is followed by another header record then the coordinates in the
  128. header record should be plotted as a single point. When working at low
  129. levels of detail it is common to find multiple consecutive header
  130. records which locate isolated points.  There may also be gaps between
  131. some of the lines.
  132.  
  133. This documentation and the associated files are placed in the public
  134. domain and may incorporated into other products without fee so long as
  135. appropriate credits are included.  An appropriate credit line would be
  136. - "This product contains/uses data and/or code placed in the public
  137. domain by Fred Pospeschil and Antonio Riveria.  Original coordinate
  138. data was created by the Central Intelligence Agency."
  139.  
  140. All programs were compiled with MS Pascal Version 3.20.
  141. Graphics support was from Flexi-Graph, New Orleans General Data
  142. Services, 7230 Chadbourne Drive, New Orleans, LA 70126 and Micro Doc,
  143. 3108 Jackson St., Bellevue, NE 68005.
  144.  
  145. ALL USERS OF THESE MATERIALS ARE TOTALLY RESPONSIBLE FOR THEIR USE AS
  146. THESE MATERIALS ARE PROVIDED WITHOUT EITHER EXPRESS OR IMPLIED
  147. WARRANTIES OF ANY KIND.
  148.  
  149.  
  150.  
  151. Fred Pospeschil
  152. 3108 Jackson St.
  153. Bellevue, NE 68005
  154. 402-291-0795  (6-9 PM Central)
  155.  
  156.