home *** CD-ROM | disk | FTP | other *** search
/ World of Shareware - Software Farm 2 / wosw_2.zip / wosw_2 / GENERAL / SKY23NC.ZIP / SKYMAP.DOC < prev    next >
Text File  |  1991-04-06  |  21KB  |  402 lines

  1.  
  2.                               SkyMap Version 1.2
  3.  
  4.                           Documentation Draft Release
  5.  
  6. Introduction
  7. ------------
  8.  
  9. SKYMAP.EXE is a high-precision celestial mapping program for generating star
  10. fields on an EGA/VGA monitor and/or an HP Laser Plotter (or any similar hard-
  11. copy device that accepts the HewLett Packard Graphics Language).  Polar and
  12. rectangular map projections are supported, which can be plotted at any scale
  13. and centered on any coordinate.  Stars can be plotted at any epoch, with
  14. defaults for Besselian 1950.0 (B1950) and Julian 2000.0 (J2000).  Proper
  15. motion is included with precession.
  16.  
  17. SkyMap's star data files are based on the Smithsonian Astrophysical Observa-
  18. tory Star Catalogue (SAO), epoch B1950.  The SAO contains some 259,000 stars,
  19. but only those stars with visual magnitude brighter than 8.1 are presently
  20. used by SkyMap.  This 51,000+ star subset was converted from a 150-byte ASCII
  21. format to a 49-byte binary format by Rob Matson for use with SkyMap and other
  22. astronomical software.  For ease of modem transmission as well as program
  23. speed, these stars are sorted by right ascension and stored in 22 separate
  24. files, each containing 2350 stars (115150 bytes) except the last which has
  25. 1773 stars (86877 bytes).  These files can be found in file area #6 of the
  26. Rancho Palos Verdes bulletin board system operated by Dave Ransom.  SkyMap
  27. also accepts a further compressed, 28-byte format, which can be created from
  28. the 49-byte format files using a special program called 49TO28.EXE.  There
  29. is no loss of precision with the 28-byte format, and run times can be cut by
  30. as much as 30 percent over the 49-byte format (not to mention the megabyte
  31. of disk space saved).  The difference between the two is that the 49-byte
  32. format contains ALL the information found in the original 150-byte ASCII;
  33. the 28-byte format contains only the right ascension, declination, visual
  34. magnitude, and proper motion for each star.
  35.  
  36. Although SkyMap can be used simply to plot near-publication-quality star
  37. maps, it's greatest feature is its ability to superimpose a time-tagged
  38. satellite trajectory.  Using a standard NASA 2-line element set, SkyMap
  39. can plot the trajectory of any low-earth orbit (LEO) satellite against
  40. the stars as it would be seen from any location on earth.  (SkyMap uses
  41. Space Command's SGP and SGP4 algorithms, which are designed to propagate
  42. the element sets of satellites with periods less than 225 minutes.  Since
  43. nearly all satellites that are visible to the unaided eye fall into this
  44. category, the SDP4 deep-space routine has not yet been implemented.  SGP
  45. and SGP4 will still make predictions for "deep-space" satellites, but with
  46. somewhat decreased precision.)  As with the star catalogues, the NASA two-
  47. line element sets can be found on the RPV BBS, file area #4.  These files
  48. are of the form NASA8xx.TXT, and are updated approximately twice weekly in
  49. the PAK compression format.
  50.  
  51. Similar to the way it handles satellites, SkyMap also supports trajectory
  52. plotting of rocket boosters.  In this case, the 2-line ephemeris file is
  53. replaced by a rocket trajectory file that contains a tabular listing of a
  54. rocket's position as a function of time.  The format for each line of the
  55. trajectory file is:  mission elapsed time (MET) in seconds, latitude in
  56. degrees, longitude in degrees, and altitude in kilometers.  Negative values
  57. are entered for south latitudes and west longitudes.  The MET values need
  58. not be at regular intervals, but they must always increase.  SkyMap will
  59. linearly interpolate the rocket's position for times occurring between two
  60. tabular entries.
  61.  
  62. It should be pointed out that due to the limited resolution of monitors,
  63. much of the labeling that appears in the hardcopy is not sent to the video.
  64. For example, right ascension and declination grid labels, and satellite/
  65. rocket date and time tags appear in the hardcopy only.  Also, SkyMap does
  66. not (by itself) create hardcopy output; instead, it produces an HP-GL file
  67. which is compatible with HP plotters such as the HP7475A.  With a raster-
  68. izing program such as PRINTGL or Print-A-Plot, HP-GL files can be output
  69. on an HP LaserJet II or similar printer.  (PRINTGL can be found on Dave
  70. Ransom's RPV BBS).  Due to the large size of the HP-GL files that SkyMap
  71. can produce (particularly for maps plotted to magnitude 8.1), your laser-
  72. printer must have at least a megabyte of add-on memory to support plots
  73. at the full 300-dpi resolution.  If your laserprinter has insufficient
  74. memory, you will have to reduce the resolution to 150- or possibly 75-dpi
  75. in the rasterization program for the file to be printed successfully.
  76.  
  77.  
  78. Required Files
  79. --------------
  80.  
  81. To run SKYMAP.EXE, you will need several auxiliary files in addition to the
  82. star catalogue and satellite ephemeris/rocket trajectory files.  Most
  83. important is the configuration file, SKYMAP.CFG, which is discussed below.
  84. SATNAMES.DAT is needed if you plan to use SKYMAP to plot satellite trajec-
  85. tories.  Finally, ASTROCLK.CTY (or any city file that uses the ASTROCLK.CTY
  86. format) is required if you plan to plot satellite or rocket tracks.  So, to
  87. use all of SKYMAP's capabilities you should have 27 files (not including
  88. this .DOC file):  SKYMAP.EXE, SKYMAP.CFG, SATNAMES.DAT, ASTROCLK.CTY,
  89. NASA8xx.TXT, and 22 star catalogue files.
  90.  
  91.  
  92. Configuration File
  93. ------------------
  94.  
  95. There are six lines in the configuration file SKYMAP.CFG.  These lines can
  96. be modified using any text editor to represent your particular location and
  97. operating mode.  Alternatively, SKYMAP gives you the option of changing the
  98. values in the configuration file at run-time, which is somewhat easier.  The
  99. configuration file format is as follows:
  100.  
  101.      Line 1:  28 or 49    (record size of star catalogue)
  102.      Line 2:  Name of first star file (e.g. SAOM801.DAT)
  103.      Line 3:  Name of 2-line elements or rocket trajectory file
  104.               (e.g. NASA828.TXT)
  105.      Line 4:  Name of city file (e.g. ASTROCLK.CTY)
  106.      Line 5:  Name of your city or viewing site
  107.      Line 6:  Longitude, latitude, altitude, and zone hour of site
  108.  
  109. The first star file name must be of the form [abcdef]01.[ghi], where the
  110. bracketed characters are optional and can be of any length.  For example,
  111. 'STARS01.DAT', 'SAOM801.', and '01.X' are all acceptable; 'STAR02.DAT'
  112. and 'SAO1.BIN' are not, since '01' must appear in the name.  On line 6,
  113. longitude must be from -180 to 180 and latitude from -90 to 90 degrees.
  114. Altitude is in meters, and the zone hour is the time difference from GMT.
  115. Zone hour must be an integer from -12 to 12.  For the west coast, the
  116. zone hour is -8 for Standard Time and -7 for Daylight Savings Time.
  117.  
  118.  
  119. The City File
  120. -------------
  121.  
  122. The city file can have any name, and although it won't be referenced unless
  123. you plot a satellite or rocket track, the file still needs to "exist".  If
  124. you plan to use SKYMAP to plot celestial maps only, just create an empty
  125. file for SKYMAP to find and ignore!  (The same applies to the ephemeris
  126. file -- in fact, you could create a file called NUL.DAT, and use this name
  127. on lines 3 and 4 of SKYMAP.CFG).
  128.  
  129.  
  130. Running SKYMAP
  131. --------------
  132.  
  133. Type SKYMAP from your DOS prompt.  You'll first be asked to answer four
  134. configuration questions, the defaults for which will appear in brackets
  135. following each question.  If no changes are needed, just hit return after
  136. each question.  SKYMAP will check for the existence of all files, and
  137. indicate if any are missing.  If the configuration information checks
  138. out, SKYMAP will move on to the REAL questions, most of which should be
  139. self explanatory.  If you're interested in plotting a section of the sky
  140. within 50 degrees of the equator, a rectangular map projection is probably
  141. the way to go.  Otherwise, plot a polar projection.  The grid spacing
  142. question refers to a celestial coordinate grid that will be overlayed on
  143. the stars once they are plotted.  If you don't want a grid, enter negative
  144. values for both the RA and Decl spacing.
  145.  
  146.  
  147. Plot File
  148. ---------
  149.  
  150. A word on the plot file.  SKYMAP *always* produces a plot file, whether
  151. you want it or not.  (This is an artifact of the program's evolution from
  152. the days when screen output was not yet implemented.)  You can always
  153. delete the file later if you don't need it, so just give it any name.
  154. The program will check to see if the file already exists, and if so, give
  155. you the option of writing over it or selecting another filename.
  156.  
  157.  
  158. Screen Output
  159. -------------
  160.  
  161. Screen output IS optional, since there are one or two people in the world
  162. that don't have an EGA or VGA monitor.  At present, the default is NO
  163. screen output, so don't hit return for default unless you mean it.  (This
  164. will be changed in the next release of SKYMAP.)  For the user that selects
  165. no screen output, when it comes time to plot the stars on the screen, the
  166. program will instead output a running count (by hundreds) of the stars it
  167. has processed.
  168.  
  169.  
  170. Star Magnitude Limit
  171. --------------------
  172.  
  173. The limiting magnitude of the catalogue is 8.1 at the present time.  If
  174. you enter a star magnitude limit of 8.1 or higher, all stars that are
  175. within the viewing window will be plotted.  Obviously, the higher the
  176. limiting magnitude you enter, the fewer stars that will be plotted, but
  177. the faster the program will run.
  178.  
  179.  
  180. Star Map Epoch
  181. --------------
  182.  
  183. The default is B1950, which appears in brackets.  However, you can enter
  184. "J2000" for Julian 2000.0, or any other date.  For either of these cases,
  185. SKYMAP calculates the proper motion of all stars, and then precesses the
  186. new coordinates to the requested equinox.  Nutation is not handled by
  187. SKYMAP at present.  You'll notice that SKYMAP runs somewhat faster using
  188. the B1950 default epoch, since no proper motion or precession calculations
  189. are needed.
  190.  
  191.  
  192. Celestial Map Only
  193. ------------------
  194.  
  195. After the stars have all been plotted, SKYMAP will ask if you want to add
  196. a satellite or rocket trajectory to the plot.  The default is YES, but
  197. enter 'N' if the map is all you need.  SKYMAP will ask for a title to
  198. print below the map, which can be up to 70 characters.  Hit return if
  199. you don't want a title.  You then come to the final input:  whether to
  200. save changes to the configuration file.  The default is no, and if you
  201. hit return SKYMAP.CFG will remain unchanged.  If you made configuration
  202. changes that you want to save, enter 'Y'.  That's it!  You're done!  Your
  203. SKYMAP HP-GL file is ready to plot.
  204.  
  205.  
  206. Plotting a Satellite Trajectory
  207. -------------------------------
  208.  
  209. Plotting a satellite trajectory requires a bit of preparatory work BEFORE
  210. you run SKYMAP, and perhaps a little trial and error.  SKYMAP doesn't have
  211. the "brains" to know when a particular satellite is going to make a favor-
  212. able pass over your location, but there are plenty of other programs that
  213. were specifically written for this purpose.  I use my own program called
  214. VIEWSAT (which I may release later to the public), but others such as Dave
  215. Ransom's STSORBIT and Paul Traufler's TRAKSAT are available on various
  216. bulletin boards, and are easy to use.  Furthermore, they use the same two-
  217. line orbital elements that SKYMAP does.
  218.  
  219. Before running SKYMAP, try one of these programs and write down the date
  220. and time of the satellite pass you wish to plot.  Also note the range of
  221. celestial coordinates covered during the pass.  If the satellite is in a
  222. near-polar orbit, the right ascension probably won't change much except
  223. near the pole, so a polar plot will probably work best for you.  As an
  224. example, if the right ascension starts between 15 and 16 hours and ends
  225. between 3 and 4 hours, and the declination starts at -10 degrees, increases
  226. to 85 and ends at 70, a polar plot centered on RA 15.5 hours, Decl 50 deg,
  227. with a vertical field of view of 120 degrees would cover the entire orbit
  228. track.  (In practice, when using a polar projection it is best to stay away
  229. from the celestial equator so that distortion is minimized).
  230.  
  231. With the proper satellite position and time information, you should be able
  232. to plot a part of the sky that the satellite will pass through.  Once the
  233. stars are plotted, hit return twice to select the satellite track mode,
  234. and enter the date of the satellite pass.  The date will be interpreted as
  235. local or GMT depending on the form of the start time (entered later).
  236.  
  237.  
  238. Ground Site Information
  239. -----------------------
  240.  
  241. The next input is your ground site name, where the default in brackets is
  242. the site name found on line 5 of the configuration file.  If you select the
  243. default, the coordinates which appear on line 6 of SKYMAP.CFG will be used
  244. WHETHER OR NOT THEY ARE THE ACTUAL COORDINATES FOR THAT SITE.  (If your site
  245. name is San Diego, CA, and the entries on line 6 are -77, 39, 0, -5, the
  246. satellite's celestial coordinates will be from the vantage point of Washing-
  247. ton, D.C.!)  If you don't want the default site, enter the name you want or
  248. a search string.  SKYMAP searches through your city file (e.g. ASTROCLK.CTY)
  249. for a city name containing the string you entered.  If a match is found,
  250. SKYMAP will display the complete city name containing the match, giving you
  251. the option of accepting it or continuing to search for another match.  If
  252. the entire file is searched without an acceptable match, SKYMAP will display:
  253.  
  254.      Site name not found in ASTROCLK.CTY (or your city file name)
  255.  
  256. You will then have to enter the site latitude, longitude, altitude, and
  257. local timezone hour difference.  The only default offered is the timezone,
  258. which SKYMAP will guess at based on the site longitude.  For most cities,
  259. SKYMAP guesses correctly for standard time, but not for Daylight time.  (A
  260. notable exception is Atlanta).  Once site information has been entered, the
  261. user is given the option of adding the site to the city file.
  262.  
  263.  
  264. Satellite Selection
  265. -------------------
  266.  
  267. Satellites are selected by either their five-digit NORAD designation (e.g.
  268. 16609 for Mir), or their name.  Numbers have an advantage over names in
  269. that they are unambiguous.  But names are easier to remember.  Selecting
  270. satellites by name is similar to searching for a city name in the city
  271. file.  To find a particular satellite, SKYMAP does not need the whole
  272. name; just enough of the name to distinguish it from other satellites.
  273. As an example, entering "Mir" for the satellite name is not sufficient to
  274. distinguish the Mir Space Station from the Miranda satellites.  However,
  275. entering "Mir s" clears up the ambiguity.
  276.  
  277. When SKYMAP finds a match, it displays the full name of the satellite it
  278. has found, and gives you the option of accepting it, or continuing to
  279. search for further matches.  If no acceptable matches are found, SKYMAP
  280. will report "Name string not found.", and ask you to enter another name
  281. or number.
  282.  
  283.  
  284. SATNAMES.DAT file
  285. -----------------
  286.  
  287. The file SATNAMES.DAT is used to connect satellite names with their NORAD
  288. numbers.  Since new satellites are continually being launched, you may
  289. want to occasionally add entries to this file.  As with the city file and
  290. configuration file, this can be accomplished with any text editor.  Just
  291. follow the format of the other entries in the file, and keep the NORAD
  292. numbers in increasing order.  The first six characters of each line of
  293. the file must be the 5-digit NORAD designator followed by a space.  The
  294. next four characters are the satellite's standard visual magnitude, which
  295. is described below.  The name you want to use to identify the satellite
  296. begins in column 11.  Feel free to use any name you like, and to modify
  297. any of the names already in the file.  (You can also delete file entries
  298. for satellites that don't interest you).  You'll notice that for satellites
  299. which don't yet have a name, I've used the NORAD number and letter scheme.
  300.  
  301.  
  302. Standard Visual Magnitude
  303. -------------------------
  304.  
  305. The standard visual magnitude appears in columns 7-10, and is meant to
  306. represent the approximate visual magnitude of the satellite if it were at
  307. a range of 1000 km and a phase angle of 90 degrees (half-illuminated).
  308. My VIEWSAT program uses this value to predict the visual magnitude of a
  309. satellite as a function of its actual range and phase angle, but SKYMAP
  310. makes no such calculation at the present time.  It is included only for
  311. compatablity reasons, but I've mentioned it here for the curious.  Most of
  312. the standard magnitude values in SATNAMES.DAT come from the N2L-xxx type
  313. element sets, courtesy of Ted Molczan.  In general, I've found these
  314. values to be slightly pessimistic, and in a few cases I've made changes
  315. to reflect observations that I've made.  Entries of "99.9" are used for
  316. satellites which appear in the NASA bulletins, but not in Ted's N2L-type
  317. files.  Ted's two-line element sets concentrate on satellites which CAN be
  318. visible to the unaided eye, so those satellites with standard magnitude
  319. entries of 99.9 are either too dim or too recently launched for a measure-
  320. ment to have been made.
  321.  
  322.  
  323. Propagation Model and Lighting Constraints
  324. ------------------------------------------
  325.  
  326. If SKYMAP successfully locates your satellite, it will next ask for the
  327. propagation model to use.  SGP and SGP4 (the default) are supported, with
  328. results differing slightly between the models.  SGP4 should theoretically
  329. give more accurate predictions, so it is always the default model for
  330. SKYMAP.  SGP's results are generally quite similar, with the greatest
  331. variations occurring along track rather than cross-track.  If speed is a
  332. concern, SGP does run somewhat faster than SGP4.
  333.  
  334. Once you've selected the propagation model, you'll be hit with a barrage
  335. of lighting constraint questions.  The lighting constraints control what
  336. portions of an orbital track are plotted.  For most users, the bracketed
  337. default inputs will work fine for you.  The default constraints only
  338. require that the satellite be in sunlight.  It is possible to set the
  339. constraints such that tracks will only be plotted when the satellite is
  340. in sunlight and the sun is below the horizon at your site.  You can also
  341. place lunar lighting constraints on the satellite if desired.  Since the
  342. questions asked by SKYMAP are fairly straight-forward, they won't be
  343. covered in any more detail here.
  344.  
  345. One final note about lighting constraints.  If you plan to plot multiple
  346. satellite tracks on the same star map, you'll be pleased to know that
  347. you only have to input the date and lighting constraints once.  The same
  348. date and constraints will be used for all subsequent satellite plots.
  349.  
  350.  
  351. Time Information:  Start times, duration, resolution, and timetags
  352. ------------------------------------------------------------------
  353.  
  354. The user-input start time tells SKYMAP when to start the orbital propagation.
  355. This will be the time of the beginning of the satellite track on the map,
  356. assuming that the satellite happens to be within the map window.  I try to
  357. pick a time around 10 minutes before the satellite will appear above my site
  358. horizon, to ensure that none of the track is missing on my star map.  Times
  359. can be UTC or local time, where local time is referenced to the zone hour of
  360. your site.
  361.  
  362. The duration of orbit propagation tells SKYMAP how far into the future to
  363. extend the orbital track.  For a single pass at a location, a half-hour to
  364. an hour is sufficient.  If you propagate too far into the future, you may
  365. end up plotting multiple passes unintentionally.
  366.  
  367. The resolution of the trajectory plot tells SKYMAP how frequently to calcu-
  368. late the satellite's position.  The shorter the time resolution, the longer
  369. it takes SKYMAP to run, but the smoother the track will look.  Tracks are
  370. fairly linear over 10-second periods, but if you are plotting a very small
  371. portion of the sky you will want even more frequent positional information.
  372. When selecting the resolution, you should also be thinking about how fre-
  373. quently you'll want the orbit time-tagged.  Timetags must occur at some
  374. integer multiple of the trajectory resolution.  (Note that timetags CAN
  375. occur at every trajectory point if desired).  As an example, if a satellite
  376. is going to take 30 seconds to cross your map, I would select a resolution
  377. of 1 second, and a timetag resolution of either 1 or 2 seconds.  Be careful
  378. not to select so short a time between tags that they begin to overlap one
  379. another.  With a little practice, you'll get a feel for these time-related
  380. inputs.
  381.  
  382.  
  383. Plot Title
  384. ----------
  385.  
  386. Once a trajectory is complete, SKYMAP gives you the option of adding
  387. more satellite tracks to the same map.  When you have no more tracks to
  388. add, enter No.  As with the star-only map, you can add a title below the
  389. plot.  The default title is the name of the last satellite you plotted.
  390. To select the default, hit return, or enter your own title.  Your last
  391. option is to save changes to your configuration file (the default is no).
  392. The program then ends, and your output file is ready to be plotted or
  393. rasterized and printed.
  394.  
  395.  
  396. Plotting Rocket Trajectories
  397. ----------------------------
  398.  
  399. This capability will be documented at a later time.  FIREBIRD.TRJ is a
  400. sample of what a rocket trajectory file should look like.
  401.  
  402.