Tool Top of Atmosphere Reflectance

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

Author: B.Bechtel, O.Conrad (c) 2013
Menu: Imagery|Landsat

Parameters

	Name	Type	Identifier	Description	Constraints
Input	Band 1 (*)	Grid (optional input)	`MSS01`	-	-
	Band 2 (*)	Grid (optional input)	`MSS02`	-	-
	Band 3 (*)	Grid (optional input)	`MSS03`	-	-
	Band 4 (*)	Grid (optional input)	`MSS04`	-	-
	Band 1 (*)	Grid (optional input)	`TM01`	-	-
	Band 2 (*)	Grid (optional input)	`TM02`	-	-
	Band 3 (*)	Grid (optional input)	`TM03`	-	-
	Band 4 (*)	Grid (optional input)	`TM04`	-	-
	Band 5 (*)	Grid (optional input)	`TM05`	-	-
	Band 7 (*)	Grid (optional input)	`TM07`	-	-
	Band 1 (*)	Grid (optional input)	`ETM01`	-	-
	Band 2 (*)	Grid (optional input)	`ETM02`	-	-
	Band 3 (*)	Grid (optional input)	`ETM03`	-	-
	Band 4 (*)	Grid (optional input)	`ETM04`	-	-
	Band 5 (*)	Grid (optional input)	`ETM05`	-	-
	Band 7 (*)	Grid (optional input)	`ETM07`	-	-
	Band 1 (*)	Grid (optional input)	`OLI01`	-	-
	Band 2 (*)	Grid (optional input)	`OLI02`	-	-
	Band 3 (*)	Grid (optional input)	`OLI03`	-	-
	Band 4 (*)	Grid (optional input)	`OLI04`	-	-
	Band 5 (*)	Grid (optional input)	`OLI05`	-	-
	Band 6 (*)	Grid (optional input)	`OLI06`	-	-
	Band 7 (*)	Grid (optional input)	`OLI07`	-	-
	Band 9 (*)	Grid (optional input)	`OLI09`	-	-
	Band 6 (*)	Grid (optional input)	`TM_T06`	-	-
	Band 61 (*)	Grid (optional input)	`ETM_T61`	-	-
	Band 62 (*)	Grid (optional input)	`ETM_T62`	-	-
	Band 10 (*)	Grid (optional input)	`TIRS10`	-	-
	Band 11 (*)	Grid (optional input)	`TIRS11`	-	-
	Band 8 (*)	Grid (optional input)	`PAN08`	-	-
Output	Spectral	Grid list (output)	`SPECTRAL`	-	-
	Thermal	Grid list (output)	`THERMAL`	-	-
	Panchromatic	Grid list (output)	`PANBAND`	-	-
