SAGA 9.4.2 | Tool Library Documentation

Top of Atmosphere Reflectance


Description

Calculation of top-of-atmosphere radiance or reflectance and temperature (TOAR) for Landsat MSS/TM/ETM+. This tool incorporates E.J. Tizado's GRASS GIS implementation (i.landsat.toar).


References


Parameters

 NameTypeIdentifierDescriptionConstraints
InputBand 1grid, input, optionalMSS01--
Band 2grid, input, optionalMSS02--
Band 3grid, input, optionalMSS03--
Band 4grid, input, optionalMSS04--
Band 1grid, input, optionalTM01--
Band 2grid, input, optionalTM02--
Band 3grid, input, optionalTM03--
Band 4grid, input, optionalTM04--
Band 5grid, input, optionalTM05--
Band 7grid, input, optionalTM07--
Band 1grid, input, optionalETM01--
Band 2grid, input, optionalETM02--
Band 3grid, input, optionalETM03--
Band 4grid, input, optionalETM04--
Band 5grid, input, optionalETM05--
Band 7grid, input, optionalETM07--
Band 1grid, input, optionalOLI01--
Band 2grid, input, optionalOLI02--
Band 3grid, input, optionalOLI03--
Band 4grid, input, optionalOLI04--
Band 5grid, input, optionalOLI05--
Band 6grid, input, optionalOLI06--
Band 7grid, input, optionalOLI07--
Band 9grid, input, optionalOLI09--
Band 6grid, input, optionalTM_T06--
Band 61grid, input, optionalETM_T61--
Band 62grid, input, optionalETM_T62--
Band 10grid, input, optionalTIRS10--
Band 11grid, input, optionalTIRS11--
Band 8grid, input, optionalPAN08--
OutputSpectralgrid list, outputSPECTRAL--
Thermalgrid list, outputTHERMAL--
Panchromaticgrid list, outputPANBAND--
OptionsSpectralgrid systemMSS--
Spectralgrid systemTM--
Spectralgrid systemETM--
Spectralgrid systemOLI--
Thermalgrid systemTM_T--
Thermalgrid systemETM_T--
Thermalgrid systemTIRS--
Panchromaticgrid systemPAN--
Metadata Filefile pathMETAFILEName of Landsat metadata file (.met or MTL.txt)-
Spacecraft SensorchoiceSENSOR-Available Choices: [0] Landsat-1 MSS [1] Landsat-2 MSS [2] Landsat-3 MSS [3] Landsat-4 MSS [4] Landsat-5 MSS [5] Landsat-4 TM [6] Landsat-5 TM [7] Landsat-7 ETM+ [8] Landsat-8 OLI/TIRS Default: 7
Image Acquisition DatetextDATE_ACQUImage acquisition date (yyyy-mm-dd)Default: 2001-01-01
Image Creation DatetextDATE_PRODImage creation date (yyyy-mm-dd)Default: 2001-01-01
Suns's Heightfloating point numberSUN_HGTSun's height above horizon in degreeMinimum: 0.000000 Maximum: 90.000000 Default: 45.000000
Spectral Output as Grid CollectionbooleanGRIDS_OUT-Default: 1
NametextGRIDS_NAME-Default: Landsat Calibrated
At-Sensor RadiancebooleanAS_RADOutput at-sensor radiance for all bandsDefault: 0
Atmospheric CorrectionchoiceAC_METHOD-Available Choices: [0] uncorrected [1] corrected [2] dark object subtraction 1 [3] dark object subtraction 2 [4] dark object subtraction 2b [5] dark object subtraction 3 [6] dark object subtraction 4 Default: 0
Minimum Number of Dark Object Cellsinteger numberAC_DO_CELLSMinimum pixels to consider digital number as dark objectMinimum: 0 Default: 1000
Rayleigh Scatteringfloating point numberAC_RAYLEIGHRayleigh atmosphere (diffuse sky irradiance)Minimum: 0.000000 Default: 0.000000
Solar Radiancefloating point numberAC_SUN_RADPercent of solar radiance in path radianceMinimum: 0.000000 Maximum: 100.000000 Default: 1.000000
Band 1choiceETM_GAIN_10-Available Choices: [0] low [1] high Default: 1
Band 2choiceETM_GAIN_20-Available Choices: [0] low [1] high Default: 1
Band 3choiceETM_GAIN_30-Available Choices: [0] low [1] high Default: 1
Band 4choiceETM_GAIN_40-Available Choices: [0] low [1] high Default: 1
Band 5choiceETM_GAIN_50-Available Choices: [0] low [1] high Default: 1
Band 61choiceETM_GAIN_61-Available Choices: [0] low [1] high Default: 0
Band 62choiceETM_GAIN_62-Available Choices: [0] low [1] high Default: 1
Band 7choiceETM_GAIN_70-Available Choices: [0] low [1] high Default: 1
Band 8choiceETM_GAIN_80-Available Choices: [0] low [1] high Default: 0

Command Line


