home *** CD-ROM | disk | FTP | other *** search
/ The Starbase One Astronomy & Space Collection / STARBASE_ONE.ISO / a94 / disk08 / skyd.exe / SKY.DOC < prev    next >
Text File  |  1992-07-12  |  17KB  |  354 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.                         SKY Planetarium for DOS V2.2
  16.                (C) COPYRIGHT 1989-1992, Howard J. Dutton 3rd
  17.  
  18.        ABOUT THE PROGRAM                                                 Page 1
  19.  
  20.  
  21.          This is SKY Planetarium for DOS, a planetarium simulator written
  22.        in Turbo Pascal.  To run SKY you'll need 512k memory and CGA, EGA,
  23.        or VGA graphics.  Not needed, but supported are:  mice, 8087s (with
  24.        registration), and various printers.
  25.  
  26.          "Sky" allows you to view a map of the sky as seen from any place
  27.        on Earth.  You have the option of adding constellation lines,
  28.        telescopic objects, coordinate grid work, object names, etc. to the
  29.        map (which always includes the sun, moon, and planets).  After a map
  30.        is plotted to the screen, you may use your mouse (if you have one) to
  31.        set the map center, or get an object description.  The right button
  32.        sets the center of the map and the left button gives you a description
  33.        of what lies under the pointer.  A more detailed description of how
  34.        to use SKY starts on page 3.
  35.  
  36.  
  37.        SETTING IT UP                                                     Page 2
  38.  
  39.  
  40.  
  41.        RUN the install program: SKYINST
  42.  
  43.        1.  Set up the display-
  44.          Your display adapter is auto-detected but for added versatility:
  45.  
  46.          <L>OW   for  VGA 640X350 / EGA 640X200 / MCGA 640X200  / CGA 640X200
  47.          <H>IGH  for  VGA 640X480 / EGA 640X350 / MCGA 640X480  / CGA 640X200
  48.  
  49.          <M>onochrome for B/W monitors
  50.          <C>olor      for Color monitors
  51.  
  52.          NOTE:  If you have an EGA card with a CGA monitor (low res.
  53.          color: like my system) set this to <L>OW!
  54.  
  55.  
  56.        2.  Select a printer type compatible with your printer-
  57.  
  58.          EPSON       (or IBM Graphic)        PANASONIC   (KXP1124)
  59.          CITIZEN     (MSP10/15/20/25)        HPTHINK     (HP Think Jet)
  60.  
  61.          For better quality print-outs use the High/Low res. printer
  62.          toggle (the <R> key)
  63.  
  64.  
  65.        1.  Set the start time-
  66.          This is the time that SKY starts with.  It's in 24 hour format and
  67.          may be over 24 (ex. a time after midnight: 25.5 means 1:30am )
  68.  
  69.        2.  Change the <O>bserver locations to where you are.  Latitude is
  70.          in degrees +90(north) to -90(south), Longitude is also measured in
  71.          degrees but ranges from +180(west) to -180(east).  You don't really
  72.          need to be pin-point accurate with your location, getting it from
  73.          an atlas or globe is fine.  The time zone should be -5 for EST,
  74.          -6 for CST,  -7 for MST, or -8 for PST.  If you want your times
  75.          adjusted for daylight savings time add an additional hour to your
  76.          zone adjustment (-5+1=-4 for EDT).
  77.  
  78.  
  79.        COMMAND DESCRIPTIONS                                              Page 3
  80.  
  81.        NOTE: you may press <ESC> at any time to abort a command sequence.
  82.  
  83.        <D>ate -
  84.          This option changes the date of the next plot.
  85.  
  86.        <T>ime -
  87.          This option changes the time of the next plot.
  88.  
  89.        <O>bservers location -
  90.          This option changes the earthly location of the observation.
  91.  
  92.        <A>bbreviations -
  93.          Toggles constellation abbreviations on and off.  At scales of
  94.          3X and greater the names of the planets, Moon, and Sun will
  95.          also be included.  Also, a complete listing of constellations
  96.          and their abbreviations is included in a table at the end of
  97.          this document.
  98.  
  99.        <L>ines -
  100.          Toggles display of constellation lines on and off.
  101.  
  102.        <N>GC -
  103.          Toggles symbolic display of NGCs (and Messier objects).  In MSO
  104.          mode SKY displays only objects in the Messier catalog.  In NGC mode
  105.          SKY displays a small subset of the New General Catalog of celestial
  106.          objects.  Most of these objects are visible only through telescopes
  107.          & binoculars, but a few are visible without optical aid. (like the
  108.          Andromeda galaxy, double cluster in Perseus, Beehive in Cancer, etc.)
  109.  
  110.        <G>rid work -
  111.          Toggles the display of celestial grid.  This "grid" represents
  112.          the lines of Right Ascension and Declination:  Right Ascension is
  113.          measured in Hours, Minutes, and seconds (just like a 24 hour clock).
  114.          Declination is measured in Degrees, Minutes, and seconds (it ranges
  115.          from 0 to 360, each degree is subdivided into 60 minutes, and each
  116.          minute is subdivided into 60 seconds).  Note that in this program
  117.          I've left out the 'seconds' - that level of accuracy is not needed
  118.          in this type of application.  Also drawn with the Grid, as a dotted
  119.          line, is the Ecliptic.  This is the path which the sun, moon, and
  120.          planets follow in the sky.
  121.  
  122.        <M>agnitude -
  123.          This sets the 'dimness' limit for the stars:  the greater the
  124.          magnitude the dimmer the stars (star magnitudes range from -1 to 7).
  125.          This limit effects only stars (not NGC objects).
  126.  
  127.        <S>cale -
  128.          Scale sets the magnification of the map, it ranges from 0.5X up to
  129.          999.99X.
  130.  
  131.        COMMAND DESCRIPTIONS                                              Page 4
  132.  
  133.  
  134.        <C>enter -
  135.          This option sets the center of the map.  You may choose to center
  136.          on the zenith (straight up), the equatorial coordinates (a right
  137.          ascension and declination - see <G>rid), or an object.  The object
  138.          option allows you to center the screen on a star (by it's name),
  139.          a constellation (by it's abbreviation), a planet (by the first
  140.          three letters of it's name), a NGC object (by it's number), or a
  141.          Messier object (by it's number).  SKY will also search the NGC
  142.          database by matching words.  For example, to find the Andromeda
  143.          galaxy you simply select the <W>ord option and type 'and'.  Then
  144.          SKY will show you, one by one, the objects in the database that
  145.          have a description with the word you typed in.
  146.  
  147.        <K>ey -
  148.          This option displays a 'KEY' to the map:  it shows the symbols
  149.          for the NGC objects and a compass.  The compass arrow points
  150.          north (the bottom of the compass shows which way to face to see
  151.          what's on the screen in the real sky).
  152.  
  153.        <P>lot -
  154.          This option causes the map to be displayed (or re-displayed).
  155.          If your computer is a slower one (none 8087) you will want to keep
  156.          the options (<L>ines,<N>GC,<G>rid) off and set <M>agnitude to
  157.          a lower value (like 4 or 5) until you get the map centered and
  158.          magnified.  Then turn on the options you want, set the magnitude
  159.          to a higher number (if you like), and make the map with p<R>int
  160.          or <P>lot.
  161.  
  162.        p<R>int -
  163.          This option causes the map to be printed.  When printing a map
  164.          you are first asked (if <N>GC is set to ON) if you want a listing
  165.          of the objects which are plotted on the map.  If you select this,
  166.          option the listing will be printed following the map.  You are then
  167.          asked if you want <H>orizon or <E>quatorial orientation. Horizon
  168.          orientation is the default (it's the same as on-screen plots).
  169.          Equatorial, if selected prints the map in one of two projections.
  170.          If the center of the between +/-35 degrees Declination, then a
  171.          Cylindrical projection is used.  Outside of the +/-35 degrees a
  172.          Conic projection is used.  This option is useful when printing star
  173.          charts for use with an Equatorially mounted telescope.  And last,
  174.          you are asked for the type of the map.  This allows you to make
  175.          finder charts (for telescopes) which are exactly like what you see
  176.          in the eyepiece.  'Normal' prints a map which is exactly like what
  177.          is in the sky (Newtonian reflectors have a normal image), 'Mirrored'
  178.          maps are flipped left-right (as in Refractors and Cassegrains with
  179.          diagonals), 'Mirrored and Inverted' are flipped both ways (as in
  180.          Refractors and Cassegrains without diagonals).
  181.          ALSO:  When SKY prints a map it uses the current settings
  182.          NOT the image on the screen:  you may make one <P>lot, then center
  183.          and magnify various areas of the map (with the mouse and/or KB) and
  184.          p<R>int the magnified areas from the map on the screen.
  185.  
  186.        <Q>uit -
  187.          Exits SKY.
  188.  
  189.        MISC. TABLES                                                      Page 5
  190.  
  191.  
  192.          "CL" (CLASS) Summary for objects listed under SKY map print-outs.
  193.        +----------------------+----------------------+----------------------+
  194.        | SG= Spiral Galaxy    | DN= Diffuse Nebula   | OC= Open Cluster     |
  195.        | EG= Elliptical Galaxy| PN= Planetary Nebula | GC= Globular Cluster |
  196.        | IG= Irregular Galaxy | DN= Dark Nebula      | DS= Double Star      |
  197.        |                      |                      | QS= Quasar           |
  198.        +----------------------+----------------------+----------------------+
  199.  
  200.  
  201.                              CONSTALLATION ABVERRATIONS
  202.        +----------------------+----------------------+----------------------+
  203.        | ABV.  NAME           | ABV.  NAME           | ABV.  NAME           |
  204.        +----------------------+----------------------+----------------------|
  205.        | And   Andromeda      | Cyg   Cygnus         | Pab   Pabo           |
  206.        | Ant   Antila         | Del   Delphinus      | Peg   Pegasus        |
  207.        | Aps   Apus           | Dor   Dordo          | Per   Perseus        |
  208.        | Aqr   Aquarius       | Dra   Draco          | Phe   Phoenix        |
  209.        | Aql   Aquila         | Equ   Equuleus       | Pic   Pictor         |
  210.        | Ara   Ara            | Eri   Eridanus       | Psc   Pisces         |
  211.        | Ari   Aries          | For   Fornax         | PsA     "  Austrinus |
  212.        | Aur   Auriga         | Gem   Gemini         | Pup   Puppis         |
  213.        | Boo   Bootes         | Gru   Grus           | Pyx   Pyxis          |
  214.        | Cae   Caelum         | Her   Hercules       | Ret   Reticulum      |
  215.        | Cam   Camelopardalis | Hor   Horologium     | Sge   Sagitta        |
  216.        | Cnc   Cancer         | Hya   Hydra          | Sgr   Sagittarius    |
  217.        | CVn   Canes Venatici | Hyi   Hydrus         | Sco   Scorpius       |
  218.        | CMa   Canis Major    | Ind   Indus          | Scl   Sculptor       |
  219.        | CMi   Canis Minor    | Lac   Lacerta        | Sct   Scutum         |
  220.        | Cap   Capricornus    | Leo   Leo            | Ser   Serpens        |
  221.        | Car   Carina         | LMi   Leo Minor      | Sex   Sextans        |
  222.        | Cas   Cassiopeia     | Lep   Lepus          | Tau   Taurus         |
  223.        | Cen   Centaurus      | Lib   Libra          | Tel   Telescopium    |
  224.        | Cep   Cepheus        | Lup   Lupus          | Tri   Triangulum     |
  225.        | Cet   Cetus          | Lyn   Lynx           | TrA       "  Australe|
  226.        | Cha   Chamaeleon     | Lyr   Lyra           | Tuc   Tucana         |
  227.        | Cir   Circinus       | Men   Mensa          | UMa   Ursa Major     |
  228.        | Col   Columba        | Mic   Microscopium   | UMi   Ursa Minor     |
  229.        | Com   Coma Berenices | Mon   Monoceros      | Vel   Vela           |
  230.        | CrA   Corona Austrina| Mus   Musca          | Vir   Virgo          |
  231.        | CrB   Corona Borealis| Nor   Norma          | Vol   Volans         |
  232.        | Crv   Corvus         | Oct   Octans         | Vul   Vulpecula      |
  233.        | Crt   Crater         | Oph   Ophiochus      |                      |
  234.        | Cru   Crux           | Ori   Orion          |                      |
  235.        +----------------------+----------------------+----------------------+
  236.  
  237.        TECHNICAL STUFF                                                   Page 6
  238.        *************************************************************************
  239.  
  240.  
  241. *      Accuracy:
  242.            Star position calculations include precession (when
  243.              the year > 50 years from 2000.0).
  244.            Planets / Moon / Sun  -
  245.             GENERAL ACCURACY
  246.              Planets - within .25 deg. of dec. & 3 minutes R.A.
  247.              Moon    - within .20 deg. of ecliptic coordinates
  248.              Sun     - within .05 deg. of dec. & 10 seconds of R.A.
  249.  
  250. *      Speed:
  251.            On machines without an 8087 plotting will take a long time...
  252.              20 minutes on a 4.77MHZ 8088.
  253.            My 8086/8087 running at 8MHZ does a plot in about twenty seconds.
  254.  
  255.  
  256. *      Data-Base built from:
  257.        --------------- ------------
  258.        Yale Catalog    STARS   .DAT
  259.        Darrell Green's NGC200  .CAT
  260.                        LINES   .DAT by "me" (all ten blurry eyed hours of it!)
  261.                        STARNAME.DAT by "me" (an hour or two)
  262.  
  263.        VERSION STATUS                                                    Page 7
  264.  
  265.  
  266.          Version 1.1p - corrects an error in the constellation line data-base
  267.        and adds support for the major color graphics standards.  I've
  268.        also made a few changes to make the program more easy to use.
  269.  
  270.          Version 1.2p - In this version I've made some major improvements:
  271.          First, as pointed out by Jim Lill (a CP/M RT sysop) I've added the
  272.        "0" in the ten's of minutes field (along with some other cleaning up).
  273.          After looking at Septembers issue of ASTRONOMY I decided to take
  274.        a look at the Moon's occultation of Tau-Scorpii from SKY...  Very poor
  275.        accuracy on my part so... I corrected a bug in the sun/moon calculations
  276.        and added more calculations in the sun/moon/planet sections for better
  277.        accuracy (geocentric parallax corrections).
  278.          Then I improved on the "object lookup feature":
  279.        I added the names of the brightest stars (218 of 'em): they're displayed
  280.        with other star info when you press the left button of the mouse.
  281.          Also, I fixed the "C"enter option-it now works-and added a search
  282.        feature to this option.  This last feature makes the program useful even
  283.        if you don't have a mouse.
  284.          AND... too many other fixes/mods to mention (mostly small ones).
  285.  
  286.          Version 1.21p - just moved the .BGI drivers into SKY.EXE and did
  287.        away with the .PAK format archive.  I've also estimated how much memory
  288.        this program will need:
  289.  
  290.          Main program     +  96K
  291.          Data for  "      +  48K   ( this is accurate for V2.0 )
  292.          Stack for "      +  16K
  293.          Heap: stars      + 137K   ( V2.0  lowers this by 50K  )
  294.                ngcs       +  25K   (             "         4K  )
  295.                star names +   5K
  296.                plotter    +  34K   ( hi-res. print mode uses 64K )
  297.                font file  +   2K
  298.                graph drv  +   6K
  299.          DOS              +  64K   ( depending on version + drivers )
  300.                   ---------------
  301.          total=             433K   (463K with Hi-Res option print option)
  302.  
  303.  
  304.        Version 2.0 - Many, many new features...
  305.        Multi-Res. graphics ( now uses EGA/MCGA/VGA in 640X350 or 640X480 )
  306.        Printer support (with a choice of map projections and NGC listings)
  307.        New sub-option under <C>enter:  you may now scan the NGC object
  308.          descriptions for a <W>ord.  This allows searching for named objects
  309.          like: Andromeda, Ring, Whirlpool, Owl, etc.
  310.        I also changed around the organization of the plotting routines.  They
  311.          were keeping the Altitude and Azimuth in memory for each star and
  312.          NGC object (which allowed faster re-plotting) but I wanted the mem.
  313.        Added 1/3 more stars (11707 stars: reach to magnitude 7.5 or greater)
  314.        Added an installation program to SKY (with more install options, like
  315.          a mode for mono/color monitors and graphics resolution selection)
  316.        Fixed a bug that caused MSDOS to run out of file variables:  caused
  317.          a "FILE NOT FOUND" error.
  318.  
  319.        Version 2.1 -
  320.        Corrected a bug which caused planets to be 15X too large.
  321.        I've changed the planet color to red for easy identification.
  322.        Corrected the display for a true 1 to 1 aspect ratio.
  323.        Added MSO mode to NGC switch for display of Messier objects only.
  324.  
  325. NOTE:  version 2.2 was developed from v2.0 as the source to v2.1
  326.        was lost.
  327.  
  328. --->   Version 2.2r - (r means rEAL math / 80x87 version is for those who
  329.                        register)
  330.        First version to be distributed as shareware.
  331.        Corrected printing problems.
  332.        Sky now uses a quicker method to load data files.
  333.        Information in data files is encoded to save space (in memory and
  334.        on disk).
  335.        Added support for the Hercules mono mode (720x348).
  336.  
  337.  
  338.        FEED BACK                                                         Page 8
  339.  
  340.  
  341.  
  342.  
  343.        If you note any problems with SKY just drop me a line,  I'll do my
  344.        best to correct them.
  345.  
  346.        Mail address -
  347.          Howard J. Dutton
  348.          P.O. Box 694
  349.          Worcester PA, 19490
  350.  
  351.     GENIE address - H.Dutton
  352.     COMPUSERVE - 70641,1045
  353.  
  354.