home *** CD-ROM | disk | FTP | other *** search
/ The Starbase One Astronomy & Space Collection / STARBASE_ONE.ISO / a96 / disk15 / sisky.exe / READ.ME < prev    next >
Encoding:
Text File  |  1990-01-10  |  17.3 KB  |  362 lines

  1.  
  2.  
  3.  
  4.                                   SILICON SKY
  5.                                   Version 2.6
  6.                                               
  7.                                  Larry Adkins
  8.  
  9.  
  10.  
  11.          I. Introduction
  12.  
  13.          SILICON SKY is an interactive astronomy program which 
  14.          displays a quite realistic representation of the sky as 
  15.          seen from any latitude on earth for any date and looking in 
  16.          any direction.  The program will display the location of the 
  17.          sun, moon and planets and will show the correct phase of the 
  18.          moon.  Finally, it identifies the constellations visible on 
  19.          the screen by marking out their boundaries.  It is most 
  20.          impressive with an EGA graphics system, but it can be 
  21.          configured for CGA using the Setup initialization program. 
  22.          Instructions for use are given in the following sections. 
  23.              
  24.          This version (2.6) is the third release of the program.  The 
  25.          main new feature beyond version 2.0 is the addition of 
  26.          graphic displays of the five naked eye planets.  Here you can 
  27.          see the phases of Mercury and Venus, the surface markings on 
  28.          Mars, the satellites of Jupiter, and the orientation of 
  29.          Saturn's rings.  The data accompanying the graphics give rise 
  30.          and set times, the distance of the planets from the earth and 
  31.          the apparent size of the planets. 
  32.         
  33.               
  34.          II. Setup and Initialization
  35.               
  36.               SILICON SKY should work on any IBM or IBM compatible 
  37.          with either a color graphics (CGA) or an enhanced graphics 
  38.          (EGA) adaptor card.  However, you must first do two things:
  39.  
  40.               (1) Un-archive the main program (SKY.EXE), and
  41.               (2) Customize the program for your locality
  42.          
  43.               The main program has been archived into the file
  44.          named SKY.EXE so that all necessary files will fit on one
  45.          360K disk.  The main program can be extracted simply by typing
  46.          "SKY" and hitting return.  However, the reason for archiving
  47.          in the first place is because everything will not fit on the
  48.          disk.  Thus the program must be copied either to a hard disk,
  49.          a high density floppy, or some non-critical files must be deleted
  50.          from the 360K disk.  The following procedures are recommended:
  51.  
  52.             FIRST: MAKE A BACKUP OF THE ORIGINAL AND STORE IT IN A SAFE
  53.                    PLACE
  54.  
  55.               IF YOU HAVE A HARD DISK:
  56.                  1.  Make a directory  (MD SISKY) and copy the contents
  57.                      of the disk into this directory.
  58.                  2.  Go to the directory, type "SKY" and hit return.
  59.                  3.  This extracts the main program file named "SISKY.EXE"
  60.                      and the program is ready to run either by typing
  61.                      "SISKY" RETURN or "GO" RETURN.
  62.  
  63.               IF YOU ARE RUNNING FROM 360K FLOPPIES:
  64.                  1.  Copy SKY.EXE, SETUP.EXE, and READ.ME onto a fresh 
  65.                      disk.
  66.                  2.  Go to the new disk, type "SKY" and hit RETURN.  This
  67.                      will extract the main program file SISKY.EXE and
  68.                      place it on the new disk.
  69.                  3.  Delete SKY.EXE, READ.ME and SETUP.EXE from the OLD
  70.                      disk.
  71.                  4.  Copy SISKY.EXE from the NEW disk to the OLD disk
  72.                      (the disk will now hold SISKY.EXE since sufficient
  73.                       space has been made available by deleting the files
  74.                       listed above.)
  75.  
  76.                 Of course, if you have a 1.2M or 1.4M floppy drive, you can
  77.                 simply copy everything from the original disk onto the
  78.                 larger capacity disk, execute SKY, and you are ready to go.
  79.          
  80.                After completing the procedures outlined above SILICON SKY
  81.          is ready to run using default parameters (observing site, etc.).
  82.          SILICON SKY can be customized for your locality by running the
  83.          initialization program SETUP.  Simply type "SETUP" and hit return.
  84.          You will be asked whether you have an EGA or CGA graphics 
  85.          card, the name of your default observing site (up to 30 
  86.          letters), the latitude of your default observing site, the 
  87.          time zone of the default observing site, and whether or not 
  88.          you want to hear a "BEEP" after the display is complete.  The
  89.          beep lets you know that all calculations have been completed.
  90.          Try it first with the beep.  If you find it annoying simply 
  91.          re-run "SETUP" and turn it off. 
  92.  
  93.          The disk is released with the following defaults:
  94.            
  95.             Graphics Card:          EGA
  96.             Default Observing Site: SOUTHERN CALIFORNIA
  97.             Default Latitude:       34 degrees
  98.             Time Zone:              8 (PST)
  99.             Beep:                   Yes  
  100.          
  101.          FOR FLOPPY USERS:
  102.             If you have followed the procedure suggested above, 
  103.          SETUP.EXE is on disk number two.  Run SETUP from this disk and
  104.          it will generate a file named "SISKY87.CLR".  Copy this file 
  105.          onto the main program disk.
  106.  
  107.          NOTE:  Version 2.6 will automatically detect whether or 
  108.          not you have a math coprocessor chip and will take advantage 
  109.          of it if such a chip is present.  If a coprocessor is not 
  110.          present the program will run at standard speed.
  111.  
  112.  
  113.          III. Running SILICON SKY
  114.               
  115.          To run SILICON SKY simply type "GO"  and hit the return.  You 
  116.          will see a screen with the SILICON SKY logo and the  words 
  117.          "HIT ANY KEY TO CONTINUE"; after following these 
  118.          instructions, the words "STAR DATA LOADING" will appear.  
  119.          This will take from 15 seconds to 30 seconds, depending on 
  120.          whether you are loading from a hard disk or a floppy 
  121.          (floppies take longer).  Note: the program reads information 
  122.          from the disk from time to time during execution; therefore, 
  123.          the disk must remain in the drive (or be on a hard disk) 
  124.          while the program is running. 
  125.             
  126.  
  127.                                  MODE SELECTION 
  128.  
  129.               After the star data has been loaded you will be offered 
  130.          two options:
  131.  
  132.                  1. SKY FOR A SPECIFIC DATE 
  133.                  2. PERIODIC UPDATES AT SPECIFIED
  134.                     TIME INTERVALS 
  135.               
  136.               If you select the first option, one screen will be 
  137.          displayed for the particular date and time you specify. To 
  138.          see another date and time you will have to enter new data.  
  139.          The PERIODIC mode, on the other hand,  will display a 
  140.          sequence of screens at an interval you select, beginning with 
  141.          a specified date and time.  If you are running the program 
  142.          for the first time, I would suggest starting with option 1. 
  143.  
  144.                                LATITUDE SELECTION 
  145.               
  146.               The next option is latitude.  Two options are available 
  147.          here, the default location selected during initialization or 
  148.          some other latitude. Any other latitude on Earth will work 
  149.          from -90 to +90. If a latitude other than the default has 
  150.          been selected, you will need to hit the enter key after 
  151.          typing in the numbers. 
  152.  
  153.                             DIRECTION OF OBSERVATION 
  154.  
  155.               The next screen prompts for direction of observation - 
  156.          north, south, east, or west.  After one direction has been 
  157.          selected, you will be prompted for date and time data.  If 
  158.          a latitude other than the default has been selected the 
  159.          program will prompt you for a time zone from -12 to +12 
  160.          (Greenwich is 0). 
  161.  
  162.                                  TIME FUNCTIONS
  163.  
  164.                Finally, the program asks for observing time - year, 
  165.           month, day and hour.  Remember to input the month as a 
  166.           number and the hour as a number from 0 to 24.  If you are at 
  167.           any latitude other than the default you will be asked for  
  168.           the time zone. 
  169.  
  170.                                PROGRAM EXECUTION 
  171.               
  172.               The sky will now be plotted on the screen.  When the 
  173.          plotting is finished there will be a line at the bottom 
  174.          representing the horizon and curved lines at the top 
  175.          representing the top of the celestial sphere.  The display is 
  176.          roughly the field of vision the average person would have 
  177.          looking at the horizon.
  178.          
  179.               How long this takes will depend on your system.  A 
  180.          "plain vanilla" IBM PC without a math coprocessor will take 
  181.          about 20 seconds to paint the stars on the screen for most 
  182.          horizons.  It will take an additional minute or so for the 
  183.          program to examine all of the stars in the data file.  Thus, 
  184.          after the program begins to run it will be about one minute 
  185.          and 20 seconds before it  is ready to accept new 
  186.          instructions. 
  187.  
  188.               If you have a math coprocessor or an AT the execution 
  189.          time reduces to a mere seven seconds! 
  190.  
  191.                                    SCREEN MENU 
  192.               
  193.               After the stars have been plotted, a menu will appear at 
  194.          the bottom of the screen.  Any option on the menu can be 
  195.          accessed simply by pressing the appropriate number.  For 
  196.          example, first option simply removes the menu.  Thus, 
  197.          pressing "1" will result in an unadorned display of the sky. 
  198.               
  199.           ----THE MENU CAN ALWAYS BE RE-ACCESSED BY PRESSING----
  200.                         ---- THE "ESC" KEY ----
  201.  
  202.               The options and their functions are as follows:
  203.               
  204.                   1. REMOVE MENU:  Shows sky without menu.
  205.                   
  206.                   2. OPTIONS: Input new data (latitude, date, 
  207.                      viewpoint.      
  208.  
  209.                   3. SOLAR DATA: Displays coordinates of sun, 
  210.                      moon and planets along with date and time 
  211.                      data. 
  212.  
  213.                   4. CONSTELLATIONS: Displays constellations 
  214.                      visible in the CENTRAL AREA of the 
  215.                      screen.  The selection of a particular 
  216.                      constellation will plot its boundaries 
  217.                      on the display, along with its name.  
  218.                      The name can be toggled off with the F1
  219.                      function key.
  220.                   
  221.                   5. PLANETS: Identifies solar system objects.  
  222.                      The sun and moon are labeled.  Planets 
  223.                      are identified by a circle drawn around 
  224.                      them. 
  225.  
  226.                   6. SCROLL: This feature allows you to scroll 
  227.                      around the celestial sphere.  Pressing 
  228.                      the appropriate arrow allows you to 
  229.                      scroll 360 degrees around the horizon or 
  230.                      up from the horizon to overhead. 
  231.  
  232.                   7. SOLAR SYSTEM: This gives a menu for selecting
  233.                      graphic representations of the moon and bright
  234.                      planets.  These are described in more detail
  235.                      in section IV.
  236.                   
  237.                   9. RETURN TO DOS: Terminates the program. 
  238.  
  239.  
  240.         IV.  Solar System Display (Selection 7)
  241.  
  242.              1. MOON: The MOON selection will display the moon in 
  243.              proper phase with the major mares and craters marked.  
  244.              For this display NORTH IS AT THE TOP, SOUTH AT THE 
  245.              BOTTOM, EAST TO THE RIGHT AND WEST TO THE LEFT.  In other 
  246.              words, in the same orientation that it appears to the eye 
  247.              in most northern latitudes.
  248.         
  249.              The data panel below the graphic shows RISE  and SET 
  250.              times (in local standard time), the PHASE (% of the 
  251.              surface illuminated) and the position angle of the bright 
  252.              LIMB in degrees.  This position angle is defined as the 
  253.              counter clockwise angle between the terminator (line 
  254.              between bright and dark) and the east-west line 
  255.              bisecting the moon.
  256.  
  257.              NOTE: The algorithum used to calculate the rise and set 
  258.              times for the moon gives only approximate values.  The 
  259.              times are usually correct to within 20 minutes or so, but 
  260.              can be off as much as an hour. 
  261.          
  262.  
  263.  
  264.         
  265.              2. MERCURY AND VENUS: Selecting 2 or 3 from the Solar 
  266.              System menu will give, respectively, a graphic of either 
  267.              Mercury or Venus, showing the phase of the planet.  Here, 
  268.              as in all planet graphics, SOUTH IS AT THE TOP, NORTH AT 
  269.              THE BOTTOM, WEST AT THE RIGHT AND EAST AT THE LEFT.  This 
  270.              is the view through an inverting telescope in northern 
  271.              latitudes.
  272.         
  273.              The data panel below shows RISE and SET times, the 
  274.              DISTANCE of the planet from Earth in astronomical units 
  275.              (AUs, where 1 AU = 93,000,000 miles), the apparent SIZE 
  276.              of the planet in seconds of arc, the PHASE (% 
  277.              illuminated) of the planet, and its MAGNITUDE.  These 
  278.              data are given in all planetary data panels.  For Mercury 
  279.              and Venus the final two items in the data panel are the 
  280.              planet's right ascension (RA) and declination (DEC).  For 
  281.              CGA systems, only RISE, SET, DISTANCE and SIZE are 
  282.              displayed. 
  283.         
  284.              3. MARS: The Mars graphic shows markings on Mars as would 
  285.              be seen through a telescope at the time and date 
  286.              selected.  Pressing function key F1 will display the 
  287.              latitude and longitude grid.   The latitude lines are 
  288.              spaced 15 degrees apart, while the latitude lines are 
  289.              separated by 20 degrees.  Any point on the visible face 
  290.              can be specified by latitude and longitude by noting the 
  291.              MERIDIAN (longitude line at the center of the disk, 
  292.              specified in the EGA data panel) and adding 15 degrees 
  293.              going right or subtracting 15 degrees per line going 
  294.              left. 
  295.            
  296.              4. JUPITER: The highlight of Jupiter is its satellite 
  297.              system.  The field of view of the initial the window 
  298.              display may not be wide enough to show all of the 
  299.              satellites, so four different magnifications can be 
  300.              accessed by successive pressings of function F1.  For EGA 
  301.              systems, the satellites are color coded and can be 
  302.              identified by pressing function key F2.
  303.         
  304.              5. SATURN: The graphic here shows the orientation of 
  305.              Saturn's rings (South at the top, as with all of the 
  306.              planetary displays).  From Earth the rings are seen at 
  307.              varying angles of openness which depend on the location 
  308.              of the planet in its orbit.  The rings appear edge on 
  309.              (and, hence, invisible in small telescopes) with a two 
  310.              cycle periodicity (i.e., there will be alternate 15.75 or 
  311.              13.75 years intervals between edge on appearances).  For 
  312.              example, the rings displayed maximum northern exposure in 
  313.              1987, while they were edge on in 1966 and 1980 and will 
  314.              be again in 1996. 
  315.             
  316.  
  317.         V. Updates 
  318.              
  319.              This program is being distributed as shareware, and it is 
  320.         requested that you register your copy by sending $10.00 to the 
  321.         address below.  Payment of the registration fee will entitle 
  322.         you to the next upgrade.  I am planning to add the following 
  323.         functions at some future date:
  324.              
  325.              -- Coordinates
  326.              -- Deep Sky Objects
  327.              -- Milky Way Boundaries
  328.              -- A more detailed manual
  329.  
  330.  
  331.              
  332.         Please send registration fee to :
  333.          
  334.              Larry Adkins
  335.              17652 Wellington Ave.
  336.              Tustin, CA 92680
  337.                
  338.               
  339.                  
  340.               
  341.                                 ACKNOWLEDGEMENTS
  342.              
  343.              The stellar database for Silicon Sky derives ultimately 
  344.          from the Yale Bright Star Catalog;  the stars selected are 
  345.          basically the same as those given in Richard Berry's 
  346.          Stars.Bas program (Astronomy magazine, August, 1985).  The 
  347.          calculations for planetary positions, phases, rise and set 
  348.          times, and for the satellites of Jupiter are based on 
  349.          formulae given in a 1979 paper "Low-Precision Formulae for 
  350.          Planetary Positions" by Van Flandern and Pulkkinen, 
  351.          "Practical Astronomy with Your Calculator" by Peter Duffett-
  352.          Smith, and "Astronomical Formulae for Calculators" by Jean 
  353.          Meeus.  The constellation boundary data was digitized from 
  354.          the "Sky Atlas 2000" by Will Tirion.             
  355.               
  356.                 
  357.                 
  358.         
  359.                
  360.  
  361.  
  362.