Usage: saga_cmd imagery_tools 8 [-MSS01 ] [-MSS02 ] [-MSS03 ] [-MSS04 ] [-TM01 ] [-TM02 ] [-TM03 ] [-TM04 ] [-TM05 ] [-TM07 ] [-ETM01 ] [-ETM02 ] [-ETM03 ] [-ETM04 ] [-ETM05 ] [-ETM07 ] [-OLI01 ] [-OLI02 ] [-OLI03 ] [-OLI04 ] [-OLI05 ] [-OLI06 ] [-OLI07 ] [-OLI09 ] [-TM_T06 ] [-ETM_T61 ] [-ETM_T62 ] [-TIRS10 ] [-TIRS11 ] [-PAN08 ] [-SPECTRAL ] [-THERMAL ] [-PANBAND ] [-METAFILE ] [-SENSOR ] [-DATE_ACQU ] [-DATE_PROD ] [-SUN_HGT ] [-GRIDS_OUT ] [-GRIDS_NAME ] [-AS_RAD ] [-AC_METHOD ] [-AC_DO_CELLS ] [-AC_RAYLEIGH ] [-AC_SUN_RAD ] [-ETM_GAIN_10 ] [-ETM_GAIN_20 ] [-ETM_GAIN_30 ] [-ETM_GAIN_40 ] [-ETM_GAIN_50 ] [-ETM_GAIN_61 ] [-ETM_GAIN_62 ] [-ETM_GAIN_70 ] [-ETM_GAIN_80 ]
  -MSS01:         	Band 1
	grid, input, optional
  -MSS02:         	Band 2
	grid, input, optional
  -MSS03:         	Band 3
	grid, input, optional
  -MSS04:         	Band 4
	grid, input, optional
  -TM01:          	Band 1
	grid, input, optional
  -TM02:          	Band 2
	grid, input, optional
  -TM03:          	Band 3
	grid, input, optional
  -TM04:          	Band 4
	grid, input, optional
  -TM05:          	Band 5
	grid, input, optional
  -TM07:          	Band 7
	grid, input, optional
  -ETM01:         	Band 1
	grid, input, optional
  -ETM02:         	Band 2
	grid, input, optional
  -ETM03:         	Band 3
	grid, input, optional
  -ETM04:         	Band 4
	grid, input, optional
  -ETM05:         	Band 5
	grid, input, optional
  -ETM07:         	Band 7
	grid, input, optional
  -OLI01:         	Band 1
	grid, input, optional
  -OLI02:         	Band 2
	grid, input, optional
  -OLI03:         	Band 3
	grid, input, optional
  -OLI04:         	Band 4
	grid, input, optional
  -OLI05:         	Band 5
	grid, input, optional
  -OLI06:         	Band 6
	grid, input, optional
  -OLI07:         	Band 7
	grid, input, optional
  -OLI09:         	Band 9
	grid, input, optional
  -TM_T06:        	Band 6
	grid, input, optional
  -ETM_T61:       	Band 61
	grid, input, optional
  -ETM_T62:       	Band 62
	grid, input, optional
  -TIRS10:        	Band 10
	grid, input, optional
  -TIRS11:        	Band 11
	grid, input, optional
  -PAN08:         	Band 8
	grid, input, optional
  -SPECTRAL:      	Spectral
	grid list, output
  -THERMAL:       	Thermal
	grid list, output
  -PANBAND:       	Panchromatic
	grid list, output
  -METAFILE:      	Metadata File
	file path
  -SENSOR:        	Spacecraft Sensor
	choice
	Available Choices:
	[0] Landsat-1 MSS
	[1] Landsat-2 MSS
	[2] Landsat-3 MSS
	[3] Landsat-4 MSS
	[4] Landsat-5 MSS
	[5] Landsat-4 TM
	[6] Landsat-5 TM
	[7] Landsat-7 ETM+
	[8] Landsat-8 OLI/TIRS
	Default: 7
  -DATE_ACQU:     	Image Acquisition Date
	text
	Default: 2001-01-01
  -DATE_PROD:     	Image Creation Date
	text
	Default: 2001-01-01
  -SUN_HGT:    	Suns's Height
	floating point number
	Minimum: 0.000000
	Maximum: 90.000000
	Default: 45.000000
  -GRIDS_OUT:     	Spectral Output as Grid Collection
	boolean
	Default: 1
  -GRIDS_NAME:    	Name
	text
	Default: Landsat Calibrated
  -AS_RAD:        	At-Sensor Radiance
	boolean
	Default: 0
  -AC_METHOD:     	Atmospheric Correction
	choice
	Available Choices:
	[0] uncorrected
	[1] corrected
	[2] dark object subtraction 1
	[3] dark object subtraction 2
	[4] dark object subtraction 2b
	[5] dark object subtraction 3
	[6] dark object subtraction 4
	Default: 0
  -AC_DO_CELLS:   	Minimum Number of Dark Object Cells
	integer number
	Minimum: 0
	Default: 1000
  -AC_RAYLEIGH:	Rayleigh Scattering
	floating point number
	Minimum: 0.000000
	Default: 0.000000
  -AC_SUN_RAD: 	Solar Radiance
	floating point number
	Minimum: 0.000000
	Maximum: 100.000000
	Default: 1.000000
  -ETM_GAIN_10:   	Band 1
	choice
	Available Choices:
	[0] low
	[1] high
	Default: 1
  -ETM_GAIN_20:   	Band 2
	choice
	Available Choices:
	[0] low
	[1] high
	Default: 1
  -ETM_GAIN_30:   	Band 3
	choice
	Available Choices:
	[0] low
	[1] high
	Default: 1
  -ETM_GAIN_40:   	Band 4
	choice
	Available Choices:
	[0] low
	[1] high
	Default: 1
  -ETM_GAIN_50:   	Band 5
	choice
	Available Choices:
	[0] low
	[1] high
	Default: 1
  -ETM_GAIN_61:   	Band 61
	choice
	Available Choices:
	[0] low
	[1] high
	Default: 0
  -ETM_GAIN_62:   	Band 62
	choice
	Available Choices:
	[0] low
	[1] high
	Default: 1
  -ETM_GAIN_70:   	Band 7
	choice
	Available Choices:
	[0] low
	[1] high
	Default: 1
  -ETM_GAIN_80:   	Band 8
	choice
	Available Choices:
	[0] low
	[1] high
	Default: 0