VIEWZAZ

Description

Calculates the the view zenith and azimuth angles for the specified sensor type, sensor left, right, fore, and aft field-of-view angles, sensor heading and tilt angles, image dimensions, and image location.

Parameters

viewzaz(pixelpos, linepos, dbsz, sensor, tilt, heading, leftfov, rightfov, forefov, aftfov)

Name	Type	Caption	Length	Value range
PIXELPOS *	List[float]	Pixel position	1 - 1	0.0 -
LINEPOS *	List[float]	Line Position	1 - 1	0.0 -
DBSZ *	List[int]	Database size (pixels, lines)	2 - 2	1 -
SENSOR	str	Sensor type	0 - 40	PUSHBROOM | WHISKBROOM Default: PUSHBROOM
TILT *	List[float]	Platform tilt angle	1 - 1	-90.0 - 90.0
HEADING *	List[float]	Platform heading angle	1 - 1	0.0 - 360.0
LEFTFOV *	List[float]	Left field-of-view angle	1 - 1	-90.0 - 90
RIGHTFOV *	List[float]	Right field-of-view angle	1 - 1	-90.0 - 90
FOREFOV *	List[float]	Fore field-of-view angle	1 - 1	-90.0 - 90
AFTFOV *	List[float]	Aft field-of-view angle	1 - 1	-90.0 - 90

* Required parameter

Parameter descriptions

PIXELPOS

Specifies the fractional pixel position for which the view zenith and azimuth angles will be calculated.

LINEPOS

Specifies the fractional line position for which the view zenith and azimuth angles will be calculated.

DBSZ

Specifies, in pixels and lines, the size of the database image.

SENSOR

Specifies the type of the sensor for which the view zenith and azimuth angles will be calculated.

If an unknown sensor type is specified, a generic view angles calculator is used, based solely on the field-of-view angles.

TILT

Specifies, in degrees, the platform tilt angle for which the view zenith and azimuth angles will be calculated. A positive tilt angle is equivalent to looking forward; a negative tilt angle is equivalent to looking backwards. A tilt angle of 0 is equivalent to looking straight down.

HEADING

Specifies, in degrees, the platform heading angle for which the view zenith and azimuth angles will be calculated. The heading angle is measured clockwise from North, with a heading of 0 degrees equivalent to moving North, a heading of 90 degrees equivalent to moving East, and so on.

LEFTFOV

Specifies, in degrees, the sensor left field-of-view angle for which the view zenith and azimuth angles will be calculated. A positive left field-of-view angle is equivalent to the sensor covering a swath to the left of the platform position. A negative left field-of-view angle is equivalent to the sensor covering a swath to the right of the platform position.

RIGHTFOV

Specifies, in degrees, the sensor right field-of-view angle for which the view zenith and azimuth angles will be calculated. A positive right field-of-view angle is equivalent to the sensor covering a swath to the right of the platform position. A negative right field-of-view angle is equivalent to the sensor covering a swath to the left of the platform position.

FOREFOV

Specifies, in degrees, the sensor forward field-of-view angle for which the view zenith and azimuth angles will be calculated. A positive forward field-of-view angle is equivalent to the sensor covering a swath in front of the platform position. A negative forward field-of-view angle is equivalent to the sensor covering a swath behind the platform position.

Pushbroom and whiskbroom sensors have 0 fore and aft field-of-view angles.

AFTFOV

Specifies, in degrees, the sensor aft field-of-view angle for which the view zenith and azimuth angles will be calculated. A positive aft field-of-view angle is equivalent to the sensor covering a swath behind the platform position. A negative aft field-of-view angle is equivalent to the sensor covering a swath to the front of the platform position.

Pushbroom and whiskbroom sensors have 0 fore and aft field-of-view angles.

Details

VIEWZAZ is a utility that facilitates the use of the atmospheric correction system. It outputs the view zenith and view azimuth angles in degrees for a specified database size, pixel and line position, sensor type, platform heading and tilt angles, and sensor left/right/fore/aft field-of-view angles.

The view zenith angle is the angle between the observer-to-ground and observer-to-zenith directions and can vary from 0 to 180, with 180 being when the platform is directly above the observed ground position.

The view azimuth angle is the angle between the observer-to-ground and observer-to-North directions, positive clockwise from observer-to-North.

Example

Calculate and display the hash values for each of the channels of the demo file, irvine.pix.

from pci.viewzaz import viewzaz

pixelpos	=	[10]	# pixel position
linepos	=	[10]	# line position
dbsz	=	[1000,1000]	# image size (pixels, lines)
sensor	=	""	# default, PUSHBROOM
tilt	=	[45]	# platform tilt angle
heading	=	[180]	# platform heading angle
leftfov	=	[45]	# left field-of-view angle
rightfov	=	[45]	# rightfield-of-view angle
forefov	=	[45]	# fore field-of-view angle
aftfov	=	[45]	# aft field-of-view angle

viewzaz( pixelpos, linepos, dbsz, sensor, tilt, heading, leftfov, rightfov, forefov, aftfov )