home *** CD-ROM | disk | FTP | other *** search
/ Best Objectech Shareware Selections / UNTITLED.iso / boss / home / misc / 018 / suntime.doc < prev    next >
Encoding:
Text File  |  1992-12-30  |  10.2 KB  |  221 lines
  1.  
  2.                        Sun-Time Version 1.0  by  RejTech
  3.                        - - - - - - - - - - - - - - - - -
  4.                           Copyright(c) 1992, RejTech
  5.                                  P.O. Box 721247
  6.                       Oklahoma City, Oklahoma  73172-1247
  7.  
  8.  
  9.    OVERVIEW:
  10.    ---------
  11.       SUNTIME is a program which will display the sunrise and sunset
  12.       times as well as times for 4 levels of twilight for the city
  13.       selected.  It uses a modern user interface which is very simple
  14.       to use and can be controlled either from the keyboard or with a
  15.       mouse.  The city displayed is selected from a database which
  16.       currently contains over 1300 entries and may be customized using
  17.       any ASCII text editor.
  18.  
  19.  
  20.    INSTALLATION:
  21.    -------------
  22.       Simply copy all files to any desired directory.
  23.  
  24.       Files contained on the installation disk:
  25.           SUNTIME.EXE   - Main Program File
  26.           SUNTIME.CFG   - Stores Current Program Configuration
  27.           SUNTIME.DOC   - Documentation for SUNTIME.EXE (this file)
  28.           REJTECH.COM   - Software Registration Module
  29.           REGISTER.BAT  - Batch procedure to print registration form
  30.                           and receive a discount for registering both
  31.                           SUNTIME and ANYTIME together.
  32.           CITIES.DAT    - City Data File
  33.           TIMEZONE.DAT  - Time Zone Definition File
  34.  
  35.       Both data files (CITIES.DAT and TIMEZONE.DAT) are required for
  36.       operation and must be in the same directory as SUNTIME.EXE.
  37.  
  38.    OPERATION:
  39.    ----------
  40.       Using this program is very simple.  To start the program from DOS
  41.       simply type "SUNTIME" and hit <Enter> at the DOS prompt.  When the
  42.       program has be activated, enter the date desired and the sunrise/
  43.       sunset computations will automatically  be  displayed for the city
  44.       shown.   To change program options, just select one of the four
  45.       buttons shown by pressing the indicated function key or clicking
  46.       on the button with your mouse:
  47.  
  48.           [About]  - Supplies version and registration information
  49.                      about the program.
  50.  
  51.           [Cities] - Allows selection of a new city.  A pick-list
  52.                      will be presented.  Select the city to compute
  53.                      using the mouse and scroll-bar at the right of
  54.                      list or by using the cursor keys.  When the
  55.                      desired city is highlighted, press the enter
  56.                      key or click on that entry with the left mouse
  57.                      button to select it.
  58.  
  59.  
  60.  
  61.                        Sun-Time Version 1.0  by  RejTech
  62.                        - - - - - - - - - - - - - - - - -
  63.  
  64.    OPERATION (Continued):
  65.    ----------------------
  66.           [Zones]  - Selects the time zone for the selected city.  When
  67.                      the city selection is made, the default time zone for
  68.                      the city is automatically chosen.   This option is
  69.                      present in case you desire to use a time zone other
  70.                      than the default.  Note: If the "Auto DST" flag for
  71.                      the city is set to 'Y', daylight savings time adjust-
  72.                      ments will be performed automatically.  The STANDARD
  73.                      time zone for the selected city should always be used
  74.                      in this case (not the daylight savings time zone).
  75.  
  76.           [Exit]   - Ends the program.  Your current configuration will be
  77.                      saved before exiting the program, therefore the next
  78.                      time you execute "SUNTIME", the same city will be
  79.                      displayed.
  80.  
  81.    SUNRISE, SUNSET, AND TWILIGHT:
  82.    ------------------------------
  83.       The time when the top ridge of the sun becomes visible is defined to
  84.       be sunrise (or sunset when it is no longer visible).  The center of
  85.       the sun will be zero degrees, 50 minutes below the horizon when this
  86.       occurs (for most locations).
  87.  
  88.       Twilight is the time when the sun is below the horizon, but it's light
  89.       is still reflected in the atmosphere.
  90.  
  91.       The computations made assume a sea-level location with a flat horizon.
  92.       Mountains to the east or west will of course alter the actual time
  93.       the sun will make it's appearance.
  94.  
  95.       If the city you have selected is at an extreme northern or southern
  96.       location, the sun may not rise or set, or certain twilight boundaries
  97.       may not be crossed.  If this is the case, no time will be displayed
  98.       for that event.
  99.  
  100.    TWILIGHT:
  101.    ---------
  102.       There are three 'twilight' (dawn and dusk) times shown:
  103.  
  104.          1.  Astronomical Twilight is the time when there is a slight glow
  105.                 in the eastern (sunrise) or western (sunset) sky.  This
  106.                 is defined as the point when the sun is 18 degrees below
  107.                 the horizon.
  108.          2.  Nautical Twilight is the time when most stars disappear from
  109.                 the sky.  It is defined as the point when the sun is 12
  110.                 degrees below the horizon.
  111.          3.  Civil Twilight is the time when it is generally bright enough
  112.                 drive without headlights.  It is defined as the point when
  113.                 the sun is 6 degrees below the horizon.
  114.  
  115.       The hours of twilight shown is the time between astronomical dawn and
  116.       sunrise plus the time between astronomical dusk and sunset.
  117.  
  118.  
  119.                        Sun-Time Version 1.0  by  RejTech
  120.                        - - - - - - - - - - - - - - - - -
  121.  
  122.    METHOD OF COMPUTATION:
  123.    ----------------------
  124.       The algorithm used to compute the sun's appearance and departure
  125.       from your city has been used in similar programs for several years.
  126.       A crude BASIC language version was published by William C. Bell in
  127.       in the April 1984 issue of "Astronomy" Magazine.  This algorithm
  128.       (method of computation) used should be accurate to within a minute
  129.       or two at most locations.  Extreme northern or southern latitudes
  130.       will be somewhat less accurate.
  131.  
  132.    DAYLIGHT SAVINGS TIME:
  133.    ----------------------
  134.       If the 'Auto DST' flag in the CITIES.DAT file is set to 'Y' for the
  135.       chosen city, that city is assumed to use the standard "Daylight Savings
  136.       Time" pattern adopted by the United States.  Under this system, day-
  137.       light savings time begins on the first Sunday in April and ends on the
  138.       last Sunday in October.   If a city does not follow this pattern, this
  139.       flag should be set to 'N'.  You will then need to manually select a
  140.       time zone corresponding to daylight savings time when it is in effect.
  141.  
  142.    DATA FILES:
  143.    -----------
  144.       The data files CITIES.DAT and TIMEZONE.DAT are simple ASCII text
  145.       files which can be edited with any ASCII text editor.  You may add
  146.       or delete cities at will, but fields must begin in the same column
  147.       on each line (one city per line), therefore your text editor should
  148.       not insert any 'TAB' characters.   Comment lines may be inserted in
  149.       the files by placing an asterisk in column 1.
  150.  
  151.       The CITIES.DAT file currently contains over 1300 cities which have
  152.       been compiled from several sources.  The program should be able to
  153.       handle up to 2600 entries (128K of data).   The current data is
  154.       believed to be correct for the most part, but no guarantee can be made
  155.       as to its accuracy.
  156.  
  157.  
  158.       The TIMEZONE.DAT file defines time zones used in CITIES.DAT.  All 24
  159.       time zones are currently defined here along with several location-
  160.       specific time zones.  For areas where a non-standard time zone is used
  161.       (Saudi-Arabia, etc), a code of 'XXX' should be placed in the 'CITIES
  162.       .DAT' file.  This will cause the standard time to be computed based on
  163.       the longitude of the city.
  164.  
  165.       Note - The 3-digit time zone code MUST match in both files.  If you
  166.              decide to change this in the TIMEZONE.DAT file, you must also
  167.              change each occurrence of it in the CITIES.DAT file.
  168.  
  169.            - The program ANYTIME.EXE also uses these same data files.  If
  170.              you are using both programs, keep them in the same directory
  171.              so that they may each share a single copy of the data files.
  172.  
  173.  
  174.  
  175.                        Sun-Time Version 1.0  by  RejTech
  176.                        - - - - - - - - - - - - - - - - -
  177.  
  178.    SOFTWARE LICENSE REGISTRATION:
  179.    ------------------------------
  180.       This program is copyrighted shareware and should be registered if
  181.       you find it useful and intend to use it (or if you just feel like
  182.       being generous).   A single user registration fee is only $5.00.
  183.  
  184.       To register, select the <About> button in the program's main window,
  185.       then select the <Register> button.  You will then be prompted for
  186.       required information and a mailable registration form will be
  187.       printed on your system printer.  If this process fails or if you do
  188.       not have a printer connected to LPT1, send your name, address and
  189.       and $5.00 (Check or MO, U.S.) to:
  190.  
  191.                        RejTech, SUNTIME Registration
  192.                        P.O. Box 721247
  193.                        Oklahoma City, Oklahoma  73172-1247.
  194.  
  195.       Please state version number so that I can be sure you have the latest
  196.       release.
  197.  
  198.       You may freely distribute the original version of this program to
  199.       anyone you think might benefit from it, provided all the files stated
  200.       above remain intact and unaltered, including the REJTECH.COM file.
  201.  
  202.       Thanks for your support.
  203.  
  204.  
  205.    WARRANTY:
  206.    ---------
  207.       This program is provided on an AS-IS basis WITHOUT warranty of
  208.       any kind.  As with all computer software, it may contain logic
  209.       errors which might give erroneous results.  RejTech will not be
  210.       held liable for any damages, whether direct or consequential,
  211.       arising from the use of this software.
  212.  
  213.  
  214.       Please direct any comments or report any bugs to the address given
  215.       above.  You may also leave me a message on CompuServe.
  216.  
  217.                                           Rob Jordan, RejTech
  218.                                           CompuServe ID: 70515,722
  219.  
  220.  
  221.