SOLARZAZ

Calculate solar zenith and solar azimuth angles


EnvironmentsPYTHON :: EASI :: MODELER
Quick linksDescription :: Parameters :: Parameter descriptions :: Details :: Example :: Acknowledgements :: Related

Back to top

Description


SOLARZAZ calculates the solar zenith angle and azimuth for a user-specified date, time-of-day, and Earth location.
Back to top

Parameters


Name Type Caption Length Value range
DATE* Integer Date (day,month,year) 3 - 3  
TIME* Integer Time of day (hour,minute,second) 2 - 3  
LATI* Float Latitude for calculation 1 - 1 -90.0 - 90.0
LONGI* Float Longitude for calculation 1 - 1 -180.0 - 180.0
REPORT String Report mode 0 - 192 Quick links

* Required parameter
Back to top

Parameter descriptions

DATE

Specifies the date for which the solar zenith and azimuth angles will be computed.

TIME

Specifies the time of day for which the solar zenith and azimuth angles will be computed.

If not specified, seconds default to 0.

LATI

Specifies the latitude for which the solar zenith and azimuth angles will be computed.

LONGI

Specifies the longitude for which the solar zenith and azimuth angles will be computed.

REPORT

Specifies where to direct the generated report.

Available options are:

Back to top

Details

SOLARZAZ is a utility that facilitates the use of the atmospheric correction system. It outputs the solar zenith and solar azimuth angles for a specified date and time of day, and latitude and longitude coordinates.

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

The solar azimuth angle is the angle between the ground-to-sun and ground-to-North directions, positive clockwise from ground-to-North. The solar azimuth is 0 if the sun is to the North of the observed ground position, 90, if the sun is to the East of the observed ground position, and so on.

Back to top

Example

This example demonstrates the use of SOLARZAZ to determine the solar zenith and azimuth angles for an AVIRIS scene.

The image data was acquired by the AVIRIS whiskbroom sensor. The following ancillary data are required for the solar angles calculation:

year 1997, month 06, day 19, hour 20
EASI>date	=	19,6,1997	! date (day,month,year)
EASI>time	=	20,0	! time (hour,minute)
EASI>lati	=	37.70259	! latitude
EASI>longi	=	-117.20816	! longitude

EASI>run SOLARZAZ

The following report is generated:

Date               : 19/6/1997
Time               : 20:0:0
Latitude           : 37.702591
Longitude          : -117.208160
Solar zenith angle : 14.422653
Solar azimuth angle: 189.300247
Back to top

Acknowledgements

PCI Geomatics received financial support from the Canadian Space Agency/L'Agence Spatiale Canadienne through the Earth Observation Application Development Program (EOADP) for the development of this software, under contract 9F028-0-4914/09.

© PCI Geomatics Enterprises, Inc.®, 2024. All rights reserved.