home *** CD-ROM | disk | FTP | other *** search
/ World of Ham Radio 1997 / WOHR97_AmSoft_(1997-02-01).iso / misc / w7juc / manual.doc < prev    next >
Text File  |  1997-02-01  |  13KB  |  238 lines
  1. April 23, 1995
  2.                               GREAT CIRCLE
  3.                   GREAT CIRCLE BEARINGS AND DISTANCES 
  4.                   COPYRIGHT @1995, W7JUC, Dean C. Cole
  5.                                     
  6.                                Version 1.4 
  7.                                     
  8.                                     
  9. GREAT CIRCLE is a program for use by amateur radio operators.  Its purpose is 
  10. to provide antenna direction from one amateur radio station to another.  This 
  11. program calculates, draws and displays a great circle map using the home QTH 
  12. as the center point.  The map will contain the location of both stations, the 
  13. path, and antenna direction and distances between the two locations.
  14.  
  15. This program was compiled using Borland's Turbo C 2.0 for DOS.  The program 
  16. was tested using 8088, 286, 386 and 486 computers.  But requires a VGA 
  17. monitor.  Computers with floating point hardware create the map much faster 
  18. than those requiring software emulation.  After the map is created, it is 
  19. saved to a file.  Each time the map is displayed, it is loaded 
  20. from the file into the video memory.  Recalculation and recreation of the map 
  21. are only necessary if the home QTH information is changed.
  22.  
  23. A data base containing world wide call areas, latitude, longitude, city and 
  24. country names is included.  A simple editor is provided to delete unwanted 
  25. locations, add new locations and modify or correct existing records in the 
  26. data base.  The data base is loaded into memory when the program is started.  
  27. Using this programming method, the data base must meet a size requirement, 
  28. not to exceed 64K bytes, which is about 700 records.  The included 
  29. data base contains about 550 records of data with room for about 150 
  30. additional records the user can enter.  Unwanted records can be deleted and 
  31. replaced with desired location data.  This will allow the user to tailor the 
  32. data base to his particular need.
  33.  
  34. A great circle map is drawn using coordinate data created by the Central 
  35. Intelligence Agency and placed in the public domain by Fred Pospeschil and 
  36. Antonio Riveria.  Each mapping point and segment is read from a file. The 
  37. distance and direction from the user's home QTH to that point is calculated.  
  38. The result is converted to x, y coordinates and  displayed on the monitor as 
  39. a pixel or line segment.  The coasts of continents and islands are drawn, the 
  40. water areas are color filled and the map is saved to a file for loading upon 
  41. request.
  42.  
  43. When the operator enters a call area or location of a desired station, the 
  44. data base is searched for a match to the request.  If found, the great circle 
  45. map is loaded and displayed with the path drawn between the two locations.  
  46. The antenna direction, distance and location of each station is also 
  47. displayed.  
  48.  
  49. GREAT CIRCLE works well with Microsoft Windows 3.1.  An icon and a pif file 
  50. are included for those users.
  51.  
  52.  
  53.  
  54. INSTALLATION:
  55.  
  56. To install, place the diskette into the appropriate drive and type in the 
  57. drive name and install; i.e.,"A:INSTALL."
  58.  
  59. 1.  The program will ask for the source drive letter.  The default drive is 
  60.     "A."  If  "A" is the correct drive, press <ENTER>.  If different, enter 
  61.     the proper drive letter and press <ENTER>.
  62.  
  63. 2.  Next you will be prompted for the destination drive letter.  The default 
  64.     drive is "C."  If "C" is the correct drive, press <ENTER>.  If different, 
  65.     enter the proper drive letter and press <ENTER>.
  66.  
  67. 3.  You will be asked if the disk information is correct.  Enter "Y" or "N" 
  68.     (upper or lower case) and <ENTER>.
  69.  
  70. 4.  If you answered yes, the program copies all files from the source to the 
  71.     destination except "INSTALL.EXE."
  72.  
  73. 5.  The setup routine will ask the user for his home QTH information:
  74.  
  75. SETUP:
  76.  
  77. 1.  Enter your amateur call sign.  You can use any case.  The program converts 
  78.     all call sign entries to upper case.  There is a limit of six characters 
  79.     for the call sign.  Press <ENTER> after the entry.
  80.  
  81. 2.  Next enter the city of your home QTH.  This entry is saved exactly as 
  82.     typed.  You may want to capitalize the first letter of the city name. The 
  83.     city name has a limit of 18 characters.  Press <ENTER> after the entry.
  84.  
  85. 3.  The country entry has a default of "USA."   If this is correct, press 
  86.     <ENTER>.  If your country is different, enter the country.   Again, this 
  87.     entry is saved exactly as typed.  The country name is limited to 12 
  88.     characters.  Press <ENTER> after the entry.
  89.  
  90. 4.  If the country is "USA," the user is prompted for the state.  If the 
  91.     country is "Canada," the user is prompted for the province.  This entry is 
  92.     the standard abbreviation for states and provinces.  This entry is not 
  93.     case sensitive.  The program will change all entries to upper case.  Press 
  94.     <ENTER> after the entry.
  95.  
  96. 5.  The user is now requested to enter the home QTH latitude.  Latitudes must 
  97.     follow the convention "North latitude is positive" and "South latitude is 
  98.     negative" and these entries must be between 90 degrees and -90 degrees.  
  99.     Enter latitude in degrees and fraction of degrees.   As an example, the
  100.     latitude, "40 degrees 30 minutes North," is entered  as "40.5."  Follow 
  101.     the latitude with <ENTER>.
  102.  
  103. 6.  Next the home QTH longitude is requested.  Longitudes must follow the 
  104.     convention "West longitude is positive" and "East longitude is negative" 
  105.     and all entries must be between 180 and -180 degrees.  Enter longitude in 
  106.     degrees and fraction of degrees.   As an example, the longitude, "110 
  107.     degrees 15 minutes West," is entered  as "110.25."  Follow longitude with
  108.     <ENTER>.
  109.  
  110. 7.  The user is asked if the home QTH is correct.  If correct enter "Y"  
  111.     (upper or lower case.)  If incorrect enter "N"  (upper or lower case) and 
  112.     reenter the data.  The program will now create the great circle map using 
  113.     your home QTH as the center.  Drawing and saving the map can take a few
  114.     minutes depending on the speed of the computer.  After the map is saved, 
  115.     the program is ready for input requests. 
  116.  
  117. NOTE:  The current directory set to GREATCIR before program execution.  Or, 
  118.        you can edit your "AUTOEXEC.BAT" and add "C:\GREATCIR" to the path 
  119.        statement.  If you prefer a different directory; i.e., 
  120.        "\HAM\DX\GREATCIR,"  create the subdirectory and copy the files into 
  121.        that subdirectory.  Edit "AUTOEXEC.BAT" file and add the full path of 
  122.        the subdirectory to the path statement.  Don't forget to reboot your 
  123.        system. 
  124.  
  125.  
  126. WINDOWS SUPPORT
  127.  
  128. One easy way to setup an icon for GREATCIR is to click the "File" menu on the 
  129. Program Manager, click on "New," click the "Program Item" button, click OK.  
  130. A chart will appear.  Fill in the chart as follows:
  131.  
  132.                Description: Great Circle Map
  133.                Command Line:  C:\GREATCIR\GREATCIR.PIF
  134.                Working Directory:  C:\GREATCIR
  135.  
  136. Click the "Change Icon" button.  A new window will appear stating "No Icons 
  137. Available . . . " Click the "OK" button.  A Different window will appear with 
  138. a number of  icons to choose from.  Ignore them and edit the "File" box.  
  139. Change the file name to "C:\GREATCIR\GREATCIR.ICO" and press the "OK" button.  
  140. The icon should appear.  Click the "OK" button again.  If everything looks 
  141. right, click the "OK" button again.  Now your GROUP should have an icon for 
  142. "Great Circle Map." 
  143.  
  144.  
  145. OPERATION:
  146.  
  147. There are four ways to get the antenna direction from your home QTH to another 
  148. QTH.  The user can enter the prefix of the call area or the name of the city 
  149. or state or country.   The user can use any mixture of upper or lower case 
  150. characters.  The program will ignore the case for this entry.
  151.  
  152. 1.  CALL AREA:  This is the default mode for searching the data base.  Enter 
  153.     the prefix of the call area of the other station; i.e. VK is the prefix 
  154.     for Australia.  Press <ENTER> after the entry.  The program searches the 
  155.     data base for that prefix.  If found, the map displays the direction with
  156.     the supporting information for that location.  When the call area is not 
  157.     found, the entry menu returns with notification of a no find.
  158.  
  159. 2.  CITY:  To search for a location by a city name, press the "F1" key.  The 
  160.     user is then prompted for the name of the city.  Enter the name of the 
  161.     city and press <ENTER>.  If found, the map displays the direction with the 
  162.     supporting information for that location.  When the city is not found, the 
  163.     "Call Area" entry menu returns with notification of a no find. 
  164.  
  165. 3.  STATE:  When the user wishes to find the direction to a particular state 
  166.     or province the "F2" key should be pressed.  The program now expects the 
  167.     two letter abbreviation of the state or province.  Again this is not case 
  168.     sensitive.  Upper or lower case characters will work.  Enter the two 
  169.     letters and press <ENTER>.  If found,  the map displays the direction and 
  170.     supporting information for that state or province.  When the state or 
  171.     province is not found, the "Call Area" entry menu returns with 
  172.     notification of a no find.  
  173.  
  174. 4.  COUNTRY:  Pressing the "F3" will cause a search of the country.  Enter the 
  175.     name of the country followed by <ENTER>.  Again this is not case 
  176.     sensitive.  If found,  the map displays the direction and supporting 
  177.     information for that country.  When the country is not found, the "Call
  178.     Area" entry menu returns with notification of a no find.  
  179.  
  180. NOTE:  Searches are performed by comparing the entered data with the data base 
  181.        data.  The comparison is made left to right, character by character.  
  182.        If all characters entered, match the first consecutive characters of 
  183.        the data base record, the record is displayed.  If "VK" is entered, all 
  184.        records starting with "VK" will be displayed.  If  "VK3" is entered, 
  185.        all records starting with "VK3" will be displayed.  Location searches 
  186.        are accomplished the same way.  If  "Sy" is entered, all records 
  187.        starting with "Sy" will be displayed; i.e. "Sydney," "Syracuse..."
  188.  
  189. 5.  SETUP:  Pressing the "F4" key will cause the program to ask for the home 
  190.     QTH data again.  Corrections or changes to your initial setup can be made 
  191.     using this function.  Changes cause the map to be redrawn.  Also, it can 
  192.     be fun to redraw the map using another location as the center.  A look at 
  193.     the world from an other country is interesting.  Be sure to reenter your 
  194.     home QTH and recreate the map when finished.
  195.  
  196. 6.  EDIT:  A very basic editor is available after pressing the "F5" key.  The 
  197.     editor will let the user view the data base.  Movement through the data 
  198.     base is possible with the use of the up and down arrows and page up and 
  199.     down keys.  A data base record or location can be changed by selecting an 
  200.     entry and pressing the "F2" key.  Call signs and names of countries are 
  201.     always changing these days.  The user can make corrections and modify the 
  202.     data base to meet this need.  To add a new entry press the "F1" key and 
  203.     enter the prefix or the prefix with the area number, or the full call 
  204.     sign, perhaps a friend; i.e.  W1AW or WWV.  Then enter all of the 
  205.     location data.  A record can be deleted by selecting an entry and pressing 
  206.     the "F3" key.  The data base has a limit of 700 records. 
  207.  
  208.  
  209. Even after many hours of testing, it is possible to discover errors.  Please 
  210. report any errors with instructions on how to recreate the error directly 
  211. to the author.  Suggestions and criticisms are always welcome.
  212.  
  213. LIST OF FILES:
  214.   
  215.   Distributed:
  216.     1.  INSTALL.EXE         Installation Utility.
  217.     2.  GREATCIR.EXE        Main program or executable                .
  218.     3.  WORLDMAP.DAT        Records of structures containing lat/long data.
  219.     4.  LOCATION.DAT        Data Base file of calls, locations and lat/long.
  220.     5.  GREATCIR.PIF        Windows PIF file.
  221.     6.  GREATCIR.ICO        Windows Icon.
  222.     7.  MANUAL.DOC          ASCII file of this document.
  223.     8.  MANUAL.WP           This document in WordPerfect 6.0 format.
  224.  
  225.   Created:
  226.     1.  MAP.GRF             Eight records containing sequential video images.
  227.     2.  HOMEQTH.DAT         Structure containg all home QTH Information.
  228.  
  229. This program is for the exclusive use of Amateur Radio and not authorized for 
  230. any commercial use.  This program is not for sale.  The user may make copies 
  231. and pass them to other amateur radio operators.  The program may be placed on 
  232. a bulletin board for down loading.  All distribution of this software must be 
  233. free of charge other than reasonable reimbursement for the media.
  234.  
  235. This product contains/uses data placed in the public domain by Fred 
  236. Pospeschil and Antonio Riveria.  Original coordinate data was created by the 
  237. Central Intelligence Agency.
  238.