The OrbitTools Libraries
NORAD SGP4/SDP4 Implementations in C++ and C#
by
Michael F. Henry

AOS Pro Utility Program - Usage Text and Examples

Usage Text

Usage:
       aospro [flags] <start_time> <end_time> <location> <tle_file>
       aospro [flags] <elapsed_time>          <location> <tle_file>

<start_time>, <end_time> - Specifies the time block for which pass data is
   calculated. Uses 24-hr time format. Time zone is given by -z flag.
   Format : yyyy/mm/dd hh:mm[:ss]
   Example: 2013/12/31 23:59
<elapsed_time> - Specifies the amount of time, relative to the current time,
   for which pass data is calculated.
   Formats: d, d/hh:mm, hh:mm
   Example: 5/12:00  (5 days, 12 hours)
<location> - The earth location for which pass data is calculated.
   Location format: lat:lon[:alt]
   Lat, Lon format: [-]0.0 (in degrees, negative means S Lat or W Lon)
   Altitude format: [-]0.0 (in meters, default is 0.0)
   Example        : 38.5:-128.8:30
<tle_file> - Name of file containing TLE data. Pass data is calculated for
   all satellites in the file. To restrict satellite set, use the -m flag.

where [flags] are as follows:
-f : Filter. Filter the output data as follows:
  -fv       : Visible; show only visible passes.
  -fm angle : Mask angle; show only passes with maximum elevations
              equal to or above "angle" (in degrees).
  -fq val   : Quality; show only passes with a pass quality rating
              equal to or above "val".
-s : Sort. Sort the output data as follows:
  -sa / -sm / -sl : Sort by AOS/MAX/LOS times.
  -sn  : Sort by satellite name (then by AOS).
  -sq  : Sort by (visible) pass quality.
  -sme : Sort by maximum pass elevation.
-m<n|i> : Match. Generate pass data only for the satellite whose name (-mn)
   contains the given substring, or whose NORAD ID (-mi) contains the
   given substring. Multiple -m parameters are allowed. If the first
   character of the string is "@" the parameter denotes a filename
   which contains one satellite name (or ID) per line.
-o : Output. Specify the data output:
  -os        : Standard. Show date, time, AOS, MAX, LOS data. (Default)
  -ot        : Terse. A shortened version of the Standard output format.
  -opa [sec] : Az/El location, per pass, at interval [sec] (Default: 1 sec)
  -opi [sec] : ECI location,   per pass, at interval [sec] (Default: 1 sec)
  -opf [sec] : ECF location,   per pass, at interval [sec] (Default: 1 sec)
-t deg : Twilight. Angle of the sun (in degrees) when twilight begins.
     Default: -6.0 degrees (Civil Twilight).
-v[q] : Visible. Mark visible passes with an asterisk. The -vq option
        provides a "pass quality" rating from 0 (worst) to 9 (best).
-u : UTC. Print UTC and quit.
-x[p|s] : Execution mode:
  -xp : Parallel mode (default).
  -xs : Serial mode.
-z <tz_info> : Time zone information. Specifies the time zone of all times.
   <tz_info> format : <tzn>[+|-]hh[:mm[:ss]][dzn]
   where:
      <tzn>        : Timezone name. Must be 3 letters.
      hh[:mm[:ss]] : UTC offset (note: relative to timezone).
      [dzn]        : Optional daylight time zone name. Must be 3 letters.
   Example : -z PST8PDT
-?, -h : Show this message.


Example 1 - Basic Pass Predictions

This example shows how to calculate pass predictions data for Denver, Colorado, USA.  The file "visual.txt" contains TLE data for approximately 100 satellites.  Shown in the output is the pass information for all satellites that are above the horizon from 00:00h until 23:59h on 2014-04-27.  The information given is : satellite AOS (rise)  time, maximum elevation time, and satellite LOS (set) time.

> aospro -z MST7MDT 2014/04/28 00:00 2014/04/28 23:59 39.75:-104.98:1600 visual.txt
Data generated: Sun Apr 27 13:09:25 MDT 2014
Site location : 39.750N 104.980W 1600.0m
ATLAS CENTAUR 2 #00694 [T+E: 1/05:33]
2014/04/28 09:12:12 MDT [AZ 163] 09:16:02 MDT [AZ 143 EL  1.8] 09:19:46 MDT [AZ 122]
2014/04/28 10:55:48 MDT [AZ 206] 11:04:48 MDT [AZ 154 EL 15.6] 11:12:56 MDT [AZ 100]
2014/04/28 12:43:40 MDT [AZ 232] 12:53:51 MDT [AZ 167 EL 29.8] 13:02:20 MDT [AZ 098]
2014/04/28 14:33:04 MDT [AZ 252] 14:42:57 MDT [AZ 181 EL 36.4] 14:50:43 MDT [AZ 108]
2014/04/28 16:23:09 MDT [AZ 262] 16:31:40 MDT [AZ 197 EL 26.0] 16:38:23 MDT [AZ 129]
2014/04/28 18:14:00 MDT [AZ 258] 18:19:42 MDT [AZ 213 EL  8.9] 18:24:38 MDT [AZ 164]
THOR AGENA D R/B #00733 [T+E: 1/06:18]
2014/04/28 01:02:48 MDT [AZ 144] 01:10:03 MDT [AZ 069 EL 39.6] 01:17:24 MDT [AZ 355]
2014/04/28 02:42:34 MDT [AZ 197] 02:49:28 MDT [AZ 265 EL 24.5] 02:56:31 MDT [AZ 333]
2014/04/28 13:16:08 MDT [AZ 035] 13:22:22 MDT [AZ 091 EL 13.7] 13:28:30 MDT [AZ 146]
 
