List of Routines By Functionality |  MISR Toolkit: Main Page

-Abstract

   MTK_SOMXY_TO_BLS converts from Space Oblique Mercator (SOM) X and Y coordinates 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
      somx      SOM X in meters
      somy      SOM Y in meters
   
   the call:
   
      status = MTK_SOMXY_TO_BLS( path, res, somx, somy, 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  = 230
      res   = 1100.0
      somx  = 17145920.0
      somy  = 222090.0
      
      status = MTK_SOMXY_TO_BLS( path, res, somx, somy, block, line, samp )
      
      ;;
      ;; Output...
      ;;
      print, 'path                  : ', path
      print, 'resolution (meters)   : ', res
      print, 'SOM X                 : ', somx
      print, 'SOM Y                 : ', somy
      print, '================================================='
      print, 'BLOCK                 : ', block
      print, 'BLOCK LINE            : ', line
      print, 'BLOCK SAMPLE          : ', samp

   IDL outputs:
   
      path                  : 230
      resolution (meters)   : 1100.000
      SOM X                 : 1.71459e+07
      SOM Y                 : 222090.
      =================================================
      BLOCK                 : 69
      BLOCK LINE            : 100.200
      BLOCK SAMPLE          : 89.9000

-Particulars
   None.

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

-Version
   -IDL-MTK Version 1.2.0