Top of Atmosphere Reflectance
- Author: B.Bechtel, O.Conrad (c) 2013
- Menu: Imagery | Landsat
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
| 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 number | 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 number | AC_DO_CELLS | Minimum pixels to consider digital number as dark object | Minimum: 0
Default: 1000 |
Rayleigh Scattering | floating point number | AC_RAYLEIGH | Rayleigh atmosphere (diffuse sky irradiance) | Minimum: 0.000000
Default: 0.000000 |
Solar Radiance | floating point number | 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 |
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