Options	Spectral	Grid system	`MSS`	-	-
	Spectral	Grid system	`TM`	-	-
	Spectral	Grid system	`ETM`	-	-
	Spectral	Grid system	`OLI`	-	-
	Thermal	Grid system	`TM_T`	-	-
	Thermal	Grid system	`ETM_T`	-	-
	Thermal	Grid system	`TIRS`	-	-
	Panchromatic	Grid system	`PAN`	-	-
	Metadata File	File path	`METAFILE`	Name of Landsat metadata file (.met or MTL.txt)	-
	Spacecraft Sensor	Choice	`SENSOR`	-	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 Date	Text	`DATE_ACQU`	Image acquisition date (yyyy-mm-dd)	Default: 2001-01-01
	Image Creation Date	Text	`DATE_PROD`	Image creation date (yyyy-mm-dd)	Default: 2001-01-01
	Suns's Height	Floating point	`SUN_HGT`	Sun's height above horizon in degree	Minimum: 0.000000 Maximum: 90.000000 Default: 45.000000
	Spectral Output as Grid Collection	Boolean	`GRIDS_OUT`	-	Default: 1
	Name	Text	`GRIDS_NAME`	-	Default: Landsat Calibrated
	At-Sensor Radiance	Boolean	`AS_RAD`	Output at-sensor radiance for all bands	Default: 0
	Atmospheric Correction	Choice	`AC_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 Cells	Integer	`AC_DO_CELLS`	Minimum pixels to consider digital number as dark object	Minimum: 0 Default: 1000
	Rayleigh Scattering	Floating point	`AC_RAYLEIGH`	Rayleigh atmosphere (diffuse sky irradiance)	Minimum: 0.000000 Default: 0.000000
	Solar Radiance	Floating point	`AC_SUN_RAD`	Percent of solar radiance in path radiance	Minimum: 0.000000 Maximum: 100.000000 Default: 1.000000
	Band 1	Choice	`ETM_GAIN_10`	-	Available Choices: [0] low [1] high Default: 1
	Band 2	Choice	`ETM_GAIN_20`	-	Available Choices: [0] low [1] high Default: 1
	Band 3	Choice	`ETM_GAIN_30`	-	Available Choices: [0] low [1] high Default: 1
	Band 4	Choice	`ETM_GAIN_40`	-	Available Choices: [0] low [1] high Default: 1
	Band 5	Choice	`ETM_GAIN_50`	-	Available Choices: [0] low [1] high Default: 1
	Band 61	Choice	`ETM_GAIN_61`	-	Available Choices: [0] low [1] high Default: 0
	Band 62	Choice	`ETM_GAIN_62`	-	Available Choices: [0] low [1] high Default: 1
	Band 7	Choice	`ETM_GAIN_70`	-	Available Choices: [0] low [1] high Default: 1
	Band 8	Choice	`ETM_GAIN_80`	-	Available Choices: [0] low [1] high Default: 0
(*) optional

Command-line

Usage: saga_cmd imagery_tools 8 [-MSS01 <str>] [-MSS02 <str>] [-MSS03 <str>] [-MSS04 <str>] [-TM01 <str>] [-TM02 <str>] [-TM03 <str>] [-TM04 <str>] [-TM05 <str>] [-TM07 <str>] [-ETM01 <str>] [-ETM02 <str>] [-ETM03 <str>] [-ETM04 <str>] [-ETM05 <str>] [-ETM07 <str>] [-OLI01 <str>] [-OLI02 <str>] [-OLI03 <str>] [-OLI04 <str>] [-OLI05 <str>] [-OLI06 <str>] [-OLI07 <str>] [-OLI09 <str>] [-TM_T06 <str>] [-ETM_T61 <str>] [-ETM_T62 <str>] [-TIRS10 <str>] [-TIRS11 <str>] [-PAN08 <str>] [-SPECTRAL <str>] [-THERMAL <str>] [-PANBAND <str>] [-METAFILE <str>] [-SENSOR <str>] [-DATE_ACQU <str>] [-DATE_PROD <str>] [-SUN_HGT <double>] [-GRIDS_OUT <str>] [-GRIDS_NAME <str>] [-AS_RAD <str>] [-AC_METHOD <str>] [-AC_DO_CELLS <num>] [-AC_RAYLEIGH <double>] [-AC_SUN_RAD <double>] [-ETM_GAIN_10 <str>] [-ETM_GAIN_20 <str>] [-ETM_GAIN_30 <str>] [-ETM_GAIN_40 <str>] [-ETM_GAIN_50 <str>] [-ETM_GAIN_61 <str>] [-ETM_GAIN_62 <str>] [-ETM_GAIN_70 <str>] [-ETM_GAIN_80 <str>]
  -MSS01:<str>         	Band 1
	Grid (optional input)
  -MSS02:<str>         	Band 2
	Grid (optional input)
  -MSS03:<str>         	Band 3
	Grid (optional input)
  -MSS04:<str>         	Band 4
	Grid (optional input)
  -TM01:<str>          	Band 1
	Grid (optional input)
  -TM02:<str>          	Band 2
	Grid (optional input)
  -TM03:<str>          	Band 3
	Grid (optional input)
  -TM04:<str>          	Band 4
	Grid (optional input)
  -TM05:<str>          	Band 5
	Grid (optional input)
  -TM07:<str>          	Band 7
	Grid (optional input)
  -ETM01:<str>         	Band 1
	Grid (optional input)
  -ETM02:<str>         	Band 2
	Grid (optional input)
  -ETM03:<str>         	Band 3
	Grid (optional input)
  -ETM04:<str>         	Band 4
	Grid (optional input)
  -ETM05:<str>         	Band 5
	Grid (optional input)
  -ETM07:<str>         	Band 7
	Grid (optional input)
  -OLI01:<str>         	Band 1
	Grid (optional input)
  -OLI02:<str>         	Band 2
	Grid (optional input)
  -OLI03:<str>         	Band 3
	Grid (optional input)
  -OLI04:<str>         	Band 4
	Grid (optional input)
  -OLI05:<str>         	Band 5
	Grid (optional input)
  -OLI06:<str>         	Band 6
	Grid (optional input)
  -OLI07:<str>         	Band 7
	Grid (optional input)
  -OLI09:<str>         	Band 9
	Grid (optional input)
  -TM_T06:<str>        	Band 6
	Grid (optional input)
  -ETM_T61:<str>       	Band 61
	Grid (optional input)
  -ETM_T62:<str>       	Band 62
	Grid (optional input)
  -TIRS10:<str>        	Band 10
	Grid (optional input)
  -TIRS11:<str>        	Band 11
	Grid (optional input)
  -PAN08:<str>         	Band 8
	Grid (optional input)
  -SPECTRAL:<str>      	Spectral
	Grid list (output)
  -THERMAL:<str>       	Thermal
	Grid list (output)
  -PANBAND:<str>       	Panchromatic
	Grid list (output)
  -METAFILE:<str>      	Metadata File
	File path
  -SENSOR:<str>        	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:<str>     	Image Acquisition Date
	Text
	Default: 2001-01-01
  -DATE_PROD:<str>     	Image Creation Date
	Text
	Default: 2001-01-01
  -SUN_HGT:<double>    	Suns's Height
	Floating point
	Minimum: 0.000000
	Maximum: 90.000000
	Default: 45.000000
  -GRIDS_OUT:<str>     	Spectral Output as Grid Collection
	Boolean
	Default: 1
  -GRIDS_NAME:<str>    	Name
	Text
	Default: Landsat Calibrated
  -AS_RAD:<str>        	At-Sensor Radiance
	Boolean
	Default: 0
  -AC_METHOD:<str>     	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:<num>   	Minimum Number of Dark Object Cells
	Integer
	Minimum: 0
	Default: 1000
  -AC_RAYLEIGH:<double>	Rayleigh Scattering
	Floating point
	Minimum: 0.000000
	Default: 0.000000
  -AC_SUN_RAD:<double> 	Solar Radiance
	Floating point
	Minimum: 0.000000
	Maximum: 100.000000
	Default: 1.000000
  -ETM_GAIN_10:<str>   	Band 1
	Choice
	Available Choices:
	[0] low
	[1] high
	Default: 1
  -ETM_GAIN_20:<str>   	Band 2
	Choice
	Available Choices:
	[0] low
	[1] high
	Default: 1
  -ETM_GAIN_30:<str>   	Band 3
	Choice
	Available Choices:
	[0] low
	[1] high
	Default: 1
  -ETM_GAIN_40:<str>   	Band 4
	Choice
	Available Choices:
	[0] low
	[1] high
	Default: 1
  -ETM_GAIN_50:<str>   	Band 5
	Choice
	Available Choices:
	[0] low
	[1] high
	Default: 1
  -ETM_GAIN_61:<str>   	Band 61
	Choice
	Available Choices:
	[0] low
	[1] high
	Default: 0
  -ETM_GAIN_62:<str>   	Band 62
	Choice
	Available Choices:
	[0] low
	[1] high
	Default: 1
  -ETM_GAIN_70:<str>   	Band 7
	Choice
	Available Choices:
	[0] low
	[1] high
	Default: 1
  -ETM_GAIN_80:<str>   	Band 8
	Choice
	Available Choices:
	[0] low
	[1] high
	Default: 0