home *** CD-ROM | disk | FTP | other *** search
/ RBBS in a Box Volume 1 #2 / RBBS_vol1_no2.iso / add2 / starvu.zip / STARVIEW.DOC < prev    next >
Text File  |  1988-02-03  |  9KB  |  213 lines
  1.                    Digi-Tech StarView 1.0.09 of 18Jan88
  2.  
  3.                 (c)1988 Digi-Tech Consultants.  All Rights Reserved.
  4.  
  5.           Invoke with     StarView [path]
  6.           where path is the optional drive and/or directory containing the
  7.           device drivers and data files.
  8.  
  9.           StarView is a non-commercial product of Digi-Tech Consultants.
  10.           You may use it freely, and distribute copies to others as long
  11.           as no fee of any kind is charged and the program and supplied
  12.           data files remain unmodified.
  13.  
  14.           A contribution of $30 would be appreciated, and entitles you to
  15.           suggest improvements and point out errors in the software.
  16.  
  17.           Corporate usage or distribution with a product requires a license.
  18.  
  19.                       Brian McMillin
  20.                       Digi-Tech Consultants
  21.                       P. O. Box 12144
  22.                       Dallas, TX   75225
  23.  
  24.           The use of a mouse is recommended.
  25.           Change parameters by clicking or dragging the bar graphs.
  26.  
  27.           Reposition the display by dragging in the starfield:
  28.              Up and Down change Declination.
  29.              Left and Right change Right Ascension.
  30.  
  31.           Position the cursor near a star to see its identification.
  32.  
  33.           Use Up and Down arrow keys to change declination.
  34.           Use Left and Right arrow keys to change Right Ascension.
  35.           Ins and Del rotate the display.
  36.           Home and End zoom in and out on the display.
  37.           PgUp and PgDn change the limiting magnitude displayed.
  38.  
  39.           Letters select a constellation (highlighted by blinking).
  40.           + and - step through alphabetized constellation abbreviations.
  41.           Space clears the selected constellation.
  42.              f1  inverts the image         f2  displays this Help info
  43.              f3  selects clock drive       f4  selects time rate
  44.              f5  change display colors     f6  display Mag or Spec Class
  45.              f7  select spectral classes   f8  select coordinate Epoch
  46.              f9  set observer info         f10 toggles drive on/off
  47.  
  48.           This version of StarView implements display of objects in
  49.           the solar system.  These objects can be observed at any
  50.           time or date by setting the observer info (f9).
  51.  
  52.           The displayed date and time can be set to the current local
  53.           time by pressing Alt-f10.
  54.  
  55.           The displayed coordinates are either for the Epoch of Date, or
  56.           Epoch 2000.0.  Toggle with f8.
  57.  
  58.           A tabular display of the positions of solar system objects may
  59.           be obtained by pressing Alt-f9.
  60.  
  61.           The horizon at your location will also be visible as a short
  62.           line in the field.  "Below Horizon" means the center of the
  63.           field is below the horizon.
  64.  
  65.  
  66.           You may center the display on any object by pressing Enter
  67.           and typing in any of the following identifications:
  68.  
  69.               name       common name or abbreviation (SUN, VEGA)
  70.               nn XXX     Flamsteed Number and Constellation
  71.               ggg XXX    Greek letter abbreviation and Constellation
  72.               HR=nnnn    Yale Catalog Number
  73.               C=XXX      Just a Constellation designator
  74.               RA=hh.hh   Change Right Ascension to decimal hours
  75.               DEC=dd.dd  Change Declination to decimal degrees
  76.  
  77.           In addition, you can directly set some display parameters:
  78.  
  79.               ROT=dd.dd  Change display rotation to decimal degrees
  80.               F=nn.n     sets the field width
  81.               M=nn.n     sets the limiting magnitude of the display
  82.               LAT=dd.dd  Observer's Geographic Latitude (degrees)
  83.               LON=dd.dd  Observer's Geographic Longitude (degrees)
  84.               ALT=nn.nn  Observer's Altitude above sea level (meters)
  85.               ddMMMyy    Display Date (e.g. 12MAR88 or 00JAN2000)
  86.               hh:mm:ss   Display Time (must be hours, mins and secs)
  87.               hh:mm:ssU  Display Universal Time (must have U on the end)
  88.  
  89.           The first time you run StarView, you will see the graphics
  90.           selection screen and the observer information screen.
  91.           You should enter selections for screen mode and colors,
  92.           as well as you latitude, longitude and time zone.
  93.  
  94.           This information will be retained in the file StarView.OBS.
  95.  
  96.           You can recall the Graphics setup screen by pressing f5.
  97.  
  98.           You can change your observer parameters by pressing f9.
  99.  
  100.           The observer screen also allows you to enter a specific time
  101.           and date for your observations.
  102.  
  103.           An automatic drive feature is included.  This simulates the
  104.           view in an actual telescope with a fixed mount, or an
  105.           equatorial mount with R. A. clock drive.
  106.  
  107.           Select a drive rate with f3.
  108.  
  109.           Toggle the drive ON and OFF with f10.  If the drive is OFF
  110.           time will not change automatically.
  111.  
  112.           If the drive is Locked and ON, the stars will move at the rate
  113.           of the Earth's rotation.
  114.  
  115.           If the drive is Solar Rate ON, the stars will move at the rate
  116.           of the Sun.
  117.  
  118.           Sidereal Rate will change only the positions of the horizon and
  119.           solar system objects; the stars will remain fixed.
  120.  
  121.           Lunar Rate ON will move the stars at the rate of the moon.
  122.  
  123.           Select a time multiplier with f4.  Choices are real time,
  124.           as well as 10, 100 and 1000 times normal.
  125.  
  126.           The following files are required for operation of StarView:
  127.               StarView.EXE    executable program
  128.               StarView.IDs    Bayer and/or Flamsteed IDs (text)
  129.               StarView.NAM    Common names of certain stars (text)
  130.               StarView.SIN    Trig Table (binary)
  131.               StarView.BIN    Star Coordinates, Magnitude and Spectral Type
  132.               StarView.MAX    Number of valid objects in StarView.BIN
  133.  
  134.           In addition, the following graphics device drivers are supplied.
  135.               ATT.BGI         AT&T 400 line graphics
  136.               CGA.BGI         IBM Color Graphics Adapter
  137.               EGAVGA.BGI      IBM EGA and VGA
  138.               HERC.BGI        Hercules Graphics Adapter
  139.               PC3270.BGI      IBM 3270/PC Driver
  140.  
  141.           All files must be in the path specified in the command line.
  142.           This version of StarView requires approximately 400 Kb of memory.
  143.  
  144.           The database for this program is derived from the 4th edition
  145.           of the Yale Bright Star Catalog and contains 9096 stars.
  146.           Coordinates are Epoch 2000.0.
  147.  
  148.           No non-stellar fixed objects are included in this version.
  149.  
  150.           You may add your own data to the list of fixed objects
  151.           used by StarView.  The File StarView.ADD is a text file which
  152.           will be read after all the standard objects are loaded.
  153.  
  154.           The format of each line in StarView.ADD is as follows:
  155.  
  156.               Right Ascension in decimal hours
  157.               Declination     in decimal degrees
  158.               Magnitude       in decimal
  159.               Name            optional 15 byte text designation
  160.  
  161.           The text is free format, but values for all three numbers
  162.           are required on each line.
  163.  
  164.           There are limitations on the number of objects you can add,
  165.           based on compile-time declarations and the number of objects
  166.           in the distribution database.  You should be able to specify
  167.           more than 500 objects with names without problems.
  168.  
  169.           To make more room for your own objects, make the value in
  170.           StarView.MAX smaller (fewer objects in standard catalog).
  171.  
  172.           Be sure to use Epoch 2000.0 coordinates in your data.
  173.  
  174.           StarView contains information on the SUN, MOON and ZENITH (for
  175.           horizon display).  Orbital elements for the planets are contained
  176.           in the file StarView.ELE.  You can add your own data for
  177.           planets, comets, asteroids, etc. to those listed.
  178.  
  179.           The format of each object in StarView.ELE is as follows:
  180.  
  181.               Name            Up to 15 character name for the object
  182.               Epoch           in decimal Years
  183.               Period          in decimal Years
  184.               Eccentricity    in decimal
  185.               Longitude       at Epoch in decimal degrees
  186.               Longitude       of Ascending Node in decimal degrees
  187.               Inclination     in decimal degrees
  188.               Semi-Major Axis in Astronomical Units
  189.               Diameter        at 1 A.U. in arc seconds
  190.               Brightness      in A.U. squared
  191.  
  193. These files should be included in the STARVIEW ARChive:
  194.  
  195. STARVIEW.DOC - This document
  196. STARVIEW.EXE - The Starview program itself
  197. STARVIEW.ELE - Elements for Starview
  198. STARVIEW.BIN \
  199. STARVIEW.IDS  \
  200. STARVIEW.MAX   > Additional runtime files
  201. STARVIEW.NAM  /
  202. STARVIEW.SIN /
  203. ATT.BGI    \
  204. CGA.BGI     \
  205. EGAVGA.BGI   > Graphics files
  206. HERC.BGI    /
  207. PC3270.BGI /
  208.  
  209. You can always obtain the latest version of STARVIEW from the Starport BBS.
  210. There is also an area there where you can leave messages to Brian.  Starport
  211. can be reached at: 203-698-0588 at 1200-9600 baud, 24 hours a day.
  212.  
  213.