home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload / ShartewareOverload.cdr / database / ac9117_2.zip / ASTROCLK.HST < prev    next >
Text File  |  1991-04-22  |  25KB  |  416 lines
  1.    ASTROCLK Astronomical Clock and Celestial Tracking Program        Page 1
  2.         Program Revision History
  3.  
  4.  
  5.         ASTROCLK REVISION HISTORY
  6.  
  7.              Each released version of ASTROCLK uses a four digit revision 
  8.         code such as 9117. The first two digits indicate the year      
  9.         and the second two digits indicate the week of the year. In some      
  10.         cases, an additional letter suffix is added to distinguish      
  11.         changes occuring within the same week. A partial week at the      
  12.         beginning or end of the year is counted as a full week. Using      
  13.         this method, a year will typically have 53 weeks although it is      
  14.         possible to have 54 weeks in a leap year (1972 is an example).      
  15.         The current year-week revision code is shown on the Julian Date      
  16.         display, Display Mode 7, in ASTROCLK.
  17.              This file records the recent revision history of program      
  18.         ASTROCLK through all of the minor twists and turns that usually      
  19.         accompany the evolution of such a program. (Early revision notes      
  20.         have been deleted from this file but are available on request.)      
  21.         It illustrates the tortuous process of maintaining and refining a      
  22.         program as ideas and problems are reported from every quarter. It      
  23.         may also be helpful to users who are upgrading from one version      
  24.         to another to find out what has changed. This file may also      
  25.         describe recent changes not included in the main documentation;      
  26.         compare the version numbers below with the main documentation.
  27.  
  28.                                                 David H. Ransom, Jr.
  29.  
  30.  
  31.         9117     04/22/91
  32.         -----------------
  33.         -This release is a MAJOR UPGRADE from Version 9050.
  34.  
  35.         NOTE:     ASTROCLK now requires binary external star catalogs 
  36.                   which have a filetype of ".CC1". ASTROCLK's external 
  37.                   catalog star searches (Function Key F5) will NOT 
  38.                   operate correctly with prior versions of the external 
  39.                   star catalogs! See below.
  40.  
  41.         -Added a sixth mode to the Precision Data Displays (Display Mode      
  42.         8) to show the local times for sunrise, sunset, and Civil, 
  43.         Nautical, and Astronomical twilight. Thanks to Matt Merrill for 
  44.         writing and debugging the original code which I then then adapted 
  45.         for use in ASTROCLK.
  46.         -Changed external star catalog from ASCII to binary format,      
  47.         identified by the filetype ".CC1".. The new supplied catalog      
  48.         names are ASTROCLK.CC1 and MESSIER.CC1. Catalog searches now      
  49.         require approximately one half the search time and the binary      
  50.         catalogs are less than half the size of the previous ASCII 
  51.         versions. Binary catalogs are created by my program STARCAT which 
  52.         will be available on my BBS. Other star catalogs may be available 
  53.         in a binary format for use with ASTROCLK.
  54.         -Edited ASTROCLK.CC1 and MESSIER.CC1 to delete the all-zero      
  55.         "place holder" which occupied the record for the non-existent      
  56.         Messier object M40. This caused an incorrect match on star      
  57.         searches near RA=0 and DEC=0. However, this means that the 
  58.         catalog number (when searching MESSIER.CC1 by catalog number 
  59.    ASTROCLK Astronomical Clock and Celestial Tracking Program        Page 2
  60.         Program Revision History
  61.  
  62.         rather than by object name) for Messier objects greater than 40 
  63.         will be one less than the Messier number.
  64.         -Corrected an error in angular separations during star searches      
  65.         if right ascension were set to zero.
  66.         -Added AUTO mode to DAYLIGHT FLAG, set using ALT-F10+F1. After      
  67.         pressing ALT-F10, press F1 repeatedly until the desired DAYLIGHT      
  68.         FLAG mode is displayed: "[OFF]", "[ON]", or "[AUTO ON]"/"AUTO      
  69.         OFF]". Note that when the AUTO mode is selected, the state of the      
  70.         DAYLIGHT FLAG ("ON" or "OFF") is selected based upon the current      
  71.         DOS date and time. Do not select the AUTO mode if your location      
  72.         does not use daylight time!
  73.         -When set to the AUTO mode, the DAYLIGHT FLAG will be set or      
  74.         reset automatically and the local time zone clock display title      
  75.         (Display Mode 1) will change from standard to daylight time or      
  76.         vice versa. Daylight time is ENABLED as of 02:00 on the first      
  77.         Sunday in April; daylight time is DISABLED as of 02:00 on the      
  78.         last Sunday in October. These dates are valid ONLY for the United      
  79.         States and Canada; all other users should set the DAYLIGHT FLAG      
  80.         to ON or OFF manually to correspond to daylight or summer time      
  81.         conventions in their location. NOTE: Systems with an 80286 
  82.         processor or higher AND using DOS Version 3.3 or higher will also      
  83.         change the hardware clock when using the AUTO mode. For these      
  84.         systems, including ASTROCLK in the AUTOEXEC.BAT file and setting      
  85.         the DAYLIGHT FLAG to the AUTO mode will automatically adjust the      
  86.         computer hardware and software clocks for daylight time changes      
  87.         at boot-up.
  88.         -Changing the DAYLIGHT FLAG using ALT-F10+F1 or allowing the      
  89.         DAYLIGHT FLAG to be changed in the AUTO mode now automatically      
  90.         adjusts the UTC OFFSET to reflect the time change. In prior      
  91.         versions, the UTC OFFSET had to be manually changed using F10+F10      
  92.         every time the DAYLIGHT FLAG was changed.
  93.         -Repaired minor bug with INTERVAL TIMER. If the DAYLIGHT FLAG was      
  94.         changed while the timer was on, the timer was in error by one      
  95.         hour. The timer start time is now automatically adjusted if the      
  96.         DAYLIGHT FLAG is changed either manually or automatically.
  97.         -Modified Perpetual Calendar, Display Mode 6. When the calendar      
  98.         is displayed, pressing the digit 6 will toggle between the 
  99.         calendar display and a list of the holidays in that month. 
  100.         Several additional holidays plus the beginning and end of 
  101.         Daylight Savings time added. Corrected taxes due date so that it 
  102.         does not occur on Saturday or Sunday but on the following Monday.
  103.         -Adjusted DD/MM/YYYY date input error checking using F3 to 
  104.         properly check the day for each month (beginning with day 1) but 
  105.         to allow January 0 and December 32 to correspond with common 
  106.         usage and the Astronomical Almanac. Prior versions allowed the 
  107.         0th of any month and disallowed December 32.
  108.         -Corrected date input using F3 to agree with documentation such      
  109.         that using the form "+nnn" adds nnn days to the current Julian      
  110.         Date. Prior versions assumed absolute Julian Date if nnn was      
  111.         greater than 50 even if the "+" was included. Absolute Julian      
  112.         Date is now assumed only if nnn is greater than 400 AND the "+"      
  113.         sign is omitted.
  114.         -Corrected bug in external star catalog searches. If one of the      
  115.         nearby stars were selected instead of the nearest star, the      
  116.         program aborted with a "Bad file name or number" error. This was      
  117.    ASTROCLK Astronomical Clock and Celestial Tracking Program        Page 3
  118.         Program Revision History
  119.  
  120.         still another (but never reported) file handle error introduced      
  121.         at Version 9016!
  122.         -Corrected cosmetic problem with city file searches using F6.      
  123.         When the SPACE BAR was pressed to search for the next match, the      
  124.         prior city name was not cleared before next name was displayed.      
  125.         If the next city name was shorter than the previous city name,      
  126.         excess characters were "left over" on the display.
  127.         -Corrected minor bug in city file searches: if no city was 
  128.         accepted, elevation for the current location was reset to zero.
  129.         -Updated ASTROCLK.MPC to use the first 250 minor planets from      
  130.         file ELEM911.MPC (as of February 1991).
  131.         -File ASTROCLK.CTY corrected. "West Covina" was mispelled as      
  132.         "West Corina", and the coordinates for Sunnyvale, CA have been      
  133.         updated (per Mike Gardner). Added Greenwich Obs, England for      
  134.         easier checking of Greenwich-based data along with several other      
  135.         cities whose coordinates were sent in by users.
  136.         -Moved some code to new ASTROSB4.BAS SUB and FUNCTION source file      
  137.         to fix compiler memory overflow for main module. Added source      
  138.         file ASTROCLK.INC, an include file with DIM, COMMON and CONST      
  139.         statements used by all other source files.
  140.  
  141.         9050     12/14/90
  142.         -----------------
  143.         -Added UTC Day-of-Year to Display Mode 7 for years > 1949. This 
  144.         is the format used by NORAD with 2-line orbital elements, i.e. 
  145.         90247.451472. The first two digits are the year, then the day of 
  146.         the year, and the time is the fractional part of the day. This is 
  147.         the time/date format required by satellite tracking programs such 
  148.         as STSORBIT and TRAKSAT.
  149.         -Adjusted Delta-T and Delta-AT in accordance with revised data in 
  150.         the 1991 Astronomical Almanac and to take into account the Leap 
  151.         Second at the end of 1990. The change in Delta-T amounts to about 
  152.         0.2 seconds for 1989, 1990 and subsequent years.
  153.         -Changed .CTY file format to include elevation in meters. Do NOT 
  154.         use OLD .CTY files without editing each line to add ",0" (without 
  155.         the quotation marks) at the end for elevation. Or substitute the 
  156.         elevation in meters if known.
  157.         -Added feature to append new local coordinates entered with F6 to 
  158.         the current CITYFILE.
  159.         -Extensive revisions to the documentation to bring it up to date 
  160.         from Version 8947. This was such a chore that I will resume 
  161.         updating the documentation at every revision. It is likely that 
  162.         I've missed some corrections in this process; if in doubt, 
  163.         consult these notes.
  164.  
  165.         9027     07/06/90
  166.         -----------------
  167.         -This is a maintenance release to correct an error and change 
  168.         several time zone abbreviations and names.
  169.         -Corrected major error in reduction of star sights. If less than 
  170.         7 sights were entered, an array was not cleared and spurious data 
  171.         were included in the calculations. OOOPS! Except for minor 
  172.         differences in the fourth and following decimal places, the 
  173.         calculation results now agree with Version 8947 documentation 
  174.         again! Thanks to Ward Harman for finding and reporting this 
  175.    ASTROCLK Astronomical Clock and Celestial Tracking Program        Page 4
  176.         Program Revision History
  177.  
  178.         problem! 
  179.         -Changed UK time zones to GMT (Standard) and BST (Daylight, 
  180.         British Summer Time) to conform to standard usage. Added CET for 
  181.         CENTRAL EUROPEAN TIME @ UT+1 (no Daylight).
  182.         -The main documentation remains unchanged from Version 8947. The 
  183.         next major release of ASTROCLK, planned to occur about mid-Summer 
  184.         1990, will include revised documentation incorporating all 
  185.         changes since Version 8947.
  186.  
  187.         9019     05/08/90
  188.         -----------------
  189.         -Corrected problem which caused ASTROCLK to abort when certain 
  190.         external star catalog searches were requested (F5+F4 and F5+F5). 
  191.         Program reported Bad File Name or Number, Error #52 and returned 
  192.         to DOS. Problem was introduced at Version 9016 when all file 
  193.         handles were changed to variables in order to accomodate new F2 
  194.         enhancement, writing ephemeris to a file. [Missed one ... OOPS!]
  195.         -F2 ephemeris generation to a file now APPENDS data to existing 
  196.         file. If the specified file does not exist, it is created. Data 
  197.         for multiple targets may thus be written to a single file. To 
  198.         record data from the start of the output file, either give a new 
  199.         file name or erase the old file from DOS (use F9 to exit to DOS).
  200.         -Corrected a bug ("QuickBASIC Error, Overflow) which caused 
  201.         ASTROCLK to abort and return to DOS when orbit data was requested 
  202.         for Halley's Comet ("9"). Thanks to Steve Brewster for reporting 
  203.         this problem!
  204.         -When in Navigation Mode and speed is zero, the local coordinates 
  205.         window is no longer labeled "Calculated Position" but remains the 
  206.         original place name. Similarly, when speed is zero the Navigation 
  207.         Display ("N" key) will now show data relative to the current 
  208.         place name rather than "LAST NAVIGATION FIX" in the top portion 
  209.         of the window. Both changes reflect the fact that the user is 
  210.         stationary at a specified location; position calculations and 
  211.         navigation fixes are therefore not appropriate.
  212.         -Corrected minor cosmetic errors which erased right side of main 
  213.         window when entering degree information.
  214.         -Updated F2 help screen to include printer and file output.
  215.         -Updated F8 prompt screen to include day-of-year date format.
  216.         -The main documentation remains unchanged from Version 8947. The 
  217.         next major release of ASTROCLK, planned to occur about mid-Summer 
  218.         1990, will include revised documentation incorporating all 
  219.         changes since Version 8947.
  220.  
  221.         9016     04/15/90
  222.         -----------------
  223.         -Changed ephemeris format to UTC date and time rather than local.
  224.         -Added ephemeris epoch/equinox selection: Equinox of Date OR the 
  225.         current internal Standard Epoch (set using F8).
  226.         -Added PRINT OPTION to F2 Ephemeris Generation. Printer output is 
  227.         sent to the DOS device "PRN". Be sure printer is ready BEFORE
  228.         selecting it for output. Titles plus 55 lines of data are sent 
  229.         per page with auto formfeeds between pages and at the end. Note 
  230.         that "graphics characters" are included in the data lines; if 
  231.         these characters are not wanted, use FILE OPTION and edit out the 
  232.         unwanted characters.
  233.    ASTROCLK Astronomical Clock and Celestial Tracking Program        Page 5
  234.         Program Revision History
  235.  
  236.         -Added FILE OPTION to F2 Ephemeris Generation. Data are identical 
  237.         to PRINT OPTION above except are sent to file. Enter complete 
  238.         file name when requested; default file is ASTROCLK.EPH located in 
  239.         ASTROCLK path.
  240.         -Corrected time calculations for Minor Planets to avoid adding 
  241.         the correction for UTC to TDT/ET twice.
  242.         -Updated file ASTROCLK.MPC with osculating elements as of 1989 
  243.         OCT 1.0. Data taken from file ELEM892.MPC.
  244.         -Since Minor Planet elements are often published [in Sky and 
  245.         Telescope, for example] with T (Time of Perihelion) rather than M 
  246.         (Mean Anomaly), manual data entry now requests the user to select 
  247.         M or T and enter the desired value. For T, use the format:
  248.              DD[.DDD],MM,YYYY
  249.         When the input data are displayed for acceptance, only M is 
  250.         displayed; if T was entered, it has been converted to M. If T is 
  251.         input, then the program requests q (Perihelion Distance) instead 
  252.         of a (Semi-Major Axis).
  253.         -Calculation of minor planet perihelion changed to date nearest 
  254.         the date of the osculating elements. Thus for reasonably current 
  255.         elements and if the minor planet is more than half way around in 
  256.         its orbit, the perihelion date may be in the future.
  257.         -Reworked manual data reentry ("Z") for Minor Planets to show 
  258.         prior data of osculating elements if present (from previous 
  259.         manual entry or from "X" catalog entry).
  260.         -Minor cosmetic changes to Precession screens for clarity.
  261.         -The main documentation remains unchanged from Version 8947.
  262.  
  263.         9014     04/02/90
  264.         -----------------
  265.         -Corrected a significant error in Minor Planet positions when 
  266.         data are read from Minor Planet Catalog ELEM891.MPC (Epoch 
  267.         B1950.0). For example, Mean Anomaly might be in error by as much 
  268.         as 0.5 degrees. The error was less serious when current data were 
  269.         used. Using ELEM891.MPC, ASTROCLK's J2000.0 calculated positions 
  270.         now agree with AA 1989 to typically less than five seconds or 
  271.         arcseconds. Thanks to Ward Harman for many hours of patient 
  272.         analysis which enabled us to pin down the problem.
  273.         -Changed minor planet calculations to make sure all calculations 
  274.         performed regardless of display mode. Under certain circumstances 
  275.         the equatorial coordinates (RA/DEC) were incorrect in Mode 0.
  276.         -Added "prior value" code to manual orbital data input ("Z" after 
  277.         "P" Planet Selection). Input routines modified to accept the 
  278.         usual formats for angles:
  279.              DDD[.DDD]
  280.              DDD,MM[.MMM]
  281.              DDD,MM,SS[.SSS]
  282.         Once data are entered, the values are retained and displayed on 
  283.         subsequent "Z" inputs. Press RETURN to leave an entry unchanged. 
  284.         The manually entered data are discarded when you exit ASTROCLK.
  285.         -Added "/" as a valid separator for date inputs. Dates may now be 
  286.         input as "dd/mm/yyyy" or "dd,mm,yyyy".
  287.         -Minor cosmetic changes in Minor Planet displays.
  288.         -The main documentation remains unchanged from Version 8947.
  289.  
  290.  
  291.    ASTROCLK Astronomical Clock and Celestial Tracking Program        Page 6
  292.         Program Revision History
  293.  
  294.         9012     03/21/90
  295.         -----------------
  296.         -Versions 9007 and 9010 were limited beta releases. This is the 
  297.         first public release since Version 8951. The main documentation, 
  298.         files ASTROCLK.DC1 and ASTROCLK.DC2, remains unchanged from 
  299.         Version 8947. All subsequent changes are described in these notes 
  300.         ONLY!
  301.         -Corrected color error on large digit navigation position.
  302.  
  303.         9010     03/08/90
  304.         -----------------
  305.         -Added "Zone x", where "x" represents the standard international 
  306.         time zone letter, to the local clock title (Display Mode 1). Zone 
  307.         Z is Greenwich, Zones A thru M are East Longitudes, and Zones N 
  308.         thru X are West Longitudes.
  309.         -Repaired error which could cause program to hang if navigation 
  310.         is active and the key sequence F10+F2+F10 is entered to cancel 
  311.         navigation.
  312.         -Corrected nautical mile conversion factor to 6080.2 feet.
  313.  
  314.         9007     02/12/90
  315.         -----------------
  316.         -Version 9007 is a MAINTENANCE UPDATE in order to improve various 
  317.         navigation features and to correct several minor errors. The 
  318.         changes are described below and NOT in the main documentation 
  319.         which is unchanged from Version 8947.
  320.         -Special thanks to Captain Helge Brudvik of the Royal Viking Sky 
  321.         for the freedom of the bridge, and to Chief Officer Magnus Bakken 
  322.         for his practical demonstrations of navigation at sea (as well as 
  323.         many hours of pleasant conversation). The changes in this version 
  324.         have been made during a cruise around South America and reflect 
  325.         what I have learned and observed during that ten week period.
  326.         -Added large digit display for calculated position in navigation 
  327.         mode; press "N" to toggle navigation displays.
  328.         -Number of star sights which may be entered for navigation fix 
  329.         increased from three to seven maximum to conform with Air 
  330.         Almanac. When last star sight entered, press RETURN to stop data 
  331.         entry.
  332.         -Added DRIFT and DIRECTION to navigation to permit correction for 
  333.         combined wind and current effects. Enter using F10+F2.
  334.         -Corrected UT Time entry in F10+F2 Navigation Fix entry so that 
  335.         RETURN leaves time unchanged rather than resetting it to zero.
  336.         -Conversion factor for nautical miles corrected to 6082 feet.
  337.         -Suppressed "Federal/State Taxes Due" message on calendar for 
  338.         Easter Sunday on April 15th.
  339.         -Minor cosmetic changes in navigation functions.
  340.  
  341.         8951     12/21/89
  342.         -----------------
  343.         -Version 8951 is a MAINTENANCE UPDATE in order to correct various 
  344.         minor errors. The changes are described below and NOT in the main 
  345.         documentation.
  346.         -By popular request, the documentation is UNCHANGED from Version 
  347.         8947. The documentation will remain unchanged until the next 
  348.         major revision so the full documentation need not be reprinted 
  349.    ASTROCLK Astronomical Clock and Celestial Tracking Program        Page 7
  350.         Program Revision History
  351.  
  352.         for minor upgrades in the program. All changes are documented in 
  353.         files ASTROCLK.HST and ASTROCLK.NEW only.
  354.         -The default responses (pressing RETURN/ENTER only) when using F6 
  355.         and SHIFT-F6 to enter new LOCAL or DESTINATION coordinates were 
  356.         incorrect and reset the new value instead of using the prior 
  357.         value. The prompts have been improved and the logic has been 
  358.         repaired. Note that the ELEVATION is now left UNCHANGED as the 
  359.         default response. Thanks to Bob Khron for the bug report!
  360.         -SHIFT-F6 may now be used to review the DESTINATION coordinates 
  361.         and name. Press RETURN to leave all data unchanged.
  362.         -When navigation is active and SPEED is non-zero, the calculated 
  363.         position window includes the date and time of the last navigation 
  364.         fix: "Fix @ 12-11-1989 15:30 UT" to remind the user when the last 
  365.         fix was entered or calculated.
  366.         -Dead reckoning positions were calculated one second behind the 
  367.         current time when the clocks were ON. I sure hope nobody crashed 
  368.         on account of that one!
  369.         -Added Leap Second at end of 1989 to Delta AT table.
  370.  
  371.         8947     11/19/89   
  372.         -----------------
  373.         -Improved Apparent Geocentric Equatorial Coordinates for internal 
  374.         database stars and catalog stars, mean to apparent position, to 
  375.         include effects of nutation and annual aberration. Parallax NOT 
  376.         included. Apparent coordinates are now accurate to within one 
  377.         second/arc-second.
  378.         -Added navigation function F5 to show first 20 USNO stars in view 
  379.         and suitable for star sights. Uses current coordinates and time.
  380.         -Revised external star catalog logic. Search times halved and 
  381.         direct access by catalog number is now immediate.
  382.         -Expanded external star catalog searches F5+F4 and F5+F5 to show 
  383.         list of 10 stars nearest the coordinates input.
  384.         -Repaired SUB Refract to give correct answer when converting 
  385.         apparent to real altitudes and adjusted the navigation example 
  386.         data accordingly. Real to apparent was OK.
  387.         -Fixed horizon dip calculation (misplaced decimal point in a 
  388.         constant).
  389.         -Added SHIFT-F6 for entry of DESTINATION data using external city 
  390.         file and updated HELP.
  391.         -Added '/' prefix to F6 and SHIFT-F6 city name input to allow 
  392.         match within name.
  393.         -Improved degree input routine for small negative angles; now 
  394.         processes both "-0,26" and "0,-26" correctly. A minus sign 
  395.         anywhere flags a negative angle.
  396.         -Fixed "Division by Zero" error in navigation mode when speed was 
  397.         set to zero.
  398.         -Corrected Planetary Heliocentric Longitude to remove multiples 
  399.         of 360 degrees.
  400.         -Corrected USNO coordinates per AA 1989.
  401.         -Corrected paging problem with ephemeris if more than 40 
  402.         intervals requested.
  403.         -ASTROCLK.INI now always written on exit.
  404.         -Reformatted these notes to use a little less paper ...
  405.  
  406.  
  407.    ASTROCLK Astronomical Clock and Celestial Tracking Program        Page 8
  408.         Program Revision History
  409.  
  410.         ---------------------------------------------------------------
  411.         8806 thru 8943      NOTE: Intermediate revision notes have been
  412.                                   deleted here to save file space.
  413.         ---------------------------------------------------------------
  414.  
  415.         8805      1/24/88   -Initial Release
  416.