Module Top of Atmosphere Reflectance

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

References:
Landsat 7 Science Data Users Handbook

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

Parameters

	Name	Type	Identifier	Description	Constraints
Input	DN Band 1 (*)	Grid (optional input)	`DN_MSS01`	-	-
	DN Band 2 (*)	Grid (optional input)	`DN_MSS02`	-	-
	DN Band 3 (*)	Grid (optional input)	`DN_MSS03`	-	-
	DN Band 4 (*)	Grid (optional input)	`DN_MSS04`	-	-
	DN Band 1 (*)	Grid (optional input)	`DN_ETM01`	-	-
	DN Band 2 (*)	Grid (optional input)	`DN_ETM02`	-	-
	DN Band 3 (*)	Grid (optional input)	`DN_ETM03`	-	-
	DN Band 4 (*)	Grid (optional input)	`DN_ETM04`	-	-
	DN Band 5 (*)	Grid (optional input)	`DN_ETM05`	-	-
	DN Band 7 (*)	Grid (optional input)	`DN_ETM07`	-	-
	DN Band 1 (*)	Grid (optional input)	`DN_OLI01`	-	-
	DN Band 2 (*)	Grid (optional input)	`DN_OLI02`	-	-
	DN Band 3 (*)	Grid (optional input)	`DN_OLI03`	-	-
	DN Band 4 (*)	Grid (optional input)	`DN_OLI04`	-	-
	DN Band 5 (*)	Grid (optional input)	`DN_OLI05`	-	-
	DN Band 6 (*)	Grid (optional input)	`DN_OLI06`	-	-
	DN Band 7 (*)	Grid (optional input)	`DN_OLI07`	-	-
	DN Band 9 (*)	Grid (optional input)	`DN_OLI09`	-	-
	DN Band 6 (*)	Grid (optional input)	`DN__TM06`	-	-
	DN Band 61 (*)	Grid (optional input)	`DN_ETM61`	-	-
	DN Band 62 (*)	Grid (optional input)	`DN_ETM62`	-	-
	DN Band 10 (*)	Grid (optional input)	`DN_OLI10`	-	-
	DN Band 11 (*)	Grid (optional input)	`DN_OLI11`	-	-
	DN Band 8 (*)	Grid (optional input)	`DN_PAN08`	-	-
Output	Reflectance Band 1 (*)	Grid (optional output)	`RF_MSS01`	-	-
	Reflectance Band 2 (*)	Grid (optional output)	`RF_MSS02`	-	-
	Reflectance Band 3 (*)	Grid (optional output)	`RF_MSS03`	-	-
	Reflectance Band 4 (*)	Grid (optional output)	`RF_MSS04`	-	-
	Reflectance Band 1 (*)	Grid (optional output)	`RF_ETM01`	-	-
	Reflectance Band 2 (*)	Grid (optional output)	`RF_ETM02`	-	-
	Reflectance Band 3 (*)	Grid (optional output)	`RF_ETM03`	-	-
	Reflectance Band 4 (*)	Grid (optional output)	`RF_ETM04`	-	-
	Reflectance Band 5 (*)	Grid (optional output)	`RF_ETM05`	-	-
	Reflectance Band 7 (*)	Grid (optional output)	`RF_ETM07`	-	-
	Reflectance Band 1 (*)	Grid (optional output)	`RF_OLI01`	-	-
	Reflectance Band 2 (*)	Grid (optional output)	`RF_OLI02`	-	-
	Reflectance Band 3 (*)	Grid (optional output)	`RF_OLI03`	-	-
	Reflectance Band 4 (*)	Grid (optional output)	`RF_OLI04`	-	-
	Reflectance Band 5 (*)	Grid (optional output)	`RF_OLI05`	-	-
	Reflectance Band 6 (*)	Grid (optional output)	`RF_OLI06`	-	-
	Reflectance Band 7 (*)	Grid (optional output)	`RF_OLI07`	-	-
	Reflectance Band 9 (*)	Grid (optional output)	`RF_OLI09`	-	-
	Reflectance Band 6 (*)	Grid (optional output)	`RF__TM06`	-	-
	Reflectance Band 61 (*)	Grid (optional output)	`RF_ETM61`	-	-
	Reflectance Band 62 (*)	Grid (optional output)	`RF_ETM62`	-	-
	Reflectance Band 10 (*)	Grid (optional output)	`RF_OLI10`	-	-
	Reflectance Band 11 (*)	Grid (optional output)	`RF_OLI11`	-	-
	Reflectance Band 8 (*)	Grid (optional output)	`RF_PAN08`	-	-
