home *** CD-ROM | disk | FTP | other *** search
/ Nebula / nebula.bin / PC / astro / jupsat.doc < prev    next >
Text File  |  1993-08-08  |  6KB  |  140 lines
  1.                        Documentation for JUPSAT.COM
  2.  
  3.  
  4. PROGRAM DESCRIPTION
  5.  
  6. This  program calculates the positions of the four Galilean satellites (Io, 
  7. Europa,  Ganymede  and  Callisto)  orbiting  Jupiter,  and  displays  their 
  8. positions  graphically  on the screen.  It has been written to run  on  CGA 
  9. machines or Hercules machines running the SIMCGA utility.  It requires  the 
  10. JUPITER.MNU  data file in order for the user to have access to the pop-down 
  11. menus.
  12.  
  13. Other numerical data is also displayed. This is described below.
  14.  
  15.  
  16. INPUT
  17.  
  18. Both  the users date abd time are required as input for  the  program.  The 
  19. format of the date is "dd/mm/yyyy".  The time entered is UT/GMT and is inthe 
  20. format "hh:mm".
  21.  
  22. Both  the date and time can be edited as they are entered.  The ESC key can 
  23. be pressed to reset the date to "dd/mm/yyyy" or the time to "hh:mm".
  24.  
  25.  
  26. THE DISPLAY
  27.  
  28. The  display is at its best on a monochrome monitor.  This consists of four 
  29. distinct sections. Section one diplays the top-line menu.
  30.  
  31. Section two displays the Orbit scale,  the type of instrument through which 
  32. the displayed view would be seen, the date and the time.
  33.  
  34. Section  three  is  the  graphics  display window  in  which  the  satellite 
  35. positions  are  drawn in relation to  Jupiter's  disk.  Compass  directions, 
  36. related to the current view,  are printed at the top left of the window. The 
  37. satellite  and  Jovian  disks are drawn to scale,  as  are  the  satellites' 
  38. distances from Jupiter.
  39.  
  40. Section four contains the numerical information for each  satellite,  namely 
  41. its distance from Jupiter,  as measured in Jupiter radii, and its angle from 
  42. Inferior Conjunction.  Inferior Conjuntion occurs at zero (0) degrees,  i.e. 
  43. when  a  satellite  is  directly behind Jupiter.  The  angles  are  measured 
  44. westward from this point,  going to 90 degrees West,  180 degrees West (when 
  45. the  satellite is immediately in front of Jupiter,  to 270 degrees West  and 
  46. finally back to zero.
  47.  
  48. A box with a thick border at the top left of section four contains the first 
  49. letter of each of the satellites' names. The sequence of these letters, read 
  50. from  left to right,  corresponds to the sequence of the satellites as  they 
  51. appear  in the display window.  For example,  suppose the box contained  the 
  52. letter  sequence EICG,  then in the display window,  the leftmost  satellite 
  53. would be Europa,  the next one in, Io, followed by Callisto, and lastly, the 
  54. rightmost, Ganymede.
  55.  
  56.  
  57.  
  58. TOP LINE MENU
  59.  
  60. This  menu  offers five options as described below.  A bar  highlights  the 
  61. current option on the menu.
  62.  
  63.  
  64.   OPTIONS
  65.  
  66.   Orbit-Zoom: This  option allows the user to set the magnification  of  the 
  67.               display.  When  chosen,  a  pop-down  menu appears  on  screen 
  68.               listing  the  four  Galilean  satellites.  Each  name  sets  a 
  69.               different magnification,  by displaying everything within  the 
  70.               chosen  satellites orbit,  in the display window.  The program 
  71.               remembers which satellite orbit the user has chosen each  time 
  72.               the menu is called,  by highlighting the current option with a 
  73.               bar.  The  ESC key is used to escape back from the menu to the 
  74.               top-line menu.
  75.  
  76.   Newcalc   : This  option allows the user to key in/edit a new date  and/or 
  77.               time. The ESC key is used to escape back to the top-line menu. 
  78.  
  79.   View      : This  allows the user to choose the type of instrument through 
  80.               which  he/she would normally observe the satellites.  Altering 
  81.               the  view  causes the graphics  display,  compass  directions, 
  82.               first   letters   and   the  numerical   information   to   be 
  83.               automatically  updated.   A  pop-down  menu  offers  the  four 
  84.               possible views with the most popular types of instrument.
  85.  
  86.   Print     : Sends a four-colour shaded hard copy of the screen to an Epson 
  87.               compatible  dot-matrix  printer.  The  top-line  menu  is  not 
  88.               included  as part of the screen dump.  It is not necessary  to 
  89.               have previously run the GRAPHICS utility in order to get  this 
  90.               screen dump.
  91.  
  92.   Exit      : Returns the user to DOS.
  93.  
  94.  
  95.  
  96.  
  97.  
  98. MOVEMENT WITHIN MENUS
  99.  
  100. Moving  between options in the top-line menu is achieved with the use of the 
  101. left and right cursor keys.
  102.  
  103. Movement  within  the pop-down menus is achieved by using the  up  and  down 
  104. cursor keys.  In addition, it is possible to move between the pop-down menus 
  105. with the left and right cursor keys.
  106.  
  107. In all cases the ENTER key is pressed to select the required option.
  108.  
  109.  
  110.  
  111.  
  112. THE USE OF COLOUR CODING 
  113.  
  114. Four  colours  are used throughout the display.  These will appear  as  four 
  115. distinct  shades  on monochrome displays,  and as four separate  colours  on 
  116. colour monitors.
  117.  
  118. The  colour shading applies particularly to the satellites as drawn in  the 
  119. display window,  their first letters and their numerical  information.  The 
  120. standard  shadings are as follows:  Black,  Low Brightness (Green),  Medium 
  121. Brightness (Red),  and High Brightness (Brown).  
  122.  
  123. Jupiter is always drawn in low brightness (Green). The satellites are drawn 
  124. in high brightness (Brown). Eclipsed satellites are not drawn. 
  125.  
  126. The  first  letters and numerical information are normally printed  in  high 
  127. brightness (Brown).
  128.  
  129. If,  when  using  the  Orbit-Zoom option,  some satellites move out  of  the 
  130. display window,  they will not be drawn. The corresponding first letters and 
  131. numerical  information  of any such satellite will then be  printed  in  low 
  132. brightness (Green).
  133.  
  134. If  a satellite is transiting,  (passing in front of Jupiter's  disk),  then 
  135. it's corresponding first letter and numerical information will be printed in 
  136. medium brightness (Red).
  137.  
  138. Finally,  if  a  satellite is being eclipsed by Jupiter,  (behind  Jupiter's 
  139. disk), it's corresponding first letter and numerical information are printed 
  140. in inverse high brightness (Black on Brown).