home *** CD-ROM | disk | FTP | other *** search
/ ftp.barnyard.co.uk / 2015.02.ftp.barnyard.co.uk.tar / ftp.barnyard.co.uk / cpm / walnut-creek-CDROM / BEEHIVE / UTILITYS / SKYSHOW.LBR / SKYSHOW.DYC / SKYSHOW.DYC
Text File  |  2000-06-30  |  4KB  |  83 lines
  1.                              SKYSHOW.ARK
  2.                              -----------
  3.  
  4.  
  5. This archive contains two MBASIC programs, SKYPLOT and PLANETS, that 
  6. will plot the celestial positions of the Sun, Moon, Planets and Stars 
  7. on your CRT.  They are adaptations of programs found in the book, 
  8. "Celestial BASIC", by Eric Burgess, published in 1982 by Sybex (out of 
  9. print in 1990).  According to the book's cover, the programs are 
  10. intended for "the serious amateur astronomer as well as the occasional 
  11. stargazer".  I fall into the latter category.
  12.  
  13. The programs in Mr. Burgess's book have versions for the Apple II and 
  14. Exidy Sorcerer computers, but use hardware-specific graphic and POKE 
  15. instructions to plot the celestial positions in video memory.  The 
  16. programs for the Exidy also assume a non-standard screen size of 30 
  17. lines of 64 characters each.
  18.  
  19. I was intrigued by the illustrations in the book, and set about 
  20. adapting two of the Exidy programs for my 24 by 80 screen, using no 
  21. graphic or POKE commands, and using a function for cursor-positioning.
  22. Actually, my Xerox 820-II PC has a Lear Siegler ADM-3A compatible CRT, 
  23. which is standard on many CP/M computers, including the Kaypros.
  24.  
  25. To adapt these programs to your computer, you just substitute (where 
  26. they differ) your terminal's escape sequences for the following string 
  27. variables:
  28.  
  29.         CURON$  = cursor ON
  30.         CUROFF$ = cursor OFF
  31.         BLINK$  = cursor blink ON
  32.         BLOFF$  = cursor blink OFF
  33.         BEL$    = ring bell
  34.         CL$     = clear screen & home cursor
  35.         HOME$   = home cursor
  36.         FNAT$   = cursor-positioning function
  37.  
  38. All of these variables are found at the beginning of the programs.  
  39. Except for the CURSOR ON/OFF, CURSOR BLINK ON/OFF and CURSOR HOME 
  40. codes, the program should run on Kaypro terminals.  In fact, the 
  41. CURSOR ON/OFF and BLINK ON/OFF codes are not essential to the 
  42. programs' operation and may be eliminated, if desired.  You should 
  43. also look at the translation subroutine at the bottom of each program, 
  44. if you must alter the cursor-positioning code.  I have retained the 
  45. line numbers from the book, to make it easier for you to check my 
  46. version against the original.
  47.  
  48. The program SKYPLOT.BAS is an adaptation of the program SKYPLA.BAS, 
  49. beginning on page 247 of the book.  By omitting the skyline graphics 
  50. and moving the heading and prompts to the right side of the screen, I 
  51. was able to retain the full sky display of the original program.
  52.  
  53. The program PLANETS.BAS is an adaptation of the program PLNTA.BAS, 
  54. beginning on page 268 of the book.  I moved the prompts to the right 
  55. side of the screen for clarity, but I wasn't able to squeeze 30 lines 
  56. into 24, so I merely dropped off the bottom 6 lines of the charts.  
  57. Everything else is retained, but a few stars and the entire 
  58. constellations of Sirius, Corvus, Sagittarius, Scorpio, Fomalhaut and 
  59. Capricornus were lost with these 6 lines.  Except for this, the 
  60. program operates identically to the original.
  61.  
  62. Neither of the programs is bug-free, but I have done the tedious 
  63. typing and translation job--I leave the fine tuning to anyone who is 
  64. interested.
  65.  
  66. There are 24 other useful programs in the book to transcribe, most of 
  67. which are far shorter and less complicated than the two included here. 
  68. If you have an Apple II or an Exidy Sorcerer computer, you will find 
  69. programs that require no translation; you merely have to type them in 
  70. and enjoy.
  71.  
  72. When running the programs, I suggest that you refer to Mr. Burgess's 
  73. book (try the library) for details of what the programs expect as 
  74. input, and then to be patient.  On my 4 Mhz Z80 it takes a little over 
  75. 3 minutes for SKYPLOT to compute the celestial positions and display 
  76. the results.  Just enter the required input when prompted, and then 
  77. sit back and watch the stars come out.
  78.  
  79. Have fun.
  80.  
  81.  
  82. Ernest Helliwell : 22 OCT 1990 : San Francisco, CA
  83.