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
- GRASS i.landsat.toar
- Landsat 7 Science Data Users Handbook
- Landsat 8 (L8) Data Users Handbook
- Level-1 Landsat Data Products Metadata
- 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