home *** CD-ROM | disk | FTP | other *** search
/ World of Ham Radio 1997 / WOHR97_AmSoft_(1997-02-01).iso / windows / win_31 / amsoft.iii next >
Text File  |  1997-02-01  |  40KB  |  1,393 lines
  1.  
  2.  
  3. ORBTRACK 1.0A
  4.  
  5. For Windows
  6.  
  7. Shareware Release
  8.  
  9.  
  10.  
  11. Users Guide
  12.  
  13.           
  14.  
  15. Windows Software for Tracking Amateur Radio Satellites
  16.  
  17.  
  18.  
  19. KE9PU Software
  20.  
  21.  
  22.  
  23. ORBTRACK for Windows - Version 1.0A  
  24.  
  25. Shareware Release
  26.  
  27.  
  28.  
  29. (C) Copyright 1994 Albert E. Kolvek Jr
  30.  
  31. KE9PU Software
  32.  
  33.  
  34.  
  35. All Rights Reserved
  36.  
  37.  
  38.  
  39. This software may be copied for your personal use and
  40. may be distributed for use by others as long as the program
  41. credits are maintained.
  42.  
  43.  
  44.  
  45. Information in this manual is subject to change
  46. without notice and does not represent a commitment on the part
  47. of KE9PU Software.
  48.  
  49.  
  50.  
  51. KE9PU Software may make improvements and/or changes
  52. in this manual and/or in ORBTRACK at any time.
  53.  
  54.  
  55.  
  56. This program has been scanned for viruses before
  57. release to the public.  The creator of ORBTRACK assumes no
  58. liabilities for damage to the end user's computer system or
  59. other equipment where this product may be installed.   Release
  60. 1.0A of ORBTRACK is issued to the general public under the
  61. Shareware concept.  The user assumes all responsibilites in
  62. using this program.
  63.  
  64.  
  65.  
  66. Through this manual are commercial names of products
  67. or services rendered by other manufactures or developers.  Many
  68. of these product or service names are either registered or
  69. unregistered trademarks of their manufacturers or developers. 
  70. The owners of these trademarks have never expressed any approval
  71. or disapproval of KE9PU Software products.
  72.  
  73.  
  74.  
  75. Windows 3.1 (C) Copyright 1985-1992, Microsoft Corp.
  76.  
  77.  
  78.  
  79. Table of Contents
  80.  
  81.  
  82.  
  83.      Chapter 1:  Introduction to ORBTRACK 1.0A for
  84. Windows.............1
  85.  
  86.  
  87.       Overview..................................................
  88. .....................   1
  89.  
  90.  
  91.  
  92.      Chapter 2: ORBTRACK
  93. Installation.............................................       2
  94.  
  95.        Installation..............................................
  96. ......................  2
  97.  
  98.          Required
  99. Files............................................................
  100. ...     3
  101.  
  102.  
  103.  
  104.      Chapter 3: ORBTRACK Main
  105. Screen...........................................4
  106.  
  107.          Screen
  108. Sections.........................................................
  109. ..      4
  110.  
  111.          Program Function
  112. Controls............................................    4
  113.  
  114.          Add Target Control
  115. Button.............................................     5
  116.  
  117.          Remove Target Control
  118. Button.......................................   5
  119.  
  120.          Ground Station
  121. Control..................................................       6
  122.  
  123.          System Setup
  124. Control...................................................      7
  125.  
  126.          Exit
  127. Control..........................................................
  128. ........        7
  129.  
  130.          Minimizing
  131. OrbTrack.....................................................   7
  132.  
  133.          Display Grids Control
  134. Panel...........................................        8
  135.  
  136.          Target Display Control
  137. Panel.......................................... 9
  138.  
  139.          Ground Station
  140. Panel....................................................       10
  141.  
  142.          Target Tracking Data
  143. Display.........................................        10
  144.  
  145.          Target
  146. Icons............................................................
  147. .....   11
  148.  
  149.  
  150.  
  151.      Chapter 4: Target Elements
  152. Editor..............................................    12
  153.  
  154.          Element Editor Control
  155. Buttons......................................   13
  156.  
  157.          Element Set
  158. Fields........................................................  14
  159.  
  160.          Element Set Data
  161. Sources.............................................    16
  162.  
  163.  
  164.  
  165.      Chapter 5: Ground Station
  166. Editor................................................  17
  167.  
  168.          Ground Station Editor Control
  169. Buttons............................     18
  170.  
  171.          Ground Station
  172. Fields....................................................      19
  173.  
  174.  
  175.  
  176. Chapter 1:  Introduction to ORBTRACK 1.0A for Windows
  177.  
  178.  
  179.  
  180. Overview
  181.  
  182. This manual contains information for the use of
  183. ORBTRACK 1.0A for Windows.  It provides the user with:
  184.  
  185.  
  186.  
  187.      Instructions on installing the program on your hard
  188. disk.
  189.  
  190.  
  191.  
  192.      Familiarizes the user with the operation of the
  193. program.
  194.  
  195.  
  196.  
  197.      Explains the main display controls and buttons.
  198.  
  199.  
  200.  
  201.      Explains how to install and remove tracking targets
  202. (satellites).
  203.  
  204.  
  205.  
  206.      Explains how to setup your ground (Tracking)
  207. station indicator.
  208.  
  209.  
  210.  
  211.      Explains the target and ground station data editors.
  212.  
  213.  
  214.  
  215. The rest of this chapter covers the various aspects
  216. of the ORBTRACK system.
  217.  
  218.  
  219.  
  220. ORBTRACK is a Windows based satellite tracking
  221. program.  The program will track up to eight targets
  222. (Satellites) at once.  Information about the targets are
  223. continuously updated each second.  Tracking continues even if
  224. the program is minimized to an icon.  The user has the option to
  225. set an audible alarm to be sounded when the target comes "In
  226. Range" of the ground  or tracking station.
  227.  
  228.  
  229.  
  230. Each target is represented on the map as an icon. 
  231. Each icon generally represents the physical shape, or type,  of
  232. the target being tracked.  The program has six predefined icons
  233. that the user can manually assign to a specific target type or
  234. shape.  The targets can be "Tagged" for easy location and
  235. identification on the display.  To help the user further to
  236. locate many targets on the display against the background, the
  237. program provides a target blink display function.  The blink
  238. function tends to draw the eye faster to the targets on the
  239. screen.
  240.  
  241.  
  242.  
  243. The program comes with hundreds of preloaded ground
  244. station coordinates.
  245.  
  246.  
  247.  
  248. Dozens of satellite orbital elements are included in
  249. this package to get the user started.  Orbital Keplerian
  250. Elements have been loaded for all amateur radio satellites and
  251. the Russian space station MIR.  These orbital elements will need
  252. to be updated on a regular basis to compensate for programmed
  253. orbit changes, atmospheric changes and other conditions that
  254. effect the satellites.
  255.  
  256.  
  257.  
  258. Chapter 2: ORBTRACK Installation
  259.  
  260.  
  261.  
  262. ORBTRACK 1.0A for Windows will only run using
  263. Microsoft Windows 3.1.  The program is not guaranteed to be free
  264. of bugs if run on Windows 3.0.  As of the time of publication,
  265. "Chicago" (Windows 4.0?) has not been released and as a result,
  266. the program has not been checked using this platform.
  267.  
  268.  
  269.  
  270. ORBTRACK 1.0A will need about 1.5Mb of disk space to
  271. be loaded to.  Several of the files need to be inserted into the
  272. WINDOWS and WINDOWS\SYSTEM subdirectories.  The SETUP program
  273. included in this disk will need to have access to these
  274. subdirectories.
  275.  
  276.  
  277.  
  278. For proper operation of this program, the dos program
  279. SHARE must be included in your CONFIG.SYS or AUTOEXEC.BAT file. 
  280. The SHARE program must be installed with the /F:500 option
  281. command switch included.
  282.  
  283.  
  284.  
  285. For Example; In your AUTOEXEC.BAT file the command
  286. should look like this: 
  287.  
  288. SHARE /F:500
  289.  
  290.  
  291.  
  292. Installation
  293.  
  294. Installation of ORBTRACK is simple.  Each dialog box
  295. in the installation process is clear and self-explanatory; 
  296. Follow each of the on-screen instructions and prompts.
  297.  
  298.  
  299.  
  300. To install ORBTRACK 1.0A for Windows:
  301.  
  302.  
  303.  
  304. 1.   Insert the Program Disk into the proper diskette
  305. drive.
  306.  
  307.  
  308.  
  309. 2.   With Windows running, click on "File" in the
  310. Program Manager screen.
  311.  
  312.  
  313.  
  314. 3.   Click on "Run.." in the pull down menu.
  315.  
  316.  
  317.  
  318. 4.   Type A:SETUP or B:SETUP into the Command Line text
  319. box.
  320.  
  321.  
  322.  
  323. 5.   Click on OK or press Enter
  324.  
  325.  
  326.  
  327. ORBTRACK Setup will now install the program modules,
  328. create the Program Manager Group and Program Properties for you
  329. and get you ready to run.
  330.  
  331. The SETUP program is preloaded with /ORBTRACK as the
  332. installation subdirectory.  If you do not want to have the
  333. program installed in this one, enter  the path name for the
  334. subdirectory of your want and click on OK.  
  335.  
  336.  
  337.  
  338. SETUP will finish installing the software and check
  339. the CONFIG.SYS and/or AUTOEXEC.BAT files for the presents of
  340. SHARE /F:500.  If the share command cannot be found, the SETUP
  341. program will display a message box informing you that SHARE
  342. needs to be installed.  Consult you DOS Users Guide for
  343. instructions on how to install SHARE.
  344.  
  345.  
  346.  
  347.  
  348.  
  349. Required Files
  350.  
  351.  
  352.  
  353. The following list are the files distributed in this
  354. package:
  355.  
  356.  
  357.  
  358. File Name            Usage                   Destination Directory
  359.  
  360. GRID.VB_             Program Support File    WINDOWS/SYSTEM
  361.  
  362. MSMASKED.VB_ Program Support File    WINDOWS/SYSTEM
  363.  
  364. SPIN.VB_             Program Support File    WINDOWS/SYSTEM
  365.  
  366. THREED.VB_           Program Support File    WINDOWS/SYSTEM
  367.  
  368. MSAES110.DL_         Program DLL File        WINDOWS/SYSTEM
  369.  
  370. MSAJT110.DL_         Program DLL File        WINDOWS/SYSTEM
  371.  
  372. VBDB300.DL_          Program DLL File        WINDOWS/SYSTEM
  373.  
  374. SHARE.EX_            SHARE Program   WINDOWS/SYSTEM
  375.  
  376. ORBTRACK.EX_ OrbTrack Program        ORBTRACK
  377.  
  378. CITYS.LD_            Ground Station Data     ORBTRACK
  379.  
  380. CITYS.MD_            Ground Station Data     ORBTRACK
  381.  
  382. SATS.LD_             Target Elements Data    ORBTRACK
  383.  
  384. SATS.MD_             Target Elements Data    ORBTRACK
  385.  
  386. SATx.IC_             Target Icons 1-6 Files  ORBTRACK
  387.  
  388. ORBTRACK.CF_ OrbTrack Config File    ORBTRACK
  389.  
  390. SETUP.EXE            Installation Program    None
  391.  
  392. VER.DL_              Program DLL File        WINDOWS/SYSTEM
  393.  
  394. SETUPKIT.DL_         Installation DLL File   None
  395.  
  396. VBRUN300.DL_ Program DLL File        WINDOWS/SYSTEM
  397.  
  398. SETUP.LST            Installation Support    None
  399.  
  400. SETUP1.EX_           Installation Program    None
  401.  
  402. ORBTRACK.WR_ Documentation           ORBTRACK
  403.  
  404. README.1S_           Read Me First File      ORBTRACK
  405.  
  406.  
  407.  
  408. Don't forget to install: SHARE /F:500 !!
  409.  
  410.  
  411.  
  412.  
  413.  
  414. Chapter 3: ORBTRACK Main Screen
  415.  
  416.  
  417.  
  418. Screen Sections
  419.  
  420.  
  421.  
  422. The main screen is divided into six sections.  Each
  423. section either controls a display option or provides current
  424. tracking information.   All data is updated once a second.  You
  425. have may display options to choose from and options are placed
  426. into sections.  Each section will be covered individually in
  427. this chapter.
  428.  
  429.  
  430.  
  431. Program Function Controls
  432.  
  433.  
  434.  
  435. This section controls which targets are to be
  436. tracked, selects the ground tracking station and controls access
  437. to the target and ground station editors.  To activate a control
  438. move the mouse to the control and click once.  If the control
  439. you clicked on has options, click on the down-arrow button that
  440. appears below the control itself.
  441.  
  442.  
  443.  
  444. To cancel one of the Program Function buttons just
  445. click on the same one or click on another control button.  You
  446. may also use the TAB key to select various buttons but you will
  447. not be able to tab over to each buttons list section.
  448.  
  449.  
  450.  
  451. Add Target Control Button
  452.  
  453. Selecting this program function will allow you to add
  454. a target to the tracking screen.  Clicking on this control
  455. button activates a pull-down list from which you may select the
  456. satellite you want to track.  Click the Down-Arrow button to
  457. display the list of targets in the database.  Select the target
  458. you want by clicking on the name of the satellite.  You may have
  459. to scroll through the list by using the scroll buttons or you
  460. can drag the slider tab button till to one you want appears in
  461. the window.
  462.  
  463.  
  464.  
  465. If you select a target from the list that is already
  466. on the screen the program will notify you in a window that a
  467. duplicate has been chosen.  The program will limit you to a
  468. total of eight targets to be displayed at one time.  If you try
  469. to select more than eight targets, the system will pop-up an
  470. error window to inform you of your selection.
  471.  
  472.  
  473.  
  474. Targets currently on the screen will not be affected
  475. by changes made to the element database until they are first
  476. removed and then re-installed on the display screen.  Even
  477. exiting the program and re-executing it will not change the
  478. targets to the new element set.
  479.  
  480.  
  481.  
  482. All element data is stored in the file called
  483. SATS.MDB and SATS.LDM.  These files should be backed up after
  484. every element update in the event of a system failure.  The
  485. Element files can be accessed via the Microsoft program call
  486. ACCESS.
  487.  
  488.  
  489.  
  490. Remove Target Control Button
  491.  
  492. Click on this control button to remove any target
  493. currently being tracked on the display.  Selecting this function
  494. will bring up a pull-down list that contains only the targets
  495. currently being displayed.  You may select the target to remove
  496. by clicking on the name in the list box.
  497.  
  498.  
  499.  
  500. Note: Removing a target only removes it from the
  501. display - not from any database.  You must use the target editor
  502. to remove a target from the database.  See section xx.x for
  503. instructions on how to remove a targets elements from the
  504. database.
  505.  
  506.  
  507.  
  508. Ground Station Control
  509.  
  510. This control button is used to select location
  511. parameters for the tracking station.  Information is kept on
  512. file about the stations name, latitude, longitude, height above
  513. sea level, UTC time correction and minimum target elevation
  514. requirements.  The buttons pull-down list has the ability to
  515. search the list of ground station based on the number of
  516. characters entered in the text box portion of the pull down menu.
  517.  
  518.  
  519.  
  520. To select a different ground station, first click on
  521. the ground station control button.  Next, click on the pull-down
  522. menu down-arrow button.  The program will display an
  523. alphabetical listing of all stations in the database.  You now
  524. have the option of using the scroll bars to move through the
  525. list or you can click in the text box part of the pull-down menu.
  526.  
  527.  
  528.  
  529. To select a ground station from the list using the
  530. scroll bars, scroll the list until the location you want
  531. appears.  You can now click on the name of the location
  532. displayed and the system will display the location of the ground
  533. station on the map.
  534.  
  535.  
  536.  
  537. To select a location using the text box portion,
  538. click on the text box part of the pull-down menu.  Start typing
  539. the name or first few characters of the location you want.  The
  540. program will scroll the station list so that the names match the
  541. characters you have typed in.  When the location you want
  542. appears in the pull- down list, click on it to make it the
  543. current location that the program will use.
  544.  
  545.  
  546.  
  547. If you select the same ground tracking station that
  548. is currently on the screen, that station and its parameters will
  549. be removed from the screen.  The program will use a default
  550. location of  0 degrees latitude and 0 degrees longitude.  A UTC
  551. correction of 0 hours is used as a default value.  The ground
  552. target icon is remove from the display indicating no ground
  553. target is selected.
  554.  
  555.  
  556.  
  557. When setting up or changing the location of the
  558. ground station the display will blink the new location of the
  559. ground target for a few seconds to let you locate it on the
  560. display.
  561.  
  562.  
  563.  
  564. You must remove and re-install the ground station
  565. selection after editing the stations parameters to make the
  566. changes appear in the display.  See section xx.x on editing
  567. ground station parameters. System Setup Control
  568.  
  569. This program function control button is used to
  570. access the target and ground station  database editors and
  571. general information about ORBTRACK.  Clicking on this control
  572. button pops up a pull-down menu were you can click on the editor
  573. or information you want.  
  574.  
  575.  
  576.  
  577. Click on the down-arrow button to display the
  578. editor/information selections.
  579.  
  580.  
  581.  
  582. Click on the Edit Ground Station to activate the
  583. ground tracking station editor.
  584.  
  585.  
  586.  
  587. Click on the Edit Target Elements to activate the
  588. Satellite Elements editor.
  589.  
  590.  
  591.  
  592. Click on About OrbTrack to display general
  593. information about the OrbTrack program.  To cancel the OrbTrack
  594. general information window click on the CANCEL button.
  595.  
  596.  
  597.  
  598. When using the editors or displaying OrbTrack
  599. information,  the display program is still running.  Target
  600. movements, proximity alarms all continue to function.  Each of
  601. the editors and the information displays can only be exited by
  602. there EXIT or, in the case of the information window, CANCEL 
  603. buttons.  Clicking on the main display portion of the screen
  604. will not remove or cancel any editor or information window.
  605.  
  606.  
  607.  
  608. Exit Control
  609.  
  610. Use this program control button to exit OrbTrack and
  611. go back to windows.  When exiting the program automatically save
  612. all current settings, targets and other internal parameters into
  613. the ORBTRACK.CFG file.  Restarting the program from windows
  614. restores the data back into the program.
  615.  
  616.  
  617.  
  618. If the program is started and the main display show
  619. garbage selections, delete the ORBTRACK.CFG file and restart the
  620. program.  If this occurs, you will have to reset the parameters
  621. back to their original settings.
  622.  
  623.  
  624.  
  625. Minimizing OrbTrack
  626.  
  627. The program is designed to continue to track targets
  628. even while minimized.  If you set the In Range Alarm option the
  629. program will alert you even if minimized.  This allows you to do
  630. other windows program while waiting to a satellite to come into
  631. range and be alerted when this happens.
  632.  
  633.  
  634.  
  635. To minimize the program to an icon click on the upper
  636. right window button.
  637.  
  638.  
  639.  
  640.  
  641.  
  642. Display Grids Control Panel
  643.  
  644.  
  645.  
  646. These option controls change the appearance of the
  647. latitude and longitude grid placement on the tracking display. 
  648. You may choose to or not to display one or both grids at all. 
  649. You can change the grid setting with or without the grids being
  650. visible.
  651.  
  652.  
  653.  
  654. Latitude On - Clicking this box will toggle the
  655. latitude grids on or off.  An "X" indicates that the grid is
  656. turned on.  The control arrows in the box below the latitude
  657. grid control adjusts number of horizontal grids displayed.  The
  658. settings are in degrees.  Settings available for you are; 10,
  659. 15, 30, 45 and 90 degrees.  The higher the degree setting, the
  660. fewer the grids displayed.  
  661.  
  662.  
  663.  
  664. To adjust the number of degree for the grid click on
  665. the up-arrow or down-arrow controls in the box.  Up-arrow will
  666. increase the degree value while the down- arrow decrease the
  667. degree value.  Either control will wrap the value if the next
  668. click will surpass the ranges specified.
  669.  
  670.  
  671.  
  672.  
  673.  
  674. Longitude On - Clicking this box will toggle the
  675. longitude grids on or off.  An "X" indicates that the grid is
  676. turned on.  The control arrows in the box below the longitude
  677. grid control adjusts number of vertical grids displayed.  The
  678. settings are in degrees.  Settings available for you are; 10,
  679. 15, 30, 45, 90 and 180 degrees.  The higher the degree setting,
  680. the fewer the grids displayed.  
  681.  
  682.  
  683.  
  684. To adjust the number of degree for the grid click on
  685. the up-arrow or down-arrow controls in the box.  Up-arrow will
  686. increase the degree value while the down- arrow decrease the
  687. degree value.  Either control will wrap the value if the next
  688. click will surpass the ranges specified.
  689.  
  690.  
  691.  
  692. The grid settings will be automatically save when you
  693. exit OrbTrack and restore when the program is executed from the
  694. Windows Program Manager.
  695.  
  696. Target Display Control Panel
  697.  
  698.  
  699.  
  700. This group of control options control the way targets
  701. are displayed on the screen and control visual and audible
  702. alarms when targets are within range of the ground station.  
  703. The target display options are turned on when an "X" appears in
  704. the checkbox.  Clicking on the desired option once will turn it
  705. on.  If already on, the option can be turned off by clicking on
  706. the option again.
  707.  
  708.  
  709.  
  710. Target I.D. - This option puts a label on the screen
  711. near each target and contains the name of the target within it. 
  712. This is very useful when tracking more than a few targets.   The
  713. labels will automatically shift positions when the target icons
  714. reach the limits of the display so that the I.D.'s will be
  715. always visible.
  716.  
  717.  
  718.  
  719. Target Blink - Setting this option will cause the
  720. target icons to blink once a second.  This is an aid to help you
  721. visually lock onto the targets within the display section of the
  722. main screen.  
  723.  
  724.  
  725.  
  726. Aos/Los Range - (Acquisition/Loss of signal)  This
  727. option, when enabled, will change the target I.D. background
  728. color from gray to yellow indicating that the target is in range
  729. of the receiver.  The target elevation must be equal to or
  730. greater than the minimum elevation specified for the selected
  731. ground station.  For the target to consider optically visible
  732. set the minimum ground elevation to 0 degrees.  For radio
  733. visibility, the minimum ground elevation may have to be set to
  734. something greater than 0 degrees.  Factors like antenna gain,
  735. receiver sensitivity and other environmental conditions may
  736. affect this setting.
  737.  
  738.  
  739.  
  740. In Range Alarm - Setting this option will enable the
  741. system to give an audible alarm when the target is in range of
  742. the ground station.  This option is used in conjunction with the
  743. Aos/Los Range option and is disabled when Aos/Los is disabled. 
  744. This option will alert you when a target is in range even if the
  745. program is minimized.  You can be doing other windows functions
  746. while OrbTrack runs in the background and be alerted when any
  747. target is in range.  To turn the alarm off, click on this option
  748. a second time.
  749.  
  750.  
  751.  
  752. Sort By Height - This option instructs the program to
  753. sort all targets according to the their height above the ground.
  754.  Targets are arranged from lowest to highest.  Target icons will
  755. reflect the height by visible layering when passing on top of
  756. each other.  The sort option will disable itself once it has
  757. sorted the targets.  The sort operation will not take place if
  758. already sorted.  You must manually select this option again to
  759. resort.
  760.  
  761.  
  762.  
  763. You can select sort even if the targets are already
  764. sorted.  The sort function will not execute until the targets
  765. have changed height again.
  766.  
  767.  
  768.  
  769. Ground Station Panel
  770.  
  771.  
  772.  
  773. This panel is for ground station information only. 
  774. It displays the location of the ground station, it's latitude
  775. and longitude and current time.  It also displays current local
  776. (PC) and UTC time.
  777.  
  778.  
  779.  
  780. If no ground station is select for the program the
  781. location of the ground station is displayed as "No Ground
  782. Station" and the UTC time is set the same as your PC's time (0
  783. UTC Offset).
  784.  
  785.  
  786.  
  787. Note: No dates are displayed in this panel.  UTC time
  788. may be wrapped into the next day.  The program internally
  789. recognizes this fact in the orbit calculations.
  790.  
  791.  
  792.  
  793.  
  794.  
  795. Target Tracking Data Display
  796.  
  797.  
  798.  
  799. This section of the main screen displays current
  800. target tracking information.  Only the targets displayed on the
  801. map will be listed in this window.  The window will expand or
  802. contract as the number of targets being tracked changes.  All
  803. tracking data values are updated once a second.  Data that
  804. appears in this window are defined as follows:
  805.  
  806.  
  807.  
  808. Target ID - The name or identification of the target
  809. being tracked.
  810.  
  811.  
  812.  
  813. Latitude (Deg.) - Current latitude of the
  814. sub-satellite point in degrees.
  815.  
  816.  
  817.  
  818. Longitude (Deg.) - Current longitude of the
  819. sub-satellite point in degrees.
  820.  
  821.  
  822.  
  823. Range (km) - The distance in kilometers between the
  824. ground tracking station and the target being tracked.
  825.  
  826.  
  827.  
  828. Elevation (Deg.) - The angle of elevation in degrees
  829. above or below the tracking stations horizon.
  830.  
  831.  
  832.  
  833. Azimuth (Deg.) - The horizontal angle in degrees of
  834. the target in respect to the ground station's horizon plane and
  835. north reference (North =  0 degrees increasing clockwise from
  836. North)
  837.  
  838.  
  839.  
  840. Height (km) - The altitude of the target in
  841. kilometers from ground level.
  842.  
  843.  
  844.  
  845.  
  846.  
  847. Target Icons
  848.  
  849.  
  850.  
  851. The use of icons for target indicators give the user
  852. a better visual relation ability to what is being displayed on
  853. the tracking screen.  OrbTrack incorporates six of the basic
  854. satellite shape being used today.
  855.  
  856.  
  857.  
  858. Type 1 - Tri-star Shape -  Oscar 10,13, etc
  859. (AO-10,13,...)
  860.  
  861.  
  862.  
  863. Type 2 - Polyhedron Shape - Fuji Oscar 20 (FO12), etc.
  864.  
  865.  
  866.  
  867. Type 3 -  General Shape Unknown - possibly RS-10/11 &
  868. 12/13
  869.  
  870.  
  871.  
  872. Type 4 - Rectangular - Microsats & others (DO-17,
  873. WO-18, etc)
  874.  
  875.  
  876.  
  877. Type 5 - Space Shuttle - STS-xx Series
  878.  
  879.  
  880.  
  881. Type 6 - Other - Mir, Geos, Etc....
  882.  
  883.  
  884.  
  885.  
  886.  
  887. Chapter 4: Target Elements Editor
  888.  
  889.  
  890.  
  891. This screen is used to edit target orbital parameters
  892. or "Keplerian Elements".  The elements define the motion of the
  893. satellite in orbit around the earth and are used by the program
  894. to derive the current position of the target.  
  895.  
  896.  
  897.  
  898. Satellites in low earth orbit, or ones that have
  899. maximum orbit heights of less then 800 kilometers, should have
  900. there orbit elements updated at least once every three to four
  901. weeks to insure accurate tracking.   This is due to changes in
  902. drag brought on by changes in the density of the earths
  903. atmosphere.  For those in higher orbits, the elements should be
  904. updated every three to four months.  At higher orbits,
  905. atmospheric drag is less of a problem.
  906.  
  907.  
  908.  
  909. When changes are made to the element set for a target
  910. being tracked you must remove the target from the tracking
  911. display and then re-install it to make the new element set
  912. active.  You can edit or add any target element set at any time
  913. without affecting the current display.   When editing,  the
  914. tracking routines and alarm options are still active and will
  915. proceed as normal.
  916.  
  917.  
  918.  
  919. The element set is stored in Microsoft Access
  920. Database format.  You may access the database from programs
  921. running outside of OrbTrack as long as they support the
  922. Microsoft Access Database format.
  923.  
  924.  
  925.  
  926. Element Editor Control Buttons
  927.  
  928.  
  929.  
  930. Find - Clicking on this button will bring up a dialog
  931. window where you will be asked to enter the name or
  932. identification code for the satellite for which you'll be
  933. editing its element set.  You may enter a partial name or I.D.
  934. in the box. Example: Typing "DO" in box and hitting Enter will
  935. bring of the first satellite with DO in the first two character
  936. positions - DO-17 (Dove).  The software will find the closest
  937. match and display its element set.  The find routine is not case
  938. sensitive.  For example, "DO" and "do" will find the same
  939. element set.
  940.  
  941.  
  942.  
  943. Edit - Click on this button to enable editing of the
  944. currently displayed element set.  The program enhances the
  945. appearance of the element set text boxes and positions the
  946. cursor into the first field to be edited.  To get back and forth
  947. between the various fields in the element set you can either
  948. click on the field or use the Tab / Back Tab keys to move
  949. around.  To cancel an editing function click on the Cancel
  950. button.  Canceling an edit session will restore all element data
  951. fields that were changed.  To save any changes made click on the
  952. Save button.
  953.  
  954.  
  955.  
  956. Add - This button allows you to add a new entry into
  957. the target element set database.  Clicking on this button tell
  958. the program to clear all element fields in preparation for a new
  959. entry.  The cursor is set to the target ID field where you can
  960. now enter the name or I.D. of the target.  If you want to cancel
  961. the add function, click on the Cancel button.  To save the new
  962. entry click on the Save button.
  963.  
  964.  
  965.  
  966. Delete - The Delete button is used to remove a
  967. targets element set completely from the database.  Once deleted,
  968. the element set cannot be restored except by adding it back
  969. manually.  This button is only enabled in the edit node.  As a
  970. safety precaution you must;  Find the element set to delete
  971. using the Find function. Put the program in the edit mode by
  972. clicking the Edit button.  Then click the Delete button.  You
  973. will be required to indicate your desire to continue with the
  974. delete by clicking on the Yes button of the popup delete
  975. confirmation window.  You can cancel the delete function by
  976. clicking on the No button.
  977.  
  978.  
  979.  
  980. Cancel - This button is enabled for only the Add and
  981. Edit functions.  Clicking on this button will cancel the
  982. addition of a new entry or cancel changes made to an existing
  983. one.
  984.  
  985.  
  986.  
  987. Next - This button is used to scroll though the
  988. various element sets in the database.   Clicking on Next will
  989. bring up the next target in the database in alphabetical order. 
  990. This button is not enabled during Edit or Add functions.
  991.  
  992.  
  993.  
  994. Previous - This button is used to scroll though the
  995. various element sets in the database.   Clicking on Previous
  996. will bring up the previous target in the database in
  997. alphabetical order.  This button is not enabled during Edit or
  998. Add functions.
  999.  
  1000.  
  1001.  
  1002. Save - The Save button is used to save a new element
  1003. entry or any  updates made to an existing one.   The program
  1004. checks for missing element data and validates the various data
  1005. fields for proper values and syntax.  If a data error is found
  1006. the program cancels the save and returns you to the edit/add
  1007. mode where you can make any corrections needed.   This button is
  1008. enabled only during the Edit or Add functions.
  1009.  
  1010.  
  1011.  
  1012. Exit - Clicking on exit will close the editor window
  1013. and returns you to the tracking display.  If you where adding or
  1014. editing an entry the program validated and saves any changes
  1015. before returning to the tracking display.  This is the only way
  1016. to exit the editor.
  1017.  
  1018.  
  1019.  
  1020.  
  1021.  
  1022. Element Set Fields
  1023.  
  1024.  
  1025.  
  1026. All fields described in this section are required for
  1027. proper target tracking.  Each field is described below along
  1028. with the data field size and range.  Saving entered data will
  1029. cause the program to check for valid data and inform you if any
  1030. field has an error.  Data is required for all fields except
  1031. where noted.
  1032.  
  1033.  
  1034.  
  1035. Target ID: - 1 to 30 Characters, Alphanumeric - This
  1036. field contains the name or identification of the target to be
  1037. entered and tracked.  You can enter the name in either upper or
  1038. lower case.  You may use the NASA ID or create one of your own.
  1039.  
  1040.  
  1041.  
  1042. Catalog #: - 0 to 99999 Numeric characters -  This is
  1043. the catalog number of the target as assigned by NORAD/NASA.  The
  1044. "U" or Unclassified part of the catalog number is not needed by
  1045. this program and is not entered.
  1046.  
  1047.  
  1048.  
  1049. Epoch Time: - Numeric, Formatted as YYDDD.TTTTTTTT -
  1050. This is the Year, Day and Time that the element set was derived.
  1051.  The format is as follows: YY - Last two digits of the year
  1052. computed.   DDD - The day of the year computed.   T..T - The
  1053. time (Factional part of the day)  since midnight when computed. 
  1054.  
  1055.  
  1056.  
  1057. Element Set: - 0 to 9999 Numeric - The serial /
  1058. sequence number of the element set described.
  1059.  
  1060.  
  1061.  
  1062. Inclination: - 0 to 180 Degrees Numeric Format:
  1063. XXX.XXXX  - Describes the orientation of the satellite's plane
  1064. with respect to the equatorial plane of the earth.
  1065.  
  1066.  
  1067.  
  1068. RA of Node: - 0 to 360 Degrees Format: XXX.XXXX -
  1069. Right Ascension of Ascending Node.  Specifies the targets
  1070. orbital plane with respect to "Fixed" stars.
  1071.  
  1072.  
  1073.  
  1074. Eccentricity: - .0 to .9999999 Numeric - Describes
  1075. the elliptical properties of the targets orbit.  "0" equal
  1076. circular and all others describe increased orders of ellipse. 
  1077. Leading decimal often not show but is required for this program.
  1078.  
  1079.  
  1080.  
  1081. Arg of Perigee: - 0 to 360 Degrees Numeric -
  1082. Describes where the perigee of the satellite is located.  0 to
  1083. 180 degrees means the perigee is located in the northern
  1084. hemisphere and  180 to 360 is located in the southern hemisphere.
  1085.  
  1086.  
  1087.  
  1088. Mean Anomaly: - 0 to 360 Degrees Numeric - Locates
  1089. the satellite in the orbital plane at epoch.  0 to 180 means the
  1090. target is headed towards apogee and 180 to 360 indicates
  1091. movement towards perigee.
  1092.  
  1093.  
  1094.  
  1095. Mean Motion: - -8 to +100 Rotations Per Day -
  1096. Indicates the number of rotations the target makes in one day.
  1097.  
  1098.  
  1099.  
  1100. Decay Rate: - +/- X.XXXXXXXX Numeric - This field
  1101. indicates the rate of decay in the satellite's orbit per day. 
  1102. Indicates the amount of drag do to the earths atmosphere.  Has
  1103. very little affect in position calculations.
  1104.  
  1105.  
  1106.  
  1107. Epoch Orbit Number: - 0 to 9999 Integer - The
  1108. target's revolution number when the orbital element was
  1109. calculated.
  1110.  
  1111.  
  1112.  
  1113. Target Type: - 1 to 6 Numeric - The Icon number that
  1114. best represents the satellite.
  1115.  
  1116.  
  1117.  
  1118. Last Revised - Date - Date element set was edited.
  1119. Assigned by the program.
  1120.  
  1121. Cannot be entered by the user. Element Set Data Sources
  1122.  
  1123.  
  1124.  
  1125. Element Sets can be located on some bulletin boards
  1126. around the country and on most popular services like Compuserve,
  1127. Prodigy, Internet and others.  Most element set file formats use
  1128. what is called  "NASA 2 - Line Element Set".
  1129.  
  1130. Other formats contain all the information required to
  1131. run this program.
  1132.  
  1133.  
  1134.  
  1135. A good source for current element sets is the
  1136. DRIG/AMSAT Datalink BBS in Texas.  BBS number (214) 394-7438.
  1137.  
  1138.  
  1139.  
  1140. For more information on satellite tracking -
  1141.  
  1142.  
  1143.  
  1144. AMSAT-NA (AMSAT Technical Journal)
  1145.  
  1146. QST Magazine
  1147.  
  1148. CQ Magazine
  1149.  
  1150. ARRL  Books and articles
  1151.  
  1152.  
  1153.  
  1154. Try it Out!
  1155.  
  1156.  
  1157.  
  1158. If you own a scanner capable of receiving the 2 meter
  1159. Amateur radio ban listen on 145.825 MHZ FM for DO-17 dove
  1160. satellite.  This satellite is currently sending telemetry,
  1161. audible tones, and a voice synthesized message.  The signal is
  1162. strong enough to be heard with an indoor antenna.  Try it!
  1163.  
  1164.  
  1165.  
  1166. Chapter 5: Ground Station Editor
  1167.  
  1168.    
  1169.  
  1170. The Ground Station Editor allows you to make
  1171. additions and changes to the tracking station database. 
  1172. Information in this database describes to the software where the
  1173. tracking station is located, its height above sea level, minimum
  1174. target elevation above the horizon and the number of hours that
  1175. the local time is relative to UTC or Universal Coordinated Time.
  1176.  You can add new ground stations, edit current ones and delete
  1177. unneeded ones from the database.   The Ground Station database
  1178. is in Microsoft Access format and can be manipulated by other
  1179. programs that support the Microsoft Access format.
  1180.  
  1181.  
  1182.  
  1183. If you have edited the current ground station data
  1184. you will need to remove and re- install the ground station on
  1185. the display screen in order for the new data to be used.
  1186.  
  1187.  
  1188.  
  1189. Ground Station Editor Control Buttons
  1190.  
  1191.  
  1192.  
  1193. Find - Clicking on this button will bring up a dialog
  1194. window where you will be asked to enter the name of the tracking
  1195. station for which you'll be editing its information.  You may
  1196. enter a partial tracking station name in the box. 
  1197.  
  1198. Example: Typing "Cr" in box and hitting Enter will
  1199. bring of the first location with Cr in the first two character
  1200. positions - Crown Point, IN.  The software will find the closest
  1201. match and display its element set.  The find routine is not case
  1202. sensitive.  For example, "Cr" and "cr" will find the same ground
  1203. station.
  1204.  
  1205.  
  1206.  
  1207. Edit - Click on this button to enable editing of the
  1208. currently displayed ground station data.  The program enhances
  1209. the appearance of the information text boxes and positions the
  1210. cursor into the first field to be edited.  To get back and forth
  1211. between the various fields in the element set you can either
  1212. click on the field or use the Tab / Back Tab keys to move
  1213. around.  To cancel an editing function click on the Cancel
  1214. button.  Canceling an edit session will restore all data fields
  1215. that were changed.  To save any changes made click on the Save
  1216. button.
  1217.  
  1218.  
  1219.  
  1220. Add - This button allows you to add a new entry into
  1221. the ground station database.  Clicking on this button tell the
  1222. program to clear all data fields in preparation for a new entry.
  1223.  The cursor is set to the City and  State field where you can
  1224. now enter the name of the city or station.  If you want to
  1225. cancel the add function, click on the Cancel button.  To save
  1226. the new entry click on the Save button.
  1227.  
  1228.  
  1229.  
  1230. Delete - The Delete button is used to remove a ground
  1231. station completely from the database.  Once deleted, the data
  1232. set cannot be restored except by adding it back manually.  This
  1233. button is only enabled in the edit node.  As a safety precaution
  1234. you must;  Find the element set to delete using the Find
  1235. function. Put the program in the edit mode by clicking the Edit
  1236. button.  Then click the Delete button.  You will be required to
  1237. indicate your desire to continue with the delete by clicking on
  1238. the Yes button of the popup delete confirmation window.  You can
  1239. cancel the delete function by clicking on the No button.
  1240.  
  1241.  
  1242.  
  1243. Cancel - This button is enabled for only the Add and
  1244. Edit functions.  Clicking on this button will cancel the
  1245. addition of a new entry or cancel changes made to an existing
  1246. one.
  1247.  
  1248.  
  1249.  
  1250. Next - This button is used to scroll though the
  1251. various ground stations in the database.   Clicking on Next will
  1252. bring up the next ground station in the database in alphabetical
  1253. order.  This button is not enabled during Edit or Add functions.
  1254.  
  1255.  
  1256.  
  1257. Previous - This button is used to scroll though the
  1258. various ground stations in the database.   Clicking on Previous
  1259. will bring up the previous station in the database in
  1260. alphabetical order.  This button is not enabled during Edit or
  1261. Add functions.
  1262.  
  1263.  
  1264.  
  1265. Save - The Save button is used to save a new ground
  1266. station entry or any  updates made to an existing one.   The
  1267. program checks for missing data and validates the various data
  1268. fields for proper values and syntax.  If a data error is found
  1269. the program cancels the save and returns you to the edit/add
  1270. mode where you can make any corrections needed.   This button is
  1271. enabled only during the Edit or Add functions.
  1272.  
  1273.  
  1274.  
  1275. Exit - Clicking on exit will close the editor window
  1276. and returns you to the tracking display.  If you where adding or
  1277. editing an entry the program validated and saves any changes
  1278. before returning to the tracking display.  This is the only way
  1279. to exit the editor. 
  1280.  
  1281.  
  1282.  
  1283. Ground Station Fields
  1284.  
  1285.  
  1286.  
  1287. All fields described in this section are required for
  1288. proper target tracking.  Each field is described below along
  1289. with the data field size and range.  Saving entered data will
  1290. cause the program to check for valid data and inform you if any
  1291. field has an error.  Data is required for all fields except
  1292. where noted.
  1293.  
  1294.  
  1295.  
  1296. City, State/Country: - 1 to 30 Characters
  1297. Alphanumeric - Enter the name or City, State or Country where
  1298. you are located at.  If an exact match to your location cannot
  1299. be found, use one that is closest to you.  You are not limited
  1300. to cities and states/countries, you can create one that uses
  1301. your name or call sign.
  1302.  
  1303.  
  1304.  
  1305. Latitude: - -90 to + 90 Degrees - This is the
  1306. latitude in decimal degrees for where your ground station is
  1307. located.  -90 to 0 puts you in the southern hemisphere while 0
  1308. to +90 degrees puts you in the northern hemisphere.
  1309.  
  1310.  
  1311.  
  1312. Longitude: - -180 to +180 degrees - This field
  1313. contains the longitude of your ground station in decimal
  1314. degrees.  For stations located West of  longitude 0 degrees,
  1315. this value is positive in nature.  For those who are east of 0
  1316. degrees, this value is negative.
  1317.  
  1318.  
  1319.  
  1320. Ground Elevation: - -100 to + 99999 meters - Enter in
  1321. the height of your location  in reference to sea level.  This
  1322. value should be in meters.  This figure is used by the program
  1323. in determining when a target is considered visible.  It is also
  1324. used in the range calculation from grostatund ion to target.
  1325.  
  1326.  
  1327.  
  1328. UTC Correction: - -11 to +11 Hours - This integer
  1329. value is used to compensate your personal computer's clock for
  1330. Universal Coordinated Time.  All calculations are based on UTC
  1331. time values.  If your PC's clock is set to UTC then a correction
  1332. of "0" must be entered.
  1333.  
  1334.  
  1335.  
  1336. Minimum Target Elevation: - -10 to +45 degrees - This
  1337. field is used to compensate for irregularities found in signal
  1338. acquisition from a target. This value represents the minimum
  1339. elevation angle a target must be in before it is considered
  1340. visible.  factors such as ducting can make a target radio
  1341. visible before it is actually above a physical horizon. 
  1342.  
  1343.  
  1344.  
  1345.  
  1346.  
  1347. KE9PU Software
  1348.  
  1349. Albert E. Kolvek Jr.
  1350.  
  1351. 5035 West 90th Lane
  1352.  
  1353. Crown Point, IN 46307
  1354.  
  1355.  
  1356.  
  1357. 219.769.7047
  1358.  
  1359.  
  1360.  
  1361. Other OrbTrack Versions:
  1362.  
  1363.  
  1364.  
  1365. OrbTrack 1.0A - Shareware Release
  1366.  
  1367.  
  1368.  
  1369. OrbTrack 1.0F - Enhanced Version (Availible November,
  1370. 1994)
  1371.  
  1372.          . Keplerian Elements Loading from Downloaded Files
  1373.  
  1374.          . Aos/Los Duration Times
  1375.  
  1376.          . Next Pass Time
  1377.  
  1378.          . More Preloaded Elements & Cities
  1379.  
  1380.          . Frequency Database for Each Target
  1381.  
  1382.  
  1383.  
  1384. OrbTrack Plus - Advanced Version (In Development -
  1385. Write for release date)
  1386.  
  1387.          . 1.0F Features
  1388.  
  1389.          . Radio Control Functions
  1390.  
  1391.          . Antenna Positioning Control Function
  1392.  
  1393.