home *** CD-ROM | disk | FTP | other *** search
/ HAM Radio 3 / hamradioversion3.0examsandprograms1992.iso / maps / fgc10 / fgc.doc next >
Text File  |  1990-01-04  |  12KB  |  315 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.       
  7.       
  8.       
  9.       
  10.       
  11.                         FAST GEO-CHRONOMETER (FGC)
  12.                             Version 1.0  1/4/90
  13.       
  14.       
  15.       
  16.       
  17.       
  18.       
  19.       
  20.       
  21.                              TABLE OF CONTENTS
  22.       
  23.       
  24.      1.0 Program Features and Requirements. . . . . . . . . . . . .  1
  25.       
  26.      2.0 Program Usage. . . . . . . . . . . . . . . . . . . . . . .  2
  27.       
  28.      3.0 Customizing the Names and Local Times shown on the World
  29.           Map . . . . . . . . . . . . . . . . . . . . . . . . . . .  4
  30.       
  31.      4.0 Program Information. . . . . . . . . . . . . . . . . . . .  6
  32.       
  33.      5.0 FGC Program Distribution Policy. . . . . . . . . . . . . .  6
  34.       
  35.       
  36.       
  37.                               LIST OF FIGURES
  38.       
  39.      FGC Command Keys . . . . . . . . . . . . . . . . . . . . . . .  3
  40.      Label Specification Line . . . . . . . . . . . . . . . . . . .  5
  41.       
  42.       
  43.       
  44.       
  45.       
  46.       
  47.       
  48.       
  49.       
  50.       
  51.       
  52.       
  53.       
  54.       
  55.       
  56.       
  57.  
  58.  
  59.        (C) Copyright  Robert A. Fullerton  1990  All rights reserved
  60.  
  61.  
  62.  
  63.      FGC                    Thursday, January 4, 1990                     Page 1
  64.  
  65.  
  66.       
  67.       
  68.      1.0 Program Features and Requirements
  69.       
  70.           This program, the Fast Geo-Chronometer (FGC), displays the
  71.      pattern of the sun's illumination on the surface of the earth. 
  72.      Although there are several other programs available which perform
  73.      a similar function, FGC provides a unique combination of features
  74.      designed to make it the best choice.
  75.       
  76.           These features are:
  77.       
  78.           An accurate, fast, and attractive display that fully
  79.           utilizes the capabilities of an EGA/VGA graphics adapter.
  80.       
  81.           Good accuracy over a wide time span.  Sunrise and sunset     
  82.           times can be determined to an accuracy of two minutes
  83.           (average), from the year 1980 to the year 2000, at any spot
  84.           on the earth's surface.
  85.       
  86.           High speed display updates without requiring the use of a
  87.           math co-processor.  On an 8 mhz AT, the display update rate
  88.           is 3 times per second.
  89.       
  90.           Total user control of the city and area names and associated
  91.           local times shown on the world map display.  The user can
  92.           edit a simple text file to specify any desired name label,
  93.           defining the label marker's position, whether the marker
  94.           will be hidden, the text accompanying the label, how this
  95.           text will be positioned, and whether a local time will be
  96.           displayed with the label (a separate local time zone can be
  97.           specified for each label).
  98.       
  99.           A stylized (but geometrically accurate) world map is
  100.           combined with an appropriate set of text fonts and the
  101.           versatile label specification capability.  The result is a
  102.           clean, attractive display that presents a large amount of
  103.           useful information.
  104.       
  105.           Both a real-time and a single-keystroke-controlled variable
  106.           speed mode are provided, allowing the changing sun illumina-
  107.           tion pattern to be displayed in an optimal manner.
  108.       
  109.       
  110.           Hardware requirements are an IBM PC compatible computer, an
  111.      EGA or VGA compatible display adapter (with 256KB of memory) and
  112.      a color display.
  113.       
  114.  
  115.  
  116.  
  117.      FGC                    Thursday, January 4, 1990                     Page 2
  118.  
  119.  
  120.      2.0 Program Usage
  121.       
  122.           If your clock is set to Mountain Standard Time, the program
  123.      can be run without any required set-up. Simply enter "FGC" on the
  124.      command line.  The files LABELS.DAT and FGCMAP.SCR must be in the
  125.      same directory as the program file FGC.EXE.
  126.       
  127.           However if you don't live by Mountain Standard time, you
  128.      will need to specify your own local zone.  This is done by
  129.      entering the difference in hours between your local time and
  130.      Greenwich Mean Time, and the 2 or 3 letter symbol for your time
  131.      zone, on line 1 of the data file LABELS.DAT.  This can be
  132.      accomplished using any editor capable of editing in an ASCII text
  133.      mode - for example, WordPerfect's DOS text mode.  A sample line,
  134.      for Eastern Standard Time, would be:
  135.       
  136.      5 EST        (this text would be put on line 1 of LABELS.DAT)
  137.       
  138.       
  139.           Examples for all US time zones, both for Standard and
  140.      Daylight Saving Time, are given in the LABELS.DAT file.
  141.       
  142.           If you don't enter this information correctly, the time will
  143.      still be properly displayed in the main title block, but the
  144.      sun's illumination pattern will be improperly offset and the
  145.      local times displayed for other world cities will be incorrect.
  146.       
  147.           The program starts in the real time mode, with the display
  148.      representing the current time (as specified by your computer's
  149.      internal clock).  The display can be toggled to a variable speed
  150.      fast-mode by pressing function key 10.  When the fast-mode is in
  151.      effect, pressing the '+' key will speed up the display (to a
  152.      maximum rate of one week per display iteration), and the '-' key
  153.      will decrease the displayed time-change rate.  Pressing function
  154.      key 10 again will toggle back to the real time mode.
  155.       
  156.           The program is exited via the ESC key.  Function key 1 
  157.      brings up a help screen. 
  158.       
  159.           The stored astronomical data in the program covers the years
  160.      1980 to 2000.  When in the high speed mode, the program will
  161.      automatically reset to the current time when the year 2000 is
  162.      reached, and will remain in this automatic loop cycling between
  163.      the current date and the year 2000 until interrupted by the
  164.      operator.  In the real time mode, the program will exit if the
  165.      DOS date is greater than Dec. 31, 1999.
  166.       
  167.           All program command keys are summarized in figure 1.
  168.       
  169.  
  170.  
  171.  
  172.      FGC                    Thursday, January 4, 1990                     Page 3
  173.  
  174.  
  175.                         
  176.                                                      
  177.       
  178.       
  179.       
  180.                     .------------------------------------.
  181.                     | * ESC exits program                |
  182.                     |                                    |
  183.                     | * F1 brings up Help-Screen         |
  184.                     |                                    |
  185.                     | * F10 toggles the Speed-Up mode    |
  186.                     | ---------------------------------  |
  187.                     |   When Speed-Up mode is active -   |
  188.                     |    +  :speeds up the time display  |
  189.                     |                                    |
  190.                     |    -  :slows the time display      |
  191.                     |                                    |
  192.                     |    F2 :pauses the display          |
  193.                     |        (any key continues)         |
  194.                     |____________________________________|
  195.            
  196.       
  197.                                  FIGURE 1
  198.                             FGC Command Keys
  199.       
  200.       
  201.  
  202.  
  203.  
  204.      FGC                    Thursday, January 4, 1990                     Page 4
  205.  
  206.  
  207.      3.0 Customizing the Names and Local Times shown on the World Map
  208.       
  209.           If you like the program, you probably will want to customize
  210.      the labels displayed on the map.  This is done by editing the
  211.      label definition lines in the LABELS.DAT data file.  Sample
  212.      labels for many world cities are provided.  These sample labels
  213.      can be changed to real labels by moving them left to begin in
  214.      column 1.
  215.       
  216.           For each label you can specify:
  217.       
  218.                The label position (latitude and longitude)
  219.       
  220.                The label text, and the position of this text           
  221.                relative to the (possibly hidden) label marker
  222.       
  223.                Whether a local time will be displayed below the        
  224.                label text, and the GMT offset for local time at the
  225.                label's position
  226.       
  227.           Directions for specifying your own labels are given in
  228.      figure 2 and in the file LABELS.DAT.
  229.       
  230.  
  231.  
  232.  
  233.      FGC                    Thursday, January 4, 1990                     Page 5
  234.  
  235.  
  236.       
  237.       
  238.       
  239.       
  240.       
  241.       .-- *n   The digit n ranges from 0 to 8.  It specifies how
  242.       |        the text is placed relative to the label marker
  243.       |
  244.       |           {2 3 4}      {  '+' represents label marker,
  245.       |           {1 + 5}  <-- {  digits show relative text position.
  246.       |           {8 7 6}      {  (0 specifies a hidden marker, with
  247.       |                        {  text displayed at position 5.)
  248.       |
  249.       |    .-- label text (as will be shown on display)
  250.       |    |      ( '_' specifies an embedded space in text.)
  251.       |    |    (With a single '_', marker is shown, but no text.)
  252.       |    |      
  253.       |    |      .--N or S latitude degrees (pos'n of label marker)
  254.       |    |      |
  255.       |    |      |  .-- latitude minutes (optional)
  256.       |    |      |  | 
  257.       |    |      |  |   .-- E or W longitude degrees
  258.       |    |      |  |   |
  259.       |    |      |  |   |  .-- longitude minutes (optional)
  260.       |    |      |  |   |  |
  261.       |    |      |  |   |  |   .-- Optional, time display with label.
  262.       |    |      |  |   |  |   |   Tnn.nn:  nn.nn is GT offset (hrs)
  263.       |    |      |  |   |  |   |   (range +/-  0.0-23.9,
  264.       |    |      |  |   |  |   |     + = west of Greenwich)
  265.       |    |      |  |   |  |   |
  266.      -- -------- --- -- --- -- ----
  267.      *5 New_York N40 43 W74 01 T5.0    <------ label definition 
  268.                                            (must start in column 1)
  269.       
  270.       
  271.                                  FIGURE 2
  272.                          Label Specification Line
  273.       
  274.       
  275.  
  276.  
  277.  
  278.      FGC                    Thursday, January 4, 1990                     Page 6
  279.  
  280.  
  281.      4.0 Program Information
  282.       
  283.           The program was written in Turbo C 2.0 and a Beta version of
  284.      Turbo Assembler 2.0. 1800 lines of source code were required. 
  285.      The world map was created using EGA Paint 2005.
  286.       
  287.           The requirement for a math co-processor was eliminated by
  288.      pre-computing all required transcendental functions, and storing
  289.      the results in lookup tables.  All required astronomical data
  290.      covering the years 1980 through 2000 is also stored in tabular
  291.      form, thus reducing real-time computations to a minimum.
  292.       
  293.       
  294.       
  295.       
  296.      5.0 FGC Program Distribution Policy
  297.       
  298.           Copies of FGC used only for non-commercial personal purposes
  299.      are free.  A license fee is required for use by corporations and
  300.      institutions.  This program may not be modified without my
  301.      written permission, and all rights are reserved.
  302.       
  303.           A version of FGC that automatically adjusts for Daylight
  304.      Saving Time, for both the local time zone and the world cities
  305.      shown on the display, is available for a fee of $25.00.
  306.       
  307.           If you are interested in either the upgraded version or
  308.      commercial usage fees, please contact me by writing to:
  309.       
  310.                Robert Fullerton
  311.                HS Systems
  312.                886 E.  4070 S. #21
  313.                Salt Lake City, UT 84107
  314.       
  315.