home *** CD-ROM | disk | FTP | other *** search
/ Hacker Chronicles 2 / HACKER2.BIN / 435.README < prev    next >
Text File  |  1993-05-27  |  12KB  |  231 lines

  1.                              ALERT3V5.ZIP  ver 5.1
  2.  
  3.   Version 5.1 corrects minor bugs in 5.0 version plus refinement of README file
  4.  
  5.                     written for DOS systems in QBasic v 1.0
  6.                      (c)1992,1993 by John W. Gardner, Jr.
  7.  
  8.               Requires Traufler's TRAKSAT program ver 2.75 or 2.80
  9.  
  10.                                 *** PURPOSE ***
  11.  
  12.   Program is designed to alert you by screen display & sound when scheduled
  13.   satellites are visible in REAL time.  This relationship is in part determined
  14.   by your location as specified in Paul Traufler's TRAKSAT.DEF file.
  15.  
  16.   The primary purpose of this program is to remind you, when about 10 of your
  17.   favorite satellites, are favorably positioned while YOU are busy doing
  18.   something else.  The secondary purpose, is to generate a listing of ALL sats,
  19.   in chronological order, based on parameters HEAVILY dependent on visibility
  20.   as defined by YOUR situation.  If no limitations are entered, ALL sats
  21.   greater than 1° above the horizon will be "looked" for - in real time.
  22.  
  23.   If you want to play "marathon" with as many satellites as possible.  Program
  24.   will tell you when any of the +3000 primary orbiting payloads & rocket bodies
  25.   are site visibly positioned ( This assumes, of course, you have a current
  26.   element file of those objects. ).  Based on the time/date of TRAKSAT program
  27.   execution, a maximum of about 1000 objects per night could be found.  It must
  28.   be said though, do not attempt this unless your an experience Sat observer
  29.   AND have at least 5 MB of disk space (based on 30 sec steps) to support it.
  30.  
  31.   ALERT3.BAS has a program limitation of about 1400 objects for any given time
  32.   frame AFTER filters for elevation, Sat visibility, obstructions & observation
  33.   session are piped through per your specs.
  34.  
  35.                              *** IMPROVEMENTS ***
  36.  
  37. 1 Accepts output file directly from TRAKSAT without any editing and run in real
  38.   time regardless of speed of computer it is used on.
  39.  
  40. 2 Calculates and displays UTC for your time zone based on system clock.  System
  41.   clock will NOT be changed by this program - only makes reference to it.  If
  42.   program is told your system is set to UTC, program accepts it.
  43.  
  44. 3 Allows you to define a section of the sky ( horizon to zenith ) were high
  45.   buildings or nearby trees block your view which the program will ignore.
  46.  
  47. 4 Provides running total of how many scheduled satellites remain to be seen
  48.   based on viewing parameters you entered.
  49.  
  50. 5 Provides preview of what satellite is next and time.
  51.  
  52. 6 Program now displays the previous satellite just in case two are found less
  53.   than a second apart.  Also if 30 sats are detected as visible at the same
  54.   time, program will look "back" and display next item(s) that were visible
  55.   prior to the current UTC time.  For this contingency, user should have a
  56.   printout of SAT_VIEW.FIL file defined further below.
  57.  
  58. 7 Program will exit to DOS prompt while displaying the last satellite(s) found.
  59.  
  60. 8 Default for minimum viewing elevation is 15°.  User can raise or lower this
  61.   figure as desired.  Obviously, it is of little use to try to see satellites
  62.   that are buried in horizon gunk.
  63.  
  64. 9 Prompts you for the time period you wish to observe.  It is suggested that an
  65.   observation session start early in order to see as many of the lower "bright"
  66.   satellites as possible before Earth shadow.  There is no program default as
  67.   selections MUST be made.  This allows all satellites NOT appearing during
  68.   your observation session, as defined, to be dumped.
  69.  
  70.                              *** INSTRUCTIONS ***
  71.   
  72.   The file SAT_VIEW.FIL is a control file created and used by ALERT3.BAS based
  73.   on the TRAKSAT output file.  You may wish to abort the program WHEN system
  74.   time is displayed to review the listing of all satellites, in chronological
  75.   order, as they would appear per your viewing parameters.  You MUST run the
  76.   program prior to observation session for this purpose.  IF aborted during the
  77.   ACTUAL observation session, the file MUST be edited to reflect current or
  78.   future UTC time at restart.  See warning below.
  79.  
  80.   Note that times entered are based on UTC 24 hour clock and must be on the
  81.   hour times.  Additionally, all hour times are expressed as two digits: 4am is
  82.   04, 9pm is 21 ect....  Start ALERT3.BAS at any time of day or just prior to
  83.   first satellite AFTER the TRAKSAT output file is created.  See warning below.
  84.   
  85.   File can be printed out as a visual guide for use in the field instead of
  86.   just watching the program.  Being in chronological order makes it easy to see
  87.   what's next.  I highly recommend you do this even if your "field" is your
  88.   back porch.  It saves repeatedly running back and forth to the computer each
  89.   time you hear the "beep" of satellite now visible.  You could also terminate
  90.   the program and rely only on your watch and the printout.
  91.  
  92.   Each prompt for input is fully descriptive to the point that you only need
  93.   to read this file once to fully understand its purpose.
  94.  
  95.              ***  SELECTING ELEMENT FILE TO USE FOR TRAKSAT  ***
  96.  
  97.   You, of course, have the option to use any element file or portion thereof
  98.   instead of the following procedure.  You could also use the User Defined
  99.   Satellite Names listing ( up to 25 objects) in the TRAKSAT.DEF file itself,
  100.   with respect to the defined default data (element) file.
  101.  
  102.   Run my FINDSAT5.BAS to create a element file of your favorite sats.  If you
  103.   have a listing of NORAD objects ( 16609U ) you'll like to see, FINDSAT5.BAS
  104.   will use that listing instead of prompting you for each selection.
  105.  
  106.   If your using your entire element file, I highly recommend you create a file
  107.   having only primary and selected debris objects - no decayed items.  Use
  108.   13 part NORCATxx.ZIP by Joel Runes for all objects or Kelso's SATDB-12.ZIP
  109.   file for payloads only as a guide.
  110.  
  111.   The NEWSET.SZN file (or your element file) will be used by Traufler's TRAKSAT
  112.   program to create the input file ( TRAKSAT.xxx ) used by ALERT3.BAS ver 5.1
  113.  
  114.  
  115.  
  116.  
  117.             ***  PROCEDURE TO CREATE TRAKSAT BATCH MODE FILE  ***
  118.  
  119.   Make sure that your system clock time agrees with TRAKSAT.DEF file setting
  120.   for standard time, daylight saving time (-5 or -4 for the east coast U.S.A.)
  121.   or if your clock is set to UTC as 0.  VERIFY YOUR SYSTEM DATE IS CORRECT!
  122.  
  123.   If you wish to get a small jump on the satellites, setting your system clock
  124.   forward 1 minute PRIOR TO RUNNING TRAKSAT will have not effect program's
  125.   accuracy.  So long you are aware you've done so!  See warning below.
  126.  
  127.   Be advise ALERT3.BAS is not intended for any Earth shadow appearance timing.
  128.  
  129.   To create an BATCH MODE file for "tonight" ( defined as today's sunset to
  130.   sunrise observation period ), use the following steps for each of the menu
  131.   headings shown by your TRAKSAT program.  NOTE: New users of TRAKSAT should
  132.   follow parameters below as a guide before branching to more defined usage.
  133.  
  134.     ACCURACY OF YOUR ELEMENT SETS PLUS TRAKSAT ALGORITHMS HAVE DIRECT EFFECT
  135.     ON POSITIONS OF SATELLITES RELEVANT TO TIME.  A SATELLITE CAN & IN MANY
  136.     CASES WILL BE EITHER A FEW MINUTES EARLY OR LATE.  BE PREPARED - BE READY.
  137.  
  138.   FILE  ( Skip the file section if your using a pre-defined element file )
  139.  
  140.      select NEW SATELLITE FILE
  141.  
  142.      enter  element set file name  ( NEWSET.SET if you've used FINDSAT5.BAS )
  143.                                     Your file must be in the same directory as
  144.                                     TRAKSAT.  TRAKSAT does not see paths.
  145.  
  146.   TIME MODE
  147.  
  148.      select DELTA
  149.  
  150.      enter  05/29/93     If it is dark PRIOR to 00 hour UTC, use today's date,
  151.                          otherwise use tomorrow's date.
  152.  
  153.      enter  00:50:00     as UTC start time ( 22:30:00 in the dead of winter )
  154.                          First Sat visibility time is directly related to date
  155.                          and of course your location.  Example shown = 8:50pm
  156.                          DST in month of May east coast U.S.A.
  157.  
  158.      enter  00:06:00:00  as length of simulation ( can be user specified ).
  159.                          The use of a "long" period allows you to restart the
  160.                          program or consult SAT_VIEW.FIL for the early morning
  161.                          sats after a quick edit of the file.  Or for any time
  162.                          frame desired if conditions warrant such a change.
  163.  
  164.      enter  0.50000      as time steps ( can be user specified ) = 30 seconds
  165.                          I don't recommend time steps greater than 1.025000
  166.                          ( 1 minute 15 secs ), nor less than 30 seconds in
  167.                          conjunction with ALERT3.BAS program.
  168.  
  169.   OUTPUT
  170.  
  171.      select  Single Satellite
  172.      select  Batch Mode
  173.      select  All Satellites    OR select "User Defined Satellites" if you've
  174.                                created such a listing in TRAKSAT.DEF file.  See
  175.                                note about this on page 24 of TRAKSAT.DOC file.
  176.  
  177.      select  File      ( for output )
  178.  
  179.   VISIBILITY
  180.  
  181.      select  Visible Passes
  182.      select  Optical
  183.      select  -6 (civil)    default is -12 (nautical)  - can be user specified
  184.              There are cases that you'll miss notification of some spectacular
  185.              (bright) views if you always use the default -12 setting.  My own
  186.              view is better to miss a few duds than a hot one.  COSMOS 2237 R/B
  187.              on 5/29/93 at 01:35 UTC is one example for my location.
  188.  
  189.   A demonstration SAT_VIEW.FIL file of 85 objects for the night of May 28, 1993
  190.   ( 0055 to 0648 hours UTC ) is ready to load and run by ALERT3.BAS.  Minimum
  191.   elevation for Sat notification is 10°.  Press ENTER at prompt for file name.
  192.  
  193.   
  194.   * W A R N I N G *            * W A R N I N G *            * W A R N I N G *
  195.  
  196.  
  197.  PROGRAM MUST BE UP AND RUNNING AT LEAST 1 MINUTE PRIOR TO THE FIRST SATELLITE
  198.  Just as an alarm clock will miss-function set incorrectly...the same applies.
  199.  You should know by prior review of the SAT_VIEW.FIL file when the first Sat is
  200.  due.
  201.  
  202.  Verify that your system date is correct and that the system time is accurate
  203.  within a minute of civil or UTC time.
  204.  
  205.                            ***  IF YOU BLEW IT  ***
  206.  
  207.  You started the program AFTER the first satellite was due...
  208.  
  209.  Simply edit out the top lines of the SAT_VIEW.FIL file of the satellites
  210.  that have already ( or will pass ) while the program was off line.  This is
  211.  easily done by looking at the time display ( 01:44:38 ) which is UTC time
  212.  *NOT* LOCAL time.  Save the file and press ENTER only at file name prompt.
  213.  Should take you less than a minute and your back in business!!
  214.  
  215.  IF you have NOT created the SAT_VIEW.FIL file, run the program from the start
  216.  with input of the TRAKSAT.xxx file.  Abort by pressing  F1  key when system
  217.  UTC time is displayed.  Follow the instructions above for editing.
  218.  
  219.  No TRAKSAT file prepared?  You should select the next hour to start your
  220.  observation session.  The only reason for this is to give yourself time to
  221.  review the listing without being "pushed" by the clock - else edit per above.
  222.  
  223.                               ***  FUTURE  ***
  224.  
  225.   A version for the QUICKSAT tracking program will be released as soon as
  226.   Walter Nissen "instructs" me on the various nuances of using it.
  227.  
  228.  
  229.   John W. Gardner, Jr.
  230.   May 27, 1993
  231.