home *** CD-ROM | disk | FTP | other *** search
/ World of Ham Radio 1997 / WOHR97_AmSoft_(1997-02-01).iso / misc / suntime / prog / suntime.doc < prev    next >
Text File  |  1997-02-01  |  14KB  |  289 lines
  1.  
  2.                        Sun-Time Version 1.2  by  RejTech
  3.                        - - - - - - - - - - - - - - - - -
  4.                         Copyright(c) 1992, 1993 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 3 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]  - Displays the program version and registration
  49.                      information.  Buttons at the bottom of this
  50.                      window allow E-Z program registration plus the
  51.                      setting of various program options.
  52.  
  53.           [Cities] - Allows selection of a new city.  A pick-list
  54.                      will be presented.  Select the city to compute
  55.                      using the mouse and scroll-bar at the right of
  56.                      list or by using the cursor keys.  When the
  57.                      desired city is highlighted, press the enter
  58.                      key or click on that entry with the left mouse
  59.                      button to select it.
  60.  
  61.  
  62.                        Sun-Time Version 1.2  by  RejTech
  63.                        - - - - - - - - - - - - - - - - -
  64.  
  65.    OPERATION (Continued):
  66.    ----------------------
  67.           [Zones]  - Selects the time zone for the selected city.  When
  68.                      the city selection is made, the default time zone for
  69.                      the city is automatically chosen.   This option is
  70.                      present in case you desire to use a time zone other
  71.                      than the default.  Note: If the "Auto DST" flag for
  72.                      the city is set to 'Y', daylight savings time adjust-
  73.                      ments will be performed automatically.  The STANDARD
  74.                      time zone for the selected city should always be used
  75.                      in this case (not the daylight savings time zone).
  76.  
  77.           [Exit]   - Ends the program.  Your current configuration will be
  78.                      saved before exiting the program, therefore the next
  79.                      time you execute "SUNTIME", the same city will be
  80.                      displayed.
  81.  
  82.    SUNRISE, SUNSET, AND TWILIGHT:
  83.    ------------------------------
  84.       The time when the top ridge of the sun becomes visible is defined to
  85.       be sunrise (or sunset when it is no longer visible).  The center of
  86.       the sun will be zero degrees, 50 minutes below the horizon when this
  87.       occurs (for most locations).
  88.  
  89.       Twilight is the time when the sun is below the horizon, but it's light
  90.       is still reflected in the atmosphere.
  91.  
  92.       The computations made assume a sea-level location with a flat horizon.
  93.       Mountains to the east or west will of course alter the actual time
  94.       the sun will make it's appearance.
  95.  
  96.       If the city you have selected is at an extreme northern or southern
  97.       location, the sun may not rise or set, or certain twilight boundaries
  98.       may not be crossed.  If this is the case, no time will be displayed
  99.       for that event.
  100.  
  101.    TWILIGHT:
  102.    ---------
  103.       There are three 'twilight' (dawn and dusk) times shown:
  104.  
  105.          1.  Astronomical Twilight is the time when there is a slight glow
  106.                 in the eastern (sunrise) or western (sunset) sky.  This
  107.                 is defined as the point when the sun is 18 degrees below
  108.                 the horizon.
  109.          2.  Nautical Twilight is the time when most stars disappear from
  110.                 the sky.  It is defined as the point when the sun is 12
  111.                 degrees below the horizon.
  112.          3.  Civil Twilight is the time when it is generally bright enough
  113.                 drive without headlights.  It is defined as the point when
  114.                 the sun is 6 degrees below the horizon.
  115.  
  116.       The hours of twilight shown is the time between astronomical dawn and
  117.       sunrise plus the time between astronomical dusk and sunset.
  118.  
  119.  
  120.                        Sun-Time Version 1.2  by  RejTech
  121.                        - - - - - - - - - - - - - - - - -
  122.  
  123.    METHOD OF COMPUTATION:
  124.    ----------------------
  125.       The algorithm used to compute the sun's appearance and departure
  126.       from your city has been used in similar programs for several years.
  127.       A crude BASIC language version was published by William C. Bell in
  128.       in the April 1984 issue of "Astronomy" Magazine.  This algorithm
  129.       (method of computation) used should be accurate to within a minute
  130.       or two at most locations.  Extreme northern or southern latitudes
  131.       will be somewhat less accurate.
  132.  
  133.    DAYLIGHT SAVINGS TIME:
  134.    ----------------------
  135.       If the 'Auto DST' flag in the CITIES.DAT file is set to 'Y' for the
  136.       chosen city, that city is assumed to use the standard Daylight Savings
  137.       Time pattern adopted by the United States.  Under this system, day-
  138.       light savings time begins on the first Sunday in April and ends on the
  139.       last Sunday in October.   If a city does not follow this pattern, this
  140.       flag should be set to 'N'.  You will then need to manually select a
  141.       time zone corresponding to daylight savings time when it is in effect.
  142.       In future versions, this flag may be expanded to a code which will
  143.       signify different (non US) DST patterns (...users with information on
  144.       other DST patterns used throughout the world are encouraged to let
  145.       me know about them so that they can be incorperated into future
  146.       versions).
  147.  
  148.    DATA FILES:
  149.    -----------
  150.       The data files CITIES.DAT and TIMEZONE.DAT are simple ASCII text
  151.       files which can be edited with any ASCII text editor.  You may add
  152.       or delete cities at will, but fields must begin in the same column
  153.       on each line (one city per line), therefore your text editor should
  154.       not insert any 'TAB' characters.   Comment lines may be inserted in
  155.       the files by placing an asterisk in column 1.
  156.  
  157.       The CITIES.DAT file currently contains over 1300 cities which have
  158.       been compiled from several sources.  The program should be able to
  159.       handle up to 2600 entries (128K of data).   The current database is
  160.       for the most part correct, but no guarantee can be made as to it's
  161.       accuracy.   Although minor corrections have been made to the data
  162.       since version 1.0, it is essentially the same database.  No attempt
  163.       has been made to make updates for the recent changes in the USSR.
  164.       Users, please let me know of any changes needed to existing cities
  165.       in the database.  Also, if you believe there is a major city which
  166.       should included in the file, I will consider adding it to the next
  167.       version.  Thanks for your help in this area.
  168.  
  169.       The TIMEZONE.DAT file defines time zones used in CITIES.DAT.  All 24
  170.       time zones are currently defined here along with several location-
  171.       specific time zones.  For areas where a non-standard time zone is used
  172.       (Saudi-Arabia, etc), a code of 'XXX' should be placed in the 'CITIES
  173.       .DAT' file.  This will cause the standard time to be computed based on
  174.       the longitude of the city.
  175.  
  176.       Note - The 3-digit time zone code MUST match in both files.  If you
  177.              decide to change this in the TIMEZONE.DAT file, you must also
  178.              change each occurrence of it in the CITIES.DAT file.
  179.  
  180.            - The program ANYTIME.EXE also uses these same data files.  If
  181.              you are using both programs, keep them in the same directory
  182.              so that they may each share a single copy of the data files.
  183.  
  184.  
  185.                        Sun-Time Version 1.2  by  RejTech
  186.                        - - - - - - - - - - - - - - - - -
  187.  
  188.    SETTING PROGRAM OPTIONS
  189.    -----------------------
  190.       Version 1.2 allows user selection of various program options such as
  191.       time and date display format, screen colors and video display mode.
  192.       To register, select the <About> button in the program's main window,
  193.       then select the <Setup> button.  This will open a dialog box which
  194.       allows change of the current program options:
  195.  
  196.        1.  Video Mode - Enter 'F' for the fastest video display.  If this
  197.                         causes problems, select 'D' or 'B'.  Both of these
  198.                         options will eliminate snow on CGA monitors.  The
  199.                         'B' option (Bios) is the most compatible but is
  200.                         also the slowest.
  201.  
  202.        2.  Reset Video - Select 'Y' to force the video mode to be reset.
  203.                         This may be necessary if previous software did
  204.                         not leave the screen in normal text mode.  Note
  205.                         that selecting 'Y' may force the screen to be
  206.                         cleared with certain video-display adaptors.
  207.  
  208.        3.  Cursor Size - Select 'S' for the standard cursor or 'B' for a
  209.                         larger block cursor (useful for LCD displays).
  210.  
  211.        4.  Clear Screen - Enter 'Y' to force the screen to be cleared to
  212.                         a textured background when the program is started.
  213.  
  214.        5.  Time Mode  - Enter '2' for a 12-hour display format or '4'
  215.                         for a 24-hour display format.
  216.  
  217.        6.  Time Seperator - Enter the character that should be used to
  218.                         delimit the hours/minutes/seconds in the time
  219.                         display (normally a colon).
  220.  
  221.        7.  Date Mode  - Enter 'M' to display dates in Month/day/year
  222.                         order, 'D' to display dates in Day/month/year
  223.                         order, or 'Y' to display in Year/Month/Day order.
  224.  
  225.        8.  Date Seperator - Enter the character that should be used to
  226.                         delimit the month/day/year in the date display
  227.                         (normally a forward slash or dash).
  228.  
  229.        9.  Left Window Column - Enter a number from 1 to 27 to specify
  230.                         the screen column where the program window should
  231.                         be placed (normally 14 to center on screen).
  232.  
  233.        10. Color Scheme - Enter 'C' for a CYAN (blue-green) display
  234.                         background on the display.  Enter 'W' for a WHITE
  235.                         background, or 'B' for a BLUE background.
  236.  
  237.  
  238.       When the options are set as desired, select the <Proceed> button (or
  239.       press the <F2> key) to register the changes.  Pressing the <Cancel>
  240.       button (or <Esc> key) will abandon any changes made.
  241.  
  242.  
  243.  
  244.                        Sun-Time Version 1.2 by  RejTech
  245.                        - - - - - - - - - - - - - - - - -
  246.  
  247.    SOFTWARE LICENSE REGISTRATION:
  248.    ------------------------------
  249.       This program is copyrighted shareware and should be registered if
  250.       you find it useful and intend to use it (or if you just feel like
  251.       being generous).   A single user registration fee is only $5.00.
  252.  
  253.       To register, select the <About> button in the program's main window,
  254.       then select the <Register> button.  You will then be prompted for
  255.       required information and a mailable registration form will be
  256.       printed on your system printer.  If this process fails or if you do
  257.       not have a printer connected to LPT1, send your name, address and
  258.       and $5.00 (Check or MO, U.S.) to:
  259.  
  260.                        RejTech, SunTime v1.2 Registration
  261.                        P.O. Box 721247
  262.                        Oklahoma City, Oklahoma  73172-1247.
  263.  
  264.       Please state version number so that I can be sure you have the latest
  265.       release.
  266.  
  267.       You may freely distribute the original version of this program to
  268.       anyone you think might benefit from it, provided all the files stated
  269.       above remain intact and unaltered, including the REJTECH.COM file.
  270.  
  271.       Thanks for your support.
  272.  
  273.  
  274.    WARRANTY:
  275.    ---------
  276.       This program is provided on an AS-IS basis WITHOUT warranty of
  277.       any kind.  As with all computer software, it may contain logic
  278.       errors which might give erroneous results.  RejTech will not be
  279.       held liable for any damages, whether direct or consequential,
  280.       arising from the use of this software.
  281.  
  282.       Please direct any comments or report any bugs to the address given
  283.       above.  You may also leave me a message on CompuServe.
  284.  
  285.                                           Rob Jordan, RejTech
  286.                                           CompuServe ID: 70515,722
  287.  
  288.  
  289.