SAGA-GIS Tool Library Documentation (v7.2.0)

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


Parameters

 NameTypeIdentifierDescriptionConstraints
InputBand 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--
OutputSpectralGrid list (output)SPECTRAL--
ThermalGrid list (output)THERMAL--
PanchromaticGrid list (output)PANBAND--
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 pointSUN_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 CellsIntegerAC_DO_CELLSMinimum pixels to consider digital number as dark objectMinimum: 0
Default: 1000
Rayleigh ScatteringFloating pointAC_RAYLEIGHRayleigh atmosphere (diffuse sky irradiance)Minimum: 0.000000
Default: 0.000000
Solar RadianceFloating pointAC_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
(*) 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