USAORB

Displays polar orbital tracks and coverage for North America.

Formats

USAORB navdataset frame [keywords]
USAORB imgdataset frame [keywords]

Parameters

navdataset	name of the ADDE dataset containing the system navigation files for a satellite; specify as group/descriptor or alias
imgdataset	name and position of the ADDE dataset containing the image to use as a navigation source; specify as group/descriptor.position or alias.position; when specifying an image dataset, you must also use the TYPE=I keyword (position default=0)
frame	frame number for display (default=current)

Keywords

CColor=	graphics color level of the lines displaying the geographical coverage of the satellite sensor or the boundaries of the image specified in imgdataset; use positive numbers for solid lines and negative numbers for dashed lines; see the Remarks (default=0, do not plot coverage)
DAY=	bday eday		range of days for display; see the Remarks (default=current, or from imgdataset)
HORizon=	gil wal		minimum angle, in degrees, above the horizon at which a satellite signal is readable
		gil	angle at Gilmore Creek, Alaska (default=5)
		wal	angle at Wallops Island, Virginia (default=5)
INT=	interval, in seconds, between the time marks on the orbital track (default=computed)
LABel=	'text' loc col		display label, location, and color
		'text'	label or description of the display (default=from navdataset or imgdataset)
		loc	location for the label at the bottom of the frame; specify a number 1 through 5; see the Remarks (default=1)
		col	graphics color level for the label (default=from the CCOLOR keyword if used; otherwise from the TRCOLOR keyword)
NAV=	C		use existing frame navigation; use this keyword to overlay additional orbital tracks on the same frame (default=erase frame and redraw map)
SENsor=	type
	POES options:		AVHRR (default), HIRS, MSU
	DMSP options:		OLS (default), SSM/I, SSM/T, or SSM/T2
TIME=	btime etime		time range to plot; see the Remarks (default=0 23:59:59, or from imgdataset)
TMColor=	graphics color level of the time marks on the orbital track (default=3)
TRColor=	graphics color level of the orbital track; use positive numbers for solid lines and negative numbers for dashed lines (default=2)
TYPE=	S		uses the system navigation files specified with navdataset (default)
	I		uses the navigation of the image specified with imgdataset; overrides the SENSOR keyword

Remarks

Use both the DAY and TIME keywords to specify the time period for plotting orbital tracks and coverage. For example, DAY=182 183 TIME=21 3 specifies a range from 21:00 UTC on day 182 through 03:00 UTC on day 183.

If you use the CCOLOR keyword and TYPE=I without the DAY or TIME keyword, the displayed geographical coverage is limited to the image specified in imgdataset. Otherwise, the entire geographical coverage of the sensor is displayed.

Labels are displayed at the bottom left corner of the frame. A default label is constructed using information from the system navigation file or the image used for navigation. The label includes the dataset name, the satellite, sensor, and day or range of days displayed. Use the LABEL keyword and the 'text' parameter if you want to choose a different label.

Specify NAV=C to overlay additional orbital tracks on the same frame. Use the loc parameter with the LABEL keyword to place additional labels on different lines at the bottom of the frame. Location 1 is the top line; additional labels are below. The maximum number of lines depends on the frame size: five for a 480 by 640 frame.

Examples

USAORB NAV/NOAA14 DAY=96300

USAORB NAV/NOAA12 DAY=96300 NAV=C TRCOLOR=5 LABEL=X 2

The first entry draws the NOAA-14 satellite orbital tracks for day 96300 over a map of North America. The second entry draws the NOAA-12 satellite orbital tracks on the same frame without erasing the NOAA-14 tracks. The NOAA-12 tracks and display label are drawn in graphics color level 5. The label is positioned on the text line below the first entry's label.

USAORB POESNAV/NOAA14 TIME=13:00 15:00 SENSOR=MSU CCOLOR=-7

This entry draws the NOAA-14 satellite orbital tracks from the current day between 13 and 15 UTC and displays the geographical coverage of the MSU sensor in dashed color level 7. The track data is drawn over a map of North America.

USAORB WALLOPS/N12HRPT TYPE=I

This entry draws the orbital track for the polar orbiting satellite with data in most recent image in the dataset WALLOPS/N12HRPT over a map of North America.

USAORB WALLOPS/N12HRPT TYPE=I CCOLOR=10

This entry draws the orbital track and the AVHRR geographic coverage for the satellite with data in the most recent image in the dataset WALLOPS/N12HRPT over a map of North America. The geographic coverage is drawn in color level 10.

USAORB WALLOPS/N12HRPT TYPE=I DAY=97097

This entry draws the orbital tracks for the satellite with data in the most recent image in the WALLOPS/N12HRPT dataset. The tracks for the entire day 97097 are plotted.

USAORB GILMORE/N14GAC TYPE=I NAV=C LABEL='ORBITAL TRACK FOR NOAA-14 #Y' INT=300

This entry draws the orbital track for the satellite with data in the most recent image in the GILMORE/N14GAC dataset using the current frame's navigation. A custom label is displayed, and the time marks are drawn every five minutes along the orbital track.