Options	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
	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)	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 [-DN_MSS01 <str>] [-DN_MSS02 <str>] [-DN_MSS03 <str>] [-DN_MSS04 <str>] [-RF_MSS01 <str>] [-RF_MSS02 <str>] [-RF_MSS03 <str>] [-RF_MSS04 <str>] [-DN_ETM01 <str>] [-DN_ETM02 <str>] [-DN_ETM03 <str>] [-DN_ETM04 <str>] [-DN_ETM05 <str>] [-DN_ETM07 <str>] [-RF_ETM01 <str>] [-RF_ETM02 <str>] [-RF_ETM03 <str>] [-RF_ETM04 <str>] [-RF_ETM05 <str>] [-RF_ETM07 <str>] [-DN_OLI01 <str>] [-DN_OLI02 <str>] [-DN_OLI03 <str>] [-DN_OLI04 <str>] [-DN_OLI05 <str>] [-DN_OLI06 <str>] [-DN_OLI07 <str>] [-DN_OLI09 <str>] [-RF_OLI01 <str>] [-RF_OLI02 <str>] [-RF_OLI03 <str>] [-RF_OLI04 <str>] [-RF_OLI05 <str>] [-RF_OLI06 <str>] [-RF_OLI07 <str>] [-RF_OLI09 <str>] [-DN__TM06 <str>] [-RF__TM06 <str>] [-DN_ETM61 <str>] [-DN_ETM62 <str>] [-RF_ETM61 <str>] [-RF_ETM62 <str>] [-DN_OLI10 <str>] [-DN_OLI11 <str>] [-RF_OLI10 <str>] [-RF_OLI11 <str>] [-DN_PAN08 <str>] [-RF_PAN08 <str>] [-METAFILE <str>] [-SENSOR <str>] [-DATE_ACQU <str>] [-DATE_PROD <str>] [-SUN_HGT <str>] [-AS_RAD <str>] [-AC_METHOD <str>] [-AC_DO_CELLS <num>] [-AC_RAYLEIGH <str>] [-AC_SUN_RAD <str>] [-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>]
  -DN_MSS01:<str>   	DN Band 1
	Grid (optional input)
  -DN_MSS02:<str>   	DN Band 2
	Grid (optional input)
  -DN_MSS03:<str>   	DN Band 3
	Grid (optional input)
  -DN_MSS04:<str>   	DN Band 4
	Grid (optional input)
  -RF_MSS01:<str>   	Reflectance Band 1
	Grid (optional output)
  -RF_MSS02:<str>   	Reflectance Band 2
	Grid (optional output)
  -RF_MSS03:<str>   	Reflectance Band 3
	Grid (optional output)
  -RF_MSS04:<str>   	Reflectance Band 4
	Grid (optional output)
  -DN_ETM01:<str>   	DN Band 1
	Grid (optional input)
  -DN_ETM02:<str>   	DN Band 2
	Grid (optional input)
  -DN_ETM03:<str>   	DN Band 3
	Grid (optional input)
  -DN_ETM04:<str>   	DN Band 4
	Grid (optional input)
  -DN_ETM05:<str>   	DN Band 5
	Grid (optional input)
  -DN_ETM07:<str>   	DN Band 7
	Grid (optional input)
  -RF_ETM01:<str>   	Reflectance Band 1
	Grid (optional output)
  -RF_ETM02:<str>   	Reflectance Band 2
	Grid (optional output)
  -RF_ETM03:<str>   	Reflectance Band 3
	Grid (optional output)
  -RF_ETM04:<str>   	Reflectance Band 4
	Grid (optional output)
  -RF_ETM05:<str>   	Reflectance Band 5
	Grid (optional output)
  -RF_ETM07:<str>   	Reflectance Band 7
	Grid (optional output)
  -DN_OLI01:<str>   	DN Band 1
	Grid (optional input)
  -DN_OLI02:<str>   	DN Band 2
	Grid (optional input)
  -DN_OLI03:<str>   	DN Band 3
	Grid (optional input)
  -DN_OLI04:<str>   	DN Band 4
	Grid (optional input)
  -DN_OLI05:<str>   	DN Band 5
	Grid (optional input)
  -DN_OLI06:<str>   	DN Band 6
	Grid (optional input)
  -DN_OLI07:<str>   	DN Band 7
	Grid (optional input)
  -DN_OLI09:<str>   	DN Band 9
	Grid (optional input)
  -RF_OLI01:<str>   	Reflectance Band 1
	Grid (optional output)
  -RF_OLI02:<str>   	Reflectance Band 2
	Grid (optional output)
  -RF_OLI03:<str>   	Reflectance Band 3
	Grid (optional output)
  -RF_OLI04:<str>   	Reflectance Band 4
	Grid (optional output)
  -RF_OLI05:<str>   	Reflectance Band 5
	Grid (optional output)
  -RF_OLI06:<str>   	Reflectance Band 6
	Grid (optional output)
  -RF_OLI07:<str>   	Reflectance Band 7
	Grid (optional output)
  -RF_OLI09:<str>   	Reflectance Band 9
	Grid (optional output)
  -DN__TM06:<str>   	DN Band 6
	Grid (optional input)
  -RF__TM06:<str>   	Reflectance Band 6
	Grid (optional output)
  -DN_ETM61:<str>   	DN Band 61
	Grid (optional input)
  -DN_ETM62:<str>   	DN Band 62
	Grid (optional input)
  -RF_ETM61:<str>   	Reflectance Band 61
	Grid (optional output)
  -RF_ETM62:<str>   	Reflectance Band 62
	Grid (optional output)
  -DN_OLI10:<str>   	DN Band 10
	Grid (optional input)
  -DN_OLI11:<str>   	DN Band 11
	Grid (optional input)
  -RF_OLI10:<str>   	Reflectance Band 10
	Grid (optional output)
  -RF_OLI11:<str>   	Reflectance Band 11
	Grid (optional output)
  -DN_PAN08:<str>   	DN Band 8
	Grid (optional input)
  -RF_PAN08:<str>   	Reflectance Band 8
	Grid (optional 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:<str>    	Suns's Height
	Floating point
	Minimum: 0.000000
	Maximum: 90.000000
	Default: 45.000000
  -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:<str>	Rayleigh Scattering
	Floating point
	Default: 0.000000
  -AC_SUN_RAD:<str> 	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