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, input, optional | MSS01 | - | - |
| Band 2 (*) | Grid, input, optional | MSS02 | - | - |
| Band 3 (*) | Grid, input, optional | MSS03 | - | - |
| Band 4 (*) | Grid, input, optional | MSS04 | - | - |
| Band 1 (*) | Grid, input, optional | TM01 | - | - |
| Band 2 (*) | Grid, input, optional | TM02 | - | - |
| Band 3 (*) | Grid, input, optional | TM03 | - | - |
| Band 4 (*) | Grid, input, optional | TM04 | - | - |
| Band 5 (*) | Grid, input, optional | TM05 | - | - |
| Band 7 (*) | Grid, input, optional | TM07 | - | - |
| Band 1 (*) | Grid, input, optional | ETM01 | - | - |
| Band 2 (*) | Grid, input, optional | ETM02 | - | - |
| Band 3 (*) | Grid, input, optional | ETM03 | - | - |
| Band 4 (*) | Grid, input, optional | ETM04 | - | - |
| Band 5 (*) | Grid, input, optional | ETM05 | - | - |
| Band 7 (*) | Grid, input, optional | ETM07 | - | - |
| Band 1 (*) | Grid, input, optional | OLI01 | - | - |
| Band 2 (*) | Grid, input, optional | OLI02 | - | - |
| Band 3 (*) | Grid, input, optional | OLI03 | - | - |
| Band 4 (*) | Grid, input, optional | OLI04 | - | - |
| Band 5 (*) | Grid, input, optional | OLI05 | - | - |
| Band 6 (*) | Grid, input, optional | OLI06 | - | - |
| Band 7 (*) | Grid, input, optional | OLI07 | - | - |
| Band 9 (*) | Grid, input, optional | OLI09 | - | - |
| Band 6 (*) | Grid, input, optional | TM_T06 | - | - |
| Band 61 (*) | Grid, input, optional | ETM_T61 | - | - |
| Band 62 (*) | Grid, input, optional | ETM_T62 | - | - |
| Band 10 (*) | Grid, input, optional | TIRS10 | - | - |
| Band 11 (*) | Grid, input, optional | TIRS11 | - | - |
| Band 8 (*) | Grid, input, optional | 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, input, optional
-MSS02:<str> Band 2
Grid, input, optional
-MSS03:<str> Band 3
Grid, input, optional
-MSS04:<str> Band 4
Grid, input, optional
-TM01:<str> Band 1
Grid, input, optional
-TM02:<str> Band 2
Grid, input, optional
-TM03:<str> Band 3
Grid, input, optional
-TM04:<str> Band 4
Grid, input, optional
-TM05:<str> Band 5
Grid, input, optional
-TM07:<str> Band 7
Grid, input, optional
-ETM01:<str> Band 1
Grid, input, optional
-ETM02:<str> Band 2
Grid, input, optional
-ETM03:<str> Band 3
Grid, input, optional
-ETM04:<str> Band 4
Grid, input, optional
-ETM05:<str> Band 5
Grid, input, optional
-ETM07:<str> Band 7
Grid, input, optional
-OLI01:<str> Band 1
Grid, input, optional
-OLI02:<str> Band 2
Grid, input, optional
-OLI03:<str> Band 3
Grid, input, optional
-OLI04:<str> Band 4
Grid, input, optional
-OLI05:<str> Band 5
Grid, input, optional
-OLI06:<str> Band 6
Grid, input, optional
-OLI07:<str> Band 7
Grid, input, optional
-OLI09:<str> Band 9
Grid, input, optional
-TM_T06:<str> Band 6
Grid, input, optional
-ETM_T61:<str> Band 61
Grid, input, optional
-ETM_T62:<str> Band 62
Grid, input, optional
-TIRS10:<str> Band 10
Grid, input, optional
-TIRS11:<str> Band 11
Grid, input, optional
-PAN08:<str> Band 8
Grid, input, optional
-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