themis tes overlay

From DavinciWiki

Contents: Description, Arguments, Usage, Examples, Images, Sub-Functions, Related Functions, Source

Description

themis_tes_overlay() - Search TES pixels over a THEMIS image meeting specific select criteria through standard mysql queries on the TES database at the MSFF. Requires a THEMIS radiance image after standard processing steps saved as “IXXXXXXXX.cub” for the image display.

Arguments and Return Values

Arguments: A THEMIS image ID

Return Value: A structure containing all TES data with information including each TES polygon coordinates, emissivity, ock, ick, detector

Usage

Syntax: themis_tes_overlay(id [,auto=0/1] [,ock_start=VAL] [,ock_end=VAL] [,minlat=VAL] [,maxlat=VAL] [,em_angle=VAL] [,in_angle=VAL] [,temperature=VAL] [,albedo=VAL] [,albedo=VAL] [,dust=VAL] [,waterice=VAL])

'id' - A string of THEMIS id in the form of IXXXXXXXX

'auto' – use pre-defined TES select criteria for semi-automatic (0) or fully automated (1) THEMIES atmospheric correction. Default is auto=1

'ock_start' – minimum orbit counter keeper number. Default is 1583

'ock_end' – maximum orbit counter keeper number. Default is 7000 for auto=0, or 10000 for auto=1

'minlat' – minimum latitude. Default is -60

'maxlat' – maximum latitude. Default is 60

'em_angle' – maximum emission angle. Default is 10

'in_angle' – maximum incidence angle. Default is 80

'temperatuer' – maximum target temperature. Default is 255 for auto=0, or 250 for auto=1

'albedo' – maximum lambert albedo. Default is 0.2 for auto=0, or 0.25 for auto=1

'dust' – maximum total dust opacity. Default is 0.15 for auto=0, or 0.25 for auto=1

'waterice' – maximum total water ice opacity. Default is 0.08 for auto=0, or 0.15 for auto=1

Examples

Usage 1: default auto=1 for relative lower quality TES selection with larger spatial coverage used for THEMIS automatic atmospheric correction

dv> out=themis_tes_overlay("I38360010")
Downloading.done.
Read TEXT file: 1 lines
Downloading.done.
Read TEXT file: 1 lines
Downloading.......done. 
.......................
struct, 9 elements
   wkt: Text Buffer with 1104 lines of text
   tesx: 1x1x143 array of float, bsq format [572 bytes]
   tesx73: 1x1x73 array of float, bsq format [292 bytes]
   emi: 1104x1x143 array of float, bsq format [631,488 bytes]
   emi73: 1104x1x73 array of float, bsq format [322,368 bytes]
   ock: 1104x1x1 array of short, bsq format [2,208 bytes]
   ick: 1104x1x1 array of short, bsq format [2,208 bytes]
   det: 1104x1x1 array of byte, bsq format [1,104 bytes]
   ock_ick_det: 4x1104x1 array of int, bsq format [17,664 bytes]
dv>

Usage 2: set auto=0 for high quality TES selection used for traditional THEMIS traditional atmospheric correction

dv> out=themis_tes_overlay("I38360010",auto=0)
Downloading.done.
Read TEXT file: 1 lines
Downloading.done.
Read TEXT file: 1 lines
Downloading.......done. 
.......................
struct, 9 elements
   wkt: Text Buffer with 365 lines of text
   tesx: 1x1x143 array of float, bsq format [572 bytes]
   tesx73: 1x1x73 array of float, bsq format [292 bytes]
   emi: 365x1x143 array of float, bsq format [208,780 bytes]
   emi73: 365x1x73 array of float, bsq format [106,580 bytes]
   ock: 365x1x1 array of short, bsq format [730 bytes]
   ick: 365x1x1 array of short, bsq format [730 bytes]
   det: 365x1x1 array of byte, bsq format [365 bytes]
   ock_ick_det: 4x365x1 array of int, bsq format [5,840 bytes] 
dv>

Images