trackeye - monitors the antenna tracking and framing of pass data in real time.

trackeye -- Monitors the antenna tracking and framing of pass data in real time.

SYNOPSIS

trackeye chain [antenna/360.0] li [full/cmd] fast once
trackeye chain autoalign
trackeye chain noalign
trackeye chain abort
trackeye chain noabort
trackeye chain abortnot
trackeye chain testabort
trackeye chain antlead

DESCRIPTION

trackeye displays information about the status of data acquisition. At the start of a pass, the satellite, sensor, pass start date, pass start time, and pass duration are displayed. The current commanded position of the antenna, the incoming signal strength, the number of data lines received, and the frame synchronizer status are updated once per second (subject to the system load).

There are two different versions of the trackeye display that can be evoked, depending on whether or not the full option is used with the trackeye command. When trackeye is run with the full option, the following header and data line are displayed for a pass being tracked.

Sat: xxxx   Sensor: xxx   Start: xx:xx:xx   Dur xx.xx
Latitude: xx.xxx   Longitude: xxx.xxx   Magnetic Declination: x.xxx
Chain: x   Ant: xx   Antenna Azimuth: x.xxx
Date     Time         azim elev head   mo   freq #lin S Sig fsync
yy/mm/dd hh:mm:ss.sss  x.x  x.x  x.x  -/* xxxx.x xxxx S Sig fsync

When the full option is used, the header and data line are displayed as follows:

Sat: xxxx   Sensor: xxx   Start: xx:xx:xx   Dur xx.xx
Latitude: xx.xxx   Longitude: xxx.xxx   Magnetic Declination: x.xxx
Chain: x   Ant: xx   Antenna Azimuth: x.xxx

                       Command          Actual   Calculated
Date     Time         azim elev  head  asim elev  azim elev  (cont.)
yy/mm/dd hh:mm:ss.sss  x.x  x.x   x.x   x.x  x.x   x.x  x.x  (cont.)

align  mo   freq  #lin S Sig fsync  BS R Trk Align
 x.x  -/* xxxx.x  xxxx x  x     x    x x  x     x

Trackeye Fields

The fields of the Trackeye display are as follows:

Sat is the satellite being tracked.
Sensor is the telemetry being acquired.
Start is the start time of the pass (GMT time) in the format hh:mm:ss.
Dur is the duration of the pass in the format mm:ss.
Latitude is the antenna's latitude at the start of the pass, in degrees.
Longitude is the antenna's longitude at the start of the pass, in degrees.
Magnetic Declination is the compass declination at the start of the pass, in degrees.
Chain is the telemetry chain that is acquiring the data. During SEARCH mode, this field reports 0.
Ant is the antenna index (1, 2, ...) of the tracking antenna used by the specified chain. During SEARCH mode, this field reports -1.
Antenna Azimuth is the antenna azimuth mounting correction, in degrees.
Date (yy/mm/dd) is the current year(yy), month(mm) and day of the month(dd).
Time (hh:mm:ss.sss) is the current hour (hh), minute (mm), and second (ss.sss) of the data.
azim (or Command azim) is the last antenna azimuth command relative to the antenna mounting. Some antennas have a range of 95.0 to 625.0 degrees, with an azimuth of 360.0 degrees pointing to true north. Some antennas have an azimuth range of 0.0 to 360.0 degrees, with an azimuth of 0.0 degrees pointing true north. If the antenna is ship based, this angle is relative to the bow of the ship.
elev (or Command elev) is the last antenna elevation command, in degrees. Range [0.0, 90.0] or [0.0, 180.0] degrees.
head is the ship heading, in degrees. If not used, this field is blank.
Actual azim is the actual antenna azimuth, in degrees. Range [0.0, 360.0] or [90.0 to 540.0] degrees.
Actual elev is the actual antenna elevation, in degrees. Range [0.0, 90.0] or [0.0, 180.0] degrees.
Calculated azim is the calculated antenna azimuth, in degrees. Range [0.0, 360.0] or [90.0 to 540.0] degrees.
Calculated elev is the calculated antenna elevation, in degrees. Range [0.0, 90.0] or [0.0, 180.0] degrees.
align is the azimuth alignment correction, in degrees. Range [-180.0, 180.0] degrees. This value is set and changed by align or autoalign.
mo is the current antenna motion.
	- = No motion. Antenna is idle.
	* = No motion. Antenna position is being changed but no elevation command has been received.
	A = Antenna is ascending.
	D = Antenna is descending.
	R = autoalign is running on the antenna associated with the specified telemetry chain.
freq is the receiver frequency, in megaHertz (MHz). During SEARCH mode, reports frequency of the last pass tracked.
#lin is the number of scan lines acquired for this pass by the frame synchronizer associated with the specified telemetry chain.
S is the bit synchronizer normal or invert data state. During SEARCH mode, reports state of last pass tracked.
	N = data is normal I = data is inverted
Sig is the current signal strength as indicated on the receiver. If the receiver has no signal strength data, the level is 0. The range of the signal strength is [0, 255].
fsync is the status of the frame synchronizer associated with the specified telemetry chain.
	SEARCH = frame synchronizer is searching for the start of a frame.
	LOCK = frame synchronizer has locked onto a frame.
BS is the bit sync status.
	S = bit synchronizer is in search mode.
	L = bit synchronizer is in lock mode.
R is the receiver status.
	S = receiver is in search mode.
	L = receiver is in lock mode.
Trk is the antenna tracking mode.
	Pgm = Antenna is in program track.
	Auto = Antenna is in auto track.
Align
	blank = normal antenna motion. No antenna alignment in process.
	setup = the next antenna used with the specified telemetry chain will be aligned by autoalign.
	run = autoalignment is running on the antenna associated with the specified telemetry chain.

PARAMETERS for the trackeye command

chain

Telemetry chain to monitor. Telemetry chains are numbered 1,2,3. The default chain is 1.

antenna

Displays the azimuth in antenna angles (90.0 - 540.0 degrees).

360.0

Displays the azimuth in compass angles (0.0 - 360.0 degrees, true north). This is the default.

li

Displays each change on a separate line.

full

Displays a full description of the antenna status. See DESCRIPTION.

cmd

Displays the antenna data in a compressed form - see below. This is the default.

fast

Displays the update every 0.1 second (varies with system load). If this parameter is not selected, the update rate is every 0.5 second. The default is to update the display every 0.5 second.

abort

Aborts the tracking of the antenna and framing associated with chain. The chain number must occur on the command line before abort. This command does not display any data. The chain will remain in the abort condition until cancelled by the noabort command.

noabort or abortnot

Cancels an earlier abort request for the antenna and framing associated with chain. The chain number must be included on the command line before noabort or abortnot. This command does not display any data.

testabort

Tests if an earlier abort request for the antenna associated with chain has been issued. The chain number must be included on the command line before testabort. The function returns an exit value of 0 if the abort request has NOT been issued. The function returns an exit value of 1 if an abort request has been issued. This command does not display any data.

autoalign

Sets up autoalignment of the tracking antenna NEXT associated with chain. The chain number must be included on the command line before autoalign. This command does not display any data.

noalign

Cancels the autoalignment that was scheduled for the tracking antenna NEXT associated with chain. The chain number must be included on the command line before noalign. This command does not display any data.

antlead

On L-band (HRPT) or S-band (RTD) antennas: During the next scheduled pass, calculates the antenna lead time for the antenna associated with chain. When the pass is over, the user will be asked if the time correction for azimuth lead and elevation lead should be stored in the settings az.lead and el.lead in the file antenna.calib. If the user answers yes, the file is updated. The lead corrections will be used for tracking future passes and will result in the commands of the tracking sequence being issued early so that the antenna moves ahead of real time by the amount calculated in order to arrive at its desired position at the correct moment in time.

On L-band or S-band antennas, do not use the antlead command while running sunalign. Do not use the antlead command while running align or autoalign.

On X-band antennas: During the next scheduled pass, calculates the error in antenna azimuth and elevation for the antenna associated with chain. The antlead command is usually issued while the X-band antenna is tracking the sun after the command sunalign has been issued.

EXAMPLES

[1]% trackeye 1
  Sat:noaa-16    Sensor:hrpt     Start:2002/01/08  21:31:30   Dur 11:10
  Latitude: 32.892  Longitude: -117.154  Magnetic Declination: 13.40
  Chain: 1   Ant: 1   Antenna Azimuth: 9.000
  Date   Time             azim  elev  head  mo   freq  #lin S Sig  fsync
2002/01/08 21:35:41.921  198.0  46.0   0.0  -  1707.0  1492 I 107  LOCK

[2]% trackeye 2
  Sat:f-13    Sensor:rtd     Start:1999/02/06  00:13:55   Dur 14:53
  Latitude: 32.892  Longitude: -117.154  Magnetic Declination: 13.22
  Chain: 2   Ant: 2   Antenna Azimuth: 358.00
  Date   Time             azim  elev  head  mo   freq  #lin S Sig  fsync
1999/02/06 00:25:33.749   20.0  14.0   0.0  D  2252.5  4266 N 215  LOCK

FILES

system.config, antenna.config, antenna.calib

NOTES

1. This command should be run in a shell tool (on Solaris, open a shelltool by entering shelltool&).

2. At the end of a pass, the field #lin is zeroed. Use lspass to display the number of lines acquired in the last pass captured. Commands issued by ac will not be displayed by trackeye.

3. Not all receivers will report the receiver and bit synchronizer lock status.

Last Update: $Date: 2002/02/09 02:48:07 $