List of Routines By Functionality |  MISR Toolkit: Main Page

-Abstract

   MTK_LATLON_TO_BLS converts from decimal latitude and longitude to block, line, and sample for a given
   MISR path and resolution.

-Copyright

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

-I/O
   
   Given:
   
      path      MISR path
      res       resolution in meters
      lat       decimal latitude
      lon       decimal longitude
   
   the call:
   
      status = MTK_LATLON_TO_BLS( path, res, lat, lon, block, line, sample )
   
   returns:
   
      status  0 on success; otherwise failure
      block   block number (1-based)
      line    block fractional line (x.0 represents pixel center)
      sample  block fractional sample (x.0 represents pixel center)
     
-Examples

      ;;
      ;; Set up input parameters
      ;;
      path  = 160
      res   = 1100.0
      lat   = 57.1
      lon   = 65.7
      
      status = MTK_LATLON_TO_BLS( path, res, lat, lon, block, line, sample )
      
      ;;
      ;; Output...
      ;;
      print, 'path                  : ', path
      print, 'resolution (meters)   : ', res
      print, 'latitude              : ', lat
      print, 'longitude             : ', lon
      print, '================================================='
      print, 'BLOCK                 : ', block
      print, 'BLOCK LINE            : ', line
      print, 'BLOCK SAMPLE          : ', sample

   IDL outputs:
   
      path                  : 160
      resolution (meters)   : 1100.000
      latitude              : 57.1000
      longitude             : 65.7000
      =================================================
      BLOCK                 : 45
      BLOCK LINE            : 19.5220
      BLOCK SAMPLE          : 65.7000

-Particulars
   None.

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

-Version
   -IDL-MTK Version 1.2.0