(output truncated for brevity...)
 
2014/04/28 08:31:44 MDT [AZ 268] 08:36:41 MDT [AZ 352 EL 49.6] 08:41:42 MDT [AZ 075]
2014/04/28 10:08:09 MDT [AZ 285] 10:13:09 MDT [AZ 009 EL 51.2] 10:18:10 MDT [AZ 093]
2014/04/28 11:44:23 MDT [AZ 286] 11:49:21 MDT [AZ 206 EL 45.4] 11:54:20 MDT [AZ 125]
2014/04/28 13:21:17 MDT [AZ 268] 13:25:02 MDT [AZ 220 EL  7.6] 13:28:46 MDT [AZ 171]
FALCON 9 R/B #39271 [T+E: 2/03:00]
2014/04/28 02:26:28 MDT [AZ 006] 02:34:36 MDT [AZ 051 EL 10.0] 02:42:12 MDT [AZ 098]
2014/04/28 04:08:55 MDT [AZ 354] 04:20:23 MDT [AZ 073 EL 49.0] 04:30:10 MDT [AZ 152]
2014/04/28 05:52:41 MDT [AZ 343] 06:03:31 MDT [AZ 274 EL 37.4] 06:12:53 MDT [AZ 202]
2014/04/28 07:39:21 MDT [AZ 319] 07:44:20 MDT [AZ 293 EL  3.6] 07:49:06 MDT [AZ 265]
2014/04/28 15:42:07 MDT [AZ 106] 15:47:18 MDT [AZ 069 EL  6.1] 15:53:05 MDT [AZ 035]
2014/04/28 17:20:29 MDT [AZ 171] 17:28:20 MDT [AZ 091 EL 52.3] 17:38:50 MDT [AZ 014]
2014/04/28 19:04:27 MDT [AZ 226] 19:12:17 MDT [AZ 295 EL 27.8] 19:22:17 MDT [AZ 003]
2014/04/28 20:54:42 MDT [AZ 292] 20:59:02 MDT [AZ 319 EL  2.9] 21:03:41 MDT [AZ 346]


Example 2 - Visual Observation

This example builds on Example 1 and shows how to calculate visual pass predictions for the International Space Station (ISS).  Any of the calculated passes would be visible to the naked eye.

  • The -mn flag is used to restrict the calculations to satellites which contain "ISS" in their name. 

  • The -vq flag appends a "quality" rating to each visible pass (i.e., "*9").

  • The -fv flag filters the output to only contain passes that are visible (earth site in darkness, satellite in sunlight).

> aospro -mn ISS -vq -fv -z MST7MDT  2014/04/28 00:00 2014/05/21 23:59 39.75:-104.98:1600 visual.txt
Data generated: Sun Apr 27 13:31:55 MDT 2014
Site location : 39.750N 104.980W 1600.0m
ISS (ZARYA) #25544 [T+E: 0/16:23]
2014/04/28 20:59:57 MDT [AZ 251] 21:01:04 MDT [AZ 239 EL  0.4] 21:02:11 MDT [AZ 227] *0
2014/05/12 04:48:18 MDT [AZ 162] 04:51:34 MDT [AZ 124 EL  4.6] 04:54:50 MDT [AZ 086] *1
2014/05/13 04:03:02 MDT [AZ 128] 04:03:41 MDT [AZ 121 EL  0.2] 04:04:21 MDT [AZ 114] *0
2014/05/14 04:46:44 MDT [AZ 195] 04:51:33 MDT [AZ 131 EL 17.3] 04:56:23 MDT [AZ 067] *2
2014/05/15 03:59:27 MDT [AZ 179] 04:03:39 MDT [AZ 127 EL  9.6] 04:07:52 MDT [AZ 076] *1
2014/05/16 03:12:42 MDT [AZ 160] 03:15:51 MDT [AZ 124 EL  4.1] 03:19:00 MDT [AZ 088] *0
2014/05/16 04:46:33 MDT [AZ 220] 04:51:53 MDT [AZ 138 EL 52.0] 04:57:16 MDT [AZ 056] *5
2014/05/17 03:58:49 MDT [AZ 207] 04:03:57 MDT [AZ 134 EL 28.6] 04:09:08 MDT [AZ 061] *3
2014/05/18 03:11:20 MDT [AZ 193] 03:16:07 MDT [AZ 130 EL 16.5] 03:20:55 MDT [AZ 068] *1
2014/05/18 04:47:14 MDT [AZ 243] 04:52:36 MDT [AZ 326 EL 51.2] 04:58:00 MDT [AZ 050] *5
2014/05/19 02:24:13 MDT [AZ 178] 02:28:22 MDT [AZ 127 EL  9.1] 02:32:32 MDT [AZ 076] *0
2014/05/19 03:59:13 MDT [AZ 231] 04:04:37 MDT [AZ 319 EL 89.0] 04:10:04 MDT [AZ 053] *5
2014/05/20 03:11:24 MDT [AZ 219] 03:16:44 MDT [AZ 138 EL 49.8] 03:22:07 MDT [AZ 057] *3
2014/05/20 04:48:34 MDT [AZ 264] 04:53:41 MDT [AZ 335 EL 23.3] 04:58:49 MDT [AZ 046] *3
2014/05/21 02:23:49 MDT [AZ 206] 02:28:57 MDT [AZ 134 EL 27.6] 02:34:07 MDT [AZ 062] *1
2014/05/21 04:00:24 MDT [AZ 253] 04:05:40 MDT [AZ 331 EL 33.2] 04:10:58 MDT [AZ 048] *3

 

  Copyright  2009-2017 Michael F. Henry.
The author may be reached at mfh@zeptomoby.com