List of Routines By Functionality |  MISR Toolkit: Main Page

-Abstract

   MTK_LS_TO_LATLON returns a decimal latitude/longitude pair given a line and sample.

-Copyright

   Copyright (2005), California Institute of Technology.
   U.S. Government sponsorship acknowledged.

-I/O
   
   Given:
   
      mapinfo        MTK map info structure
      line           map fractional line (x.0 represents pixel center)
      sample         map fractional sample (x.0 represents pixel center)
   
   the call:
   
      status = MTK_LS_TO_LATLON( mapinfo, line, sample, lat, lon )
   
   returns:
   
      status         0 on success; otherwise failure
      lat            decimal latitude
      lon            decimal longitude

-Examples

      ;;
      ;; Set up input parameters
      ;;
      filename   = '../Mtk_testdata/in/MISR_AM1_GRP_ELLIPSOID_GM_P037_O029058_AA_F03_0024.hdf'
      gridname    = 'GreenBand'
      fieldname   = 'Green Radiance/RDQI'
      line        = 50.0
      sample      = 25.0
      start_block = 10
      end_block   = 15
      status = MTK_FILE_TO_PATH( filename, path )
      status = MTK_SETREGION_BY_PATH_BLOCKRANGE( path, start_block, end_block, region)
      status = MTK_READDATA( filename, gridname, fieldname, region, databuf, mapinfo )
      status = MTK_LS_TO_LATLON( mapinfo, line, sample, lat, lon )
      
      ;;
      ;; Output...
      ;;
      print, 'file name             : ', filename
      print, 'grid                  : ', gridname
      print, 'field                 : ', fieldname
      print, 'start block           : ', start_block
      print, 'end block             : ', end_block
      print, 'line                  : ', line
      print, 'sample                : ', sample
      print, '================================================='
      print, 'DECIMAL LATITUDE      : ',lat
      print, 'DECIMAL LONGITUDE     : ',lon

   IDL outputs:
   
      file name             : ../Mtk_testdata/in/MISR_AM1_GRP_ELLIPSOID_GM_P037_O029058_AA_F03_0024.hdf
      grid                  : GreenBand
      field                 : Green Radiance/RDQI
      start block           : 10
      end block             : 15
      line                  : 50.0
      sample                : 25.0
     =================================================
      DECIMAL LATITUDE      : 77.163654
      DECIMAL LONGITUDE     : 39.509401

-Particulars
   None.

-Required Reading
   For important details concerning this module's function, please refer to
   the MTK routine MtkLSToLatLon.c.

-Version
   -IDL-MTK Version 1.2.0