home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload / ShartewareOverload.cdr / educ / teratime.zip / WCD.DOC < prev    next >
Text File  |  1988-05-29  |  12KB  |  241 lines
  1.  
  2.  
  3.  
  4.  
  5.          ************************************************************
  6.          *                                                          *
  7.          *                    W O R L D   C I T Y                   *
  8.          *             D I S T A N C E   C O M P U T E R            *
  9.          *                                                          *
  10.          *                      WCD Version 3.0                     *
  11.          *                                                          *
  12.          *                      (C)opyright 1988                    *
  13.          *                    All Rights Reserved                   *
  14.          *                                                          *
  15.          *==========================================================*
  16.          *                                                          *
  17.          *                    GeoGraphics Software                  *
  18.          *                   126 Mountain View Road                 *
  19.          *                    Glastonbury, CT 06033                 *
  20.          *                                                          *
  21.          *----------------------------------------------------------*
  22.          *                                                          *
  23.          *       WCD is user-supported software provided to         *
  24.          *   you at no charge on a trial basis.  If you use this    *
  25.          *   software and find it of value please register your     *
  26.          *     copy for $15.00 and support the shareware concept.   *
  27.          *    Registered users will be provided with information    *
  28.          *    about program updates. Please make checks payable     *
  29.          *          to G. K. Marek at the above address.            *
  30.          *                                                          *
  31.          *      You are encouraged to share this software with      *
  32.          *      others provided that it is distributed complete     *
  33.          *      with documentation and in unmodified form and       *
  34.          *     that no fee or other consideration is charged or     *
  35.          *     accepted.  All commercial, business and government   *
  36.          *           users must register each copy in use.          *
  37.          *                                                          *
  38.          *      We hope you enjoy using WCD.  Your comments and     *
  39.          *  suggestions to improve this product are always welcome. *
  40.          *                                                          *
  41.          *                                                          *
  42.          *                                                          *
  43.          ************************************************************
  44.  
  45.  
  46.  
  47.  
  48.  
  49. PROGRAM DESCRIPTION
  50.  
  51. WCD, The World City Distance Computer, is designed to provide distance
  52. and travel time information between over 400 different world cities,
  53. including most major US cities.  The program is windowed and menu
  54. driven, and basically self-explanatory.
  55.  
  56.  
  57. HARDWARE REQUIREMENTS
  58.  
  59. This program is designed for IBM Personal Computers and close
  60. compatibles.  It will execute on the IBM-PC, PC-XT, PS/2 and PC-jr.  DOS
  61. Version 2.1 or later is required.  Since the program relies extensively
  62. on color, a color monitor is recommended.  The program will run,
  63. however, unmodified, on the Compaq.  WCD requires about 64K of memory
  64. and does not require BASIC to operate.
  65.  
  66.  
  67. PROGRAM INFORMATION
  68.  
  69. The program is started by issuing WCD at the DOS prompt.  You will see
  70. the program loading city information from its built-in database of 400
  71. world cities.  It will also load in city data from a separate datafile
  72. that the user can alter.  More about this in the DATAFILE section.
  73.  
  74. Menu instructions appear on the left and a window of city information
  75. appears on the right.  Each city is identified by a three letter code
  76. which represents that city's airport code.  Some cities have several
  77. airports.  If the desired city code is known it can simply be entered at
  78. the keyboard.  If the code is not known, the window on the right can be
  79. used to relate the codes to the respective cities.  Use the scroll keys
  80. to search this window for the three letter code of the city desired,
  81. including the Arrows, PageUp, PageDown, Home and End keys.  Pressing
  82. [Enter] will select the city highlighted in the window.
  83.  
  84. The number keys provide functions to assist in specifying your desired
  85. city pairs including a database search function.  See the NUMBER KEY
  86. section for detailed description.
  87.  
  88.  
  89. PROGRAM FILES
  90.  
  91. The World City Distance Computer system comes in four files:
  92.  
  93.          WCD.EXE      executable program module
  94.          WCD.DAT      extra cities information
  95.          WCD.DOC      documentation file (ASCII); (this file)
  96.          WCDREAD.ME   a short program description with latest changes
  97.  
  98. These files are packaged in a self-extracting archive file called
  99. WCDARC.EXE which creates each file when the archive file is run.
  100.  
  101. The first two files must reside on the current directory or path for the
  102. program to be accessible.
  103.  
  104. None of these files is copy-protected and it is suggested that the
  105. archive file be saved in a separate place with your other archive and
  106. backup files.  Just run it again for a fresh copy of all the files.
  107. To share this software with others, please transmit the archive file
  108. so that the original program and files will remain intact.
  109.  
  110.  
  111. NUMBER KEY FUNCTIONS
  112.  
  113. 1- SEARCH    for a particular string of characters in city list
  114. 2- ERASE     start selection of this particular city over
  115. 3- RESTART   start total selection process over
  116. 4- COORDS    enter latitude and longitude instead of city name
  117. 5- LASTCITY  use last city chosen as this city input
  118. 9- QUIT      end program and return to DOS
  119.  
  120.  
  121. DISTANCE INFORMATION SCREEN
  122.  
  123. Once all of the inputs are provided, a pop-up screen appears in the
  124. lower left which contains output information.  It includes distances
  125. (both great circle distance and equivalent still air distance, which are
  126. explained below) in three sets of units, the estimated flying time, the
  127. direct bearing angle from the first city to the second, and an enroute
  128. high altitude winds estimate.  Negative winds are headwinds and positive
  129. values represent tailwinds.
  130.  
  131. The computation of flight time is quite complex.  The time for the great
  132. circle flight is determined from empirical information on flight speed
  133. as a function of route distance for jet aircraft.  This time is then
  134. corrected for winds based upon a model of world high altitude winds
  135. using the specific route flown.  This flight time is accurate to about
  136. 10 minutes or 10% of the elapsed flight time, whichever is greater.  It
  137. does not account for extraordinary traffic delays, airways that do not
  138. closely follow the great circle route or enroute stops.
  139.  
  140. The bearing is the direction of departure from the origin city along the
  141. great circle path toward the destination city.  It is measured from the
  142. origin by basic compass direction.  Thus, the bearing from LA to New
  143. York is 65 degrees (or about east-northeast) and the bearing from LA to
  144. San Francisco is 320 degress (or about north-northwest).  On longer
  145. distances, the initial bearing might seem deceiving.  For example,
  146. the initial bearing from Tokyo to Los Angeles is 55 degrees, or east
  147. north-east even though LA is actually south of Tokyo (33 degrees north
  148. latitude for LA, versus 35 degrees for Tokyo).  So the shortest distance
  149. from Tokyo to LA actually starts off headed north even though LA is
  150. more southerly!  Try it with a globe and string to check for yourself.
  151.  
  152.  
  153. A WORD ABOUT DISTANCE AND TIME
  154.  
  155. The distances computed are based upon the "great circle distance (GCD)"
  156. between the two cities, which can be thought of as the route described
  157. by a string pulled taut between the two cities on a globe.  This
  158. represents the shortest distance between the two cities.
  159.  
  160. These great circle distances between cities are geometrically correct.
  161. For airplane flight purposes, however, prevailing head or tail winds
  162. make the apparent distance different and should be taken into account.
  163. High altitude winds can be greater than 60 knots and are significant for
  164. the flight time calculation.  For example, the great circle distance
  165. between Los Angeles and New York is 2467 statute miles.  But an airplane
  166. travelling between these cities faces a prevailing headwind of 25 knots
  167. when headed westbound (i.e. from New York to LA) and a prevailing
  168. tailwind of 22 knots in the other direction.  Thus the eastbound flight
  169. is shorter in time than the westbound because it is assisted by the wind
  170. rather than hindered.  The "equivalent still air distance (ESAD)"
  171. accounts for this wind effect.  Flying against the wind, the ESAD is
  172. greater than the GCD since the headwind causes the plane to fly longer
  173. to reach its destination.  Thus the ESAD from NYC to LA is 2611 statute
  174. miles and takes 5 hours and 33 minutes (against the wind) while the ESAD
  175. from LA to NYC is 2351 statue miles and takes only 5 hours and 2 minutes
  176. (with the wind's help).  This ESAD is used to compute the flight time
  177. that accounts for the effects of enroute winds.  So, although the great circle
  178. distance between two cities is the same in both directions, because
  179. of prevailing winds, the equivalent still air distances and the flight
  180. times are not.
  181.  
  182. IF THIS CONFUSES YOU A LITTLE, just remember that the ACTUAL DISTANCE
  183. between a city pair is the great circle distance (GCD) and that the
  184. FLIGHT TIME is computed to include the effects of the wind in the
  185. correct direction.
  186.  
  187.  
  188. THE DATAFILE
  189.  
  190. The program allows the user to include additional city pairs in a file
  191. called WCD.DAT.  This file is provided with the programs and contains
  192. many additional smaller cities that the user may wish to select to be
  193. included in the program when it is run.  If you are satisfied with the
  194. cities in the program itself and do not require additional cities, you
  195. may remove this file (WCD.DAT) from the current directory to speed the
  196. loading of the program.
  197.  
  198. Memory space precludes fitting all of the additional cities within the
  199. program itself.  As supplied, only 10 additional cities are selected for
  200. loading.  You can edit this file to select other cities or remove those
  201. selected by changing Field A as instructed below.  The user can also
  202. edit this file to add other cities of his choosing.  The format of the
  203. file, sampled from the middle of the datafile, is as follows:
  204.  
  205. COLUMN   1         2         3         4         5         6         7
  206. 12345678901234567890123456789012345678901234567890123456789012345678901
  207. FIELD
  208. A      B                  C           D      E       F
  209.  
  210. 0, GOONDIWINDI,     QLAND AUSTRALIA, GOO, -28.31, -150.19
  211. 1, GOTHENBURG,      SWEDEN,          GOT,  57.40,  -12.17
  212. 0, GRANADA,         SPAIN,           GRX,  37.11,    3.47
  213. 0, GUADALAJARA,     MEXICO,          GDL,  20.31,  103.19
  214. 0, HOBART,          TSMNIA AUSTRALIA,HBA, -42.50, -147.29
  215.  
  216. The data columns are not critical, although retaining the existing
  217. columns will make spotting errors easier.  The commas between fields ARE
  218. critical since they actually delimit (or separate) the data fields.
  219. Field descriptions:
  220.  
  221. Field A- 1-INCLUDE in program; 0-Do NOT include.
  222. Field B- Description of City Name
  223. Field C- Additional description such as State & Country
  224. Field D- A Three-Digit City Code designator (Numbers can be used)
  225. Field E- The City Latitude (North of Equator is positive)
  226. Field F- The City Longitude (West of Greenwich is positive)
  227.  
  228. In the sample data above, Gothenburg would be added to the program
  229. while the other cities would not.  The latitudes and longitudes are
  230. given in degrees and minutes in this format: DDD.MM.  Be careful with
  231. the proper sign to differential north from south and east from west.
  232.  
  233. Entire lines of data can be added to or deleted from this file.  Thus
  234. you can add new cities such as your hometown.  Lines deleted from this
  235. file will make the loading process a little faster, so if you are sure
  236. you don't care about a given city in this file you can eliminate it.
  237.  
  238. Your comments and suggestions for improvements are welcomed.
  239.  
  240.                        - O - O - O -
  241.