home *** CD-ROM | disk | FTP | other *** search
/ The Starbase One Astronomy & Space Collection / STARBASE_ONE.ISO / a94 / disk12 / js.com / JSSC.DOC < prev    next >
Encoding:
Text File  |  1986-11-02  |  8.6 KB  |  170 lines
  1.  
  2.  
  3.                        Jupiter Satellite Simulator/Charter
  4.                                      (JSSC)
  5.                                    Ron Fowler
  6.                             NightOwl Software, Inc.
  7.  
  8.         JSSC  provides both real-time and simulated displays of Jupiter's 
  9.         Galilean  satellites;  it  runs on IBM-compatible  computers  and 
  10.         requires a Color Graphics Adapter (or compatible video card).
  11.  
  12.         In addition to simulation,  JSSC provides a charting function  to 
  13.         produce  a graph of the Jovian system over a period of time (sim-
  14.         ilar to the one which appears each month in Sky & Telescope).  
  15.  
  16.                             -------------------------
  17.  
  18.         JSSC  always  comes up in the simulator mode,  where  Jupiter  is 
  19.         displayed in the center of the a telescopic viewfield,  with each 
  20.         of  the four Gallilean satellites plotted as points in  Jupiter's 
  21.         equatorial  plane  (each  labeled with the first  letter  of  its 
  22.         name).   The  simulator can be in one of three  modes:  Realtime, 
  23.         Skip  and  Freeze.   If you're using the JSSC.DAT file  supplied, 
  24.         JSSC will be in Freeze mode (described below).  Skip and Realtime 
  25.         modes  can  be selected via commands,  which are  entered  in  as 
  26.         keyboard characters whenever the simulator is "idling" (i.e., not 
  27.         prompting  for other input).   Whichever mode you select when you 
  28.         exit JSSC will be stored in JSSC.DAT,  so that the next time  you 
  29.         run JSSC, you'll come up in the same mode as when you last left.
  30.  
  31.         Online  help is available via the 'H' command (simply key an  'H' 
  32.         at  the  simulation screen).   Each of the available commands  is 
  33.         described as follows:
  34.  
  35.         1) H (Help) prints a short help text.  '?' also works.
  36.  
  37.         2)  R (Realtime mode):  JSSC advances the display as your  system 
  38.         clock  advances and uses the system's time and date as  "current" 
  39.         time and date.
  40.  
  41.         3) S (Skip mode): JSSC adds an increment to the current time once 
  42.         each second,  then re-displays. The "current" time and date start 
  43.         out  the  same as the system's,  but may be changed  with  the  D 
  44.         command (below).
  45.  
  46.         4)  F (Freeze mode):  JSSC does not automatically update the dis-
  47.         play.   Two subcommands are available from Freeze mode:  +  (move 
  48.         the time forward by the increment amount) and - (move backward by 
  49.         the increment amount).  This mode is handiest for manually moving 
  50.         the  Jovian system backward and/or forward.  Use "F" to toggle in 
  51.         and out of Freeze mode.
  52.  
  53.         5)  D (set Date/Time):  this command is used to set  the  current 
  54.         date and time; ("T" is a synonym for "D").  JSSC will prompt you 
  55.         for a new date and time.  The D command forces Skip mode, since D 
  56.         does not change the system's date or time, and thus is not "real-
  57.         time".
  58.  
  59.         6)  I  (set Increment):   JSSC will ask you for a  new  Increment 
  60.         value for the skip mode.  You may enter any number of days, along 
  61.         with  an appropriate number of hours,  minutes and seconds.   The 
  62.         Increment is saved between runs in JSSC.DAT. 
  63.  
  64.         7)  Z (time zone):   JSSC will print a list of time  zones,  from 
  65.         which you may select a three-letter mnemonic (be sure and key  in 
  66.         all 3 letters).  If your time zone is not listed, you can enter a 
  67.         number  instead.   This number is the number of hours required to 
  68.         add  to  Local time (LCT) to convert to Greenwich  Mean  Time  (6 
  69.         hours  for Central Standard Time,  for example).   JSSC will save 
  70.         your time zone in JSSC.DAT; thus, after initial setup, you should 
  71.         require this command only twice per year.
  72.  
  73.         8)  V  (Viewfield):  toggles on and off the simulated  telescopic 
  74.         field through which Jupiter and its satellites appear.
  75.  
  76.         7) Cursor control keys:  Magnification can be increased using the 
  77.         page-up  key  (coarse adjustment) or the uparrow  key  (fine  ad-
  78.         justment).   Similarly,  page-down  and downarrow decrease magni-
  79.         fication.   Leftarrow  moves  the image in the  "telescope"  left 
  80.         while  rightarrow moves the image right.   All of these  keys  do 
  81.         intensive graphics manipulation, and thus are not extremely fast.
  82.  
  83.         8) C (Chart) 
  84.  
  85.         This  command plots a graph of the Jovian system over time;  JSSC 
  86.         will prompt you for a starting date/time,  and a duration in days 
  87.         and hours, minutes and seconds. The chart screen will display GMT 
  88.         dates  and times on the left,  and local dates and times  on  the 
  89.         right.   Letters  identifying the satellites are printed  period-
  90.         ically  down the graph,  each letter near the curve for its  sat-
  91.         ellite.  The plot may be aborted at any time with the escape key.
  92.  
  93.         I  recommand a maximum duration of five to seven  days  ...  much 
  94.         more than that, and the graph tends to be squeezed too tightly.
  95.  
  96.         After  the plot has completed,  JSSC will prompt for "X" or  "A"; 
  97.         "X"  will exit back to the simulation mode.   "A",  on the  other 
  98.         hand,  will  display an arrow on the screen,  which may be  moved 
  99.         with  the cursor keys.   The arrow is used for querying date  and 
  100.         time  at a particular point on the graph.   Move the arrow to  an 
  101.         area,  then  use  the "I" key to identify that point's  time  and 
  102.         date.
  103.  
  104.  
  105.         Notes
  106.         -----
  107.  
  108.         1)  JSSC does not calculate latitude variations.   The satellites 
  109.         are all displayed in Jupiter's equatorial plane.
  110.  
  111.         2) JSSC does not differentiate between transits and eclipses.  In 
  112.         simulation  modes,  the  satellites always display in  the  fore-
  113.         ground,  regardless of whether the disk of Jupiter is in front of 
  114.         or  behind the satellite (this is true of the chart  function  as 
  115.         well,  except  that the satellites appear to pass behind the band 
  116.         representing Jupiter).
  117.  
  118.         3) In chart mode,  dates and times are prefixed with "G" or  "L", 
  119.         to indicate GMT or LCT.
  120.  
  121.         4) Whenever JSSC prompts for a date or time,  if you respond with 
  122.         only  your  enter key,  JSSC will use the CURRENT date  or  time.  
  123.         When  you  specify a time or date,  be sure to use the  following 
  124.         forms:
  125.  
  126.              DATE: MM-DD-YYYY         (e.g., 09-12-1986)
  127.              TIME: HH:MM:SS           (e.g., 14:21:17)
  128.  
  129.         While JSSC is fussy about the format (it'll beep and re-prompt if 
  130.         it  doesn't like your entry),  it does no error checking  on  the 
  131.         actual numbers entered.
  132.  
  133.         Responding with carriage-returns to both time and date during the 
  134.         Increment prompts cause a 1-second default increment.  Similarly, 
  135.         you  can  select a default 5-day period for the Chart  period  by 
  136.         entering carriage-return to both of the period prompts.
  137.  
  138.         5)   It's sometimes handy to align JSSC's Chart function  with  a 
  139.         Sky & Telescope chart.  When doing this, remember that S&T charts 
  140.         are labeled for GMT;  you should,  therefore, start your chart at 
  141.         midnight  GMT  on the desired date.   This will require a  little 
  142.         forethought.   For example, from my time zone (5 hours behind GMT 
  143.         in  the summer),  to start a September 1 plot in  alignment  with 
  144.         S&T's  chart,  the start date is 08-31-1986 and the start time is 
  145.         19:00:00  (which  is the time here on 31  August  when  Greenwich 
  146.         Midnight occurs on 1 September)
  147.  
  148.         Credits
  149.         -------
  150.         Few programs are entirely original works, and this is certainly 
  151.         true of JSSC: 
  152.  
  153.              - JSSC would have been a lot sloppier without David Bulger's
  154.                orbital calculations (taken, along with a few other
  155.                goodies, from David's JUPZOOM.BAS).
  156.  
  157.              - Local-time/date to Julian date calculation routines came
  158.                from David Bulger's JULIAN.BAS (David does write a *lot*
  159.                of good stuff!)
  160.  
  161.              - Julian-to-local conversion came from JDCAL.BAS, a pro-
  162.                gram originally published in Sky & Telescope magazine.
  163.  
  164.  
  165.                                  Ron Fowler
  166.                                  NightOwl Software, Inc.
  167.                                  October 1, 1986
  168.  
  169.         -----------------------------------------------------------------
  170.