home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 1: Amiga / FrozenFish-Apr94.iso / bbs / alib / d6xx / d680 / sattrack.lha / SatTrack / User.doc < prev    next >
Text File  |  1992-06-13  |  14KB  |  436 lines
  1. SatTrack User Manual
  2.  
  3. ====================
  4.  
  5. ======================================================================
  6. Copyright
  7.  
  8. ---------
  9.  
  10. SatTrack is keyware.  SatTrack may be freely redistributed without 
  11. change or modification.  It may be freely copied and distributed as 
  12. long as there is no charge above a nominal fee for media and copying.  
  13. SatTrack program and program files may not be  modified or changed for 
  14. personal use.  Please upload SatTrack, along with all files, to your 
  15. favorite BBS.  No  guarantee of any kind is given that the program(s) 
  16. described in this document are 100% reliable.  You are using this 
  17. material on your own risk.  SatTrack should not be modified.  SatTrack 
  18. is provided as key-ware, user registration is available. 
  19.  
  20.  
  21.  
  22. ======================================================================
  23.  
  24. Introduction
  25.  
  26. ------------
  27.  
  28. In recent years, many home computer enthusiasts have become interested 
  29. in satellite tracking.  Most of these trackers are amateur radio 
  30. operators who are attempting to make two-way radio contact with the 
  31. NASA Space Shuttle or the Commonwealth of Independent States' space 
  32. station, MIR.  Now, many people are attempting to track satellites  to 
  33. try and make visual contact.  The Shuttle can easily be tracked and 
  34. then seen, on a clear night, given the correct information, and this 
  35. program.
  36.  
  37.  
  38.  
  39. Hundreds of other satellites are orbiting the earth, many are visible 
  40. during the right conditions of location and the position of the sun.  
  41. The best viewing times are 1 hour before and after sun rise and sun 
  42. set.  
  43.  
  44.  
  45.  
  46. ======================================================================
  47.  
  48. SatTrack Features
  49.  
  50. -----------------
  51.  
  52. SatTrack is a full-featured Satellite tracking program which uses 
  53. mathematical formulas developed a hundred years ago.  The program 
  54. provides the ability to enter the numerical information needed to 
  55. track any satellite that orbits the Earth.  SatTrack can read both 
  56. standards of satellite input format, as well as allowing for entering 
  57. and modifying the information interactively.  SatTrack allows for 
  58. multiple databases, each with a capacity of 300 satellites.
  59.  
  60.  
  61.  
  62. SatTrack outputs the satellite information in several ways.  First it 
  63. can display the satellite information graphically on the Amiga screen.  
  64. The display can be saved as an IFF picture for printing and 
  65. modification using your favorite Amiga painting program (Dpaint, 
  66. DigiPaint or one several public domain painting programs.)   
  67. Information on satellites is also able to be written in a text form to 
  68. a file or printer suitable for report generation or text editors. 
  69.  
  70.  
  71.  
  72. SatTrack has the ability to simulate the tracking of a satellite from 
  73. the future or past.  This means that you can run SatTrack with a time 
  74. and date of your chosing, either in the future or in the past.  This 
  75. allows you to quickly generate tracking information for events at 
  76. other times.
  77.  
  78.  
  79.  
  80.  
  81.  
  82. ======================================================================
  83. SatTrack also has a mode that alerts the user when satellite(s) of 
  84. interest are within the range of possible viewing, or radio contact.
  85.  
  86.  
  87.  
  88. SatTrack is generally accurate to within about one half of a degree 
  89. for satellites that have been described up to a year ago.
  90.  
  91.  
  92.  
  93. ======================================================================
  94.  
  95. SatTrack Keyware and Registration Information
  96.  
  97. ---------------------------------------------
  98.  
  99. This program is provided as KEYWARE.  If you find the program useful 
  100. and would like a permanent license, and for information on future 
  101. updates and enhancements, you may become a registered user by sending 
  102. your name and address plus $20.00 to the author. (See the registration 
  103. information file included with this program.)
  104.  
  105.  
  106.  
  107. DEMO keys of SatTrack will not track as accurately as registered keys, 
  108. please beware of this when using DEMO keys.
  109.  
  110.  
  111.  
  112. Permission is granted for this software to be posted to bulletin 
  113. boards, or similar public and private transfer methods, as long as all 
  114. the files in the archive are kept intact.  Please copy it anywhere 
  115. that other Amiga users can be found. 
  116.  
  117.  
  118.  
  119. THIS SOFTWARE MUST NOT BE MODIFIED. MODIFICATION CAN RESULT IN 
  120. INCORRECT TRACKING OF THE SATELLITES.
  121.  
  122.  
  123.  
  124. ======================================================================
  125.  
  126. Getting started.....
  127.  
  128. Where to get information for tracking.
  129.  
  130. --------------------------------------
  131.  
  132. There are several great places that the needed information can be 
  133. found to allow for tracking of satellites using this program.    
  134. Keplerian (Kep for short) data is simply a set of numbers that 
  135. describe the position of the satellite at a particular time.  Below is 
  136. a list of some places to obtain this data.  They are updated weekly 
  137. and daily for shuttles. 
  138.  
  139.  
  140.  
  141. 1) An Amateur (ham) Radio Operator.  Kep data is broadcast over 
  142. several different mediums in the amateur community.  One is a digital 
  143. mode of communication call packet radio.  If you are a ham radio 
  144. operator, check with your local club or several good articles in QST 
  145. magazine.  If not, you could contact a local ham club in the area,  
  146. they will be more than happy to try to help you.
  147.  
  148.  
  149.  
  150. 2) Contact NASA/Goddard.  NASA provides a BBS that can be dialed up 
  151. using your computer to obtain Kep information of any unclassified 
  152. satellite.  For more Information contact NASA at:                
  153.                                                     
  154.         NASA/ Goddard Space Flight Center
  155.  
  156.         Project Operations Branch 513
  157.  
  158.         Attn: Orbital Information Group
  159.  
  160.         Greenbelt, MD 20771, USA
  161.  
  162.  
  163.  
  164. 3) Constant NASA/JSC  (Johnson Space Center) at their BBS.  To use the 
  165. BBS, call (713) 483-2500.  After connection to the modem, enter via 
  166. your computer, 62511.  This will connect to the BBS and allow you to 
  167. register.  At this writing, usage is free except for the toll of the 
  168. call.
  169.  
  170.  
  171.  
  172. 5) GEnie, BIX and Compuserve.  Users often provide information on 
  173. current satellites via astronomy or radio BBSs or round-tables.
  174.  
  175.  
  176.  
  177. 6) For shuttles, call the WA3NAN Goddard Radio Club at (301) 286-6673
  178.  
  179.  
  180.  
  181.  
  182.  
  183. ======================================================================
  184.  
  185. Keyware and License information
  186.  
  187. -------------------------------
  188.  
  189. SatTrack is provided as KEYWARE.  KEYWARE is intended to provide you 
  190. the best demonstration of the features of the program while still 
  191. allowing for the support for further development.  KEYWARE relies on a 
  192. set of "keys" in a file that are verified by the program.  Each set of 
  193. keys is specific to the user.   This tends to prevent the distribution 
  194. of the software by licensed users, since the user's name, address and 
  195. phone number is displayed during the startup of the program.  DEMO 
  196. keys are provided which will work but contain an expiration date.  The 
  197. SatTrack program will not operate after that date.  DEMO keys also 
  198. cause SatTrack to be more and more inaccurate as time goes on. 
  199. (Registered users receive keys that NEVER expire, will work on ANY new 
  200. versions and have NO REDUCTION IN ACCURACY over time)   If you are 
  201. interested in obtaining a registered set of keys, order early.
  202.  
  203.  
  204.  
  205. A short assessment of KEYWARE is provided:    
  206.  
  207. o Full features available, no disabled features in the demo.
  208.  
  209.  
  210.  
  211.  
  212.  
  213. o Copy protected via the display of the Licensees name and phone 
  214. number.  This tends to make users less likely to "loan" the 
  215. software to other people when they cannot be sure that they will 
  216. not in turn "loan" it to other people.  Resulting in pirated 
  217. software with YOUR name on it.  Don't loan your license keys to 
  218. anyone, don't take the risk.
  219.  
  220.  
  221.  
  222. o Registered users can get new versions automatically via GEnie, BBS 
  223. and other telecommunication methods.  This assures the registered 
  224. users' quick bug fixes since the author does not have to mail out 
  225. copies to all the users.  A new version can be installed using 
  226. original set of registered keys, a registered user can obtain new 
  227. version SatTrack via any means.  
  228.  
  229.     
  230.  
  231. o Software key protection can be broken, if you have knowledge of:
  232.  
  233.     Keplerian Orbital Mechanics, 68000 machine code, Key technology and 
  234. any tricks by the author.  Amiga users are some of the greatest 
  235. computer enthusiast in the world, only a certain type person can 
  236. fully understand the Amiga; a person like you.  If you think you 
  237. are qualified enough to break the protection schema of SatTrack, 
  238. think about this;  The efforts should take several hours at best.  
  239. The completion of the task is always uncertain.  If think you can 
  240. break in, consider spending your time producing a useful 
  241. contribution to the Amiga.  If you need ideas, give me a call, I 
  242. have many.  I don't have the time to produce them all, maybe you 
  243. can!
  244.  
  245.     
  246.  
  247. CAUTION: attempting to change the keys or the address information will 
  248. cause the program to abort or change several geographical or physical 
  249. values resulting in incorrect tracking.   DEMO keys will cause the 
  250. program to become less accurate as time goes on.  Consider becoming a 
  251. registered user.
  252.  
  253.  
  254.  
  255. ======================================================================
  256.  
  257. License information
  258.  
  259. ORDER INFORMATION:
  260.  
  261. ------------------
  262.  
  263. There are two options when registering for permanent personalized  
  264. keys.  Personalized keys are all that you need to operate SatTrack.  
  265. The SatTrack software will recognize that your new keys are permanent 
  266. and enable all the features and accuracy required for tracking.  
  267.  
  268.  
  269.  
  270. Registration is $20 USA.  Include your name, address and phone number 
  271. along with registration fees to:
  272.  
  273.  
  274.  
  275.             Randy Stackhouse
  276.  
  277.             4 Sinclair Cir.
  278.  
  279.             Indialantic, Fla USA.
  280.  
  281.                 32903
  282.  
  283.  
  284.  
  285. You will receive via US mail, information on how to install the keys 
  286. that are also provided.  Addresses and phone numbers must be 
  287. verifiable.  Include unlisted numbers,  they will not be resold or 
  288. released.
  289.  
  290.  
  291.  
  292. Optionally, include your GEnie, BIX or Compuserve address or fax 
  293. number.  If possible I will send the keys to you via these modes since 
  294. they are usually faster than regular mail.
  295.  
  296.  
  297.  
  298. If you wish the most recent version of SatTrack, send a total of 30$ 
  299. US.  This assures you the latest version of SatTrack and all needed 
  300. files, including your personalized keys all delivered on a disk. 
  301.  
  302.  
  303.  
  304. If you are outside of the United States, you must consider and include 
  305. any extra postage required for delivery of your registration 
  306. information.  Include any special mailing instructions that are 
  307. required for outside of the US.  
  308.  
  309.  
  310.  
  311. Remember that a registered user will receive keys that never expire 
  312. and will work on all future versions of SatTrack, regardless of the 
  313. version.
  314.  
  315.  
  316.  
  317.  
  318.  
  319. ======================================================================
  320.  
  321. Features
  322.  
  323. --------
  324.  
  325. SatTrack is the most full featured satellite tracking program for the 
  326. Amiga.  It tracks up to 300 satellites and allows for a graphic 
  327. display containing the entire world.  The display also includes text 
  328. information on any satellites in the data base.
  329.  
  330.  
  331.  
  332. ======================================================================
  333.  
  334. Display(s)
  335.  
  336. ----------
  337.  
  338. SatTrack is fully compatible to Amiga graphics.  All maps can be 
  339. edited using any Amiga paint program.  This allows the user to tailor 
  340. the map to the desired color or include drawing information of 
  341. interest.  Colors can be edited using any IFF paint program such as 
  342. DigiPaint or Deluxe Paint.  Two sets of colors are possible.  One set 
  343. describes the colors for screen display and one set is described for 
  344. file saving. 
  345.  
  346.  
  347.  
  348. SatTrack allows the user to choose from three world views.  Each view 
  349. is centered about a different position on the earth to allows the user 
  350. to view the world with the area of interest in the center of the 
  351. screen.
  352.  
  353.  
  354.  
  355. Displays can be saved at user request to an IFF file.  This file can 
  356. be edited by a paint program to add the desired graphical and text 
  357. information desired before printing.   
  358.  
  359.  
  360.  
  361. ======================================================================
  362.  
  363. Kep Editing
  364.  
  365. -----------
  366.  
  367. Satellite tracking actually requires very little information.  
  368. Satellite orbits can be described with only 11 numbers.  These numbers 
  369. describe the position of the satellite at a specific time.  SatTrack 
  370. can edit and process the information to calculate the expected 
  371. position of the satellite at the present time or some time in the 
  372. future.  
  373.  
  374.  
  375.  
  376. SatTrack provides several methods of entering the satellite 
  377. information.  Users can input the data manually via Amiga Windows or 
  378. by downloading the information from a file in one of two standard 
  379. formats.    
  380.  
  381.  
  382.  
  383.  
  384.  
  385. ======================================================================
  386.  
  387. QTH (Your Location) Editing
  388.  
  389. ---------------------------
  390.  
  391. SatTrack allows input of the user's geographic location.  This 
  392. location is used to provide details about the satellite relative to 
  393. your position. 
  394.  
  395.  
  396.  
  397. The editing of your location also accepts information about the  
  398. offset in hours from Greenwich Mean Time (also called Universal 
  399. Coordinate Time, or ZULU time).  All times output by SatTrack are 
  400. presented in the users local time.  Users that desire to use GMT may 
  401. enter an offset of zero. 
  402.  
  403.  
  404.  
  405. ======================================================================
  406.  
  407. Time Editing
  408.  
  409. ------------
  410.  
  411. SatTrack has two tracking modes, called Real-time and Simulation.  The 
  412. Real-time mode provides tracking of the satellite at its current 
  413. position based on the Amiga clock.  During real-time tracking, the 
  414. user can control the speed at which each satellite is displayed. This 
  415. control allows for better viewing of the text information on the 
  416. display.  Simulation mode allows the user to select the starting time 
  417. and ending time for tracking.  The times selected can be any time of 
  418. interest as chosen by the user.  During simulation mode, the user can 
  419. also select the interval that each satellite text is displayed as well 
  420. as indicating the amount of time SatTrack should increment.  This 
  421. control allows for faster tracking of a satellite.
  422.  
  423.  
  424.  
  425. ======================================================================
  426.  
  427. Flashs and Beeps
  428.  
  429. ---------------
  430.  
  431. SatTrack provides an alarm function.  The alarm function will beep or 
  432. flash the display when a satellite is within visible view of your 
  433. location.  This feature can be used to help the user realized when the 
  434. satellite that is being tracked can be seen or communicated with. 
  435.  
  436.