List of Routines By Functionality |  MISR Toolkit: Main Page

-Abstract

   MTK_BLS_TO_SOMXY converts from block, line, and sample to Space Oblique Mercator (SOM) X and Y 
   coordinates 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
      block     block number (1-based)
      line      block fractional line (x.0 represents pixel center)
      sample    block fractional sample (x.0 represents pixel center)
   
   the call:
   
      status = MTK_BLS_TO_SOMXY( path, res, block, line, sample, somx, somy )
   
   returns:
   
      status  0 on success; otherwise failure
      somx    SOM X in meters
      somy    SOM Y in meters
      
-Examples

      ;;
      ;; Set up input parameters
      ;;
      path  = 230
      res   = 1100.0
      block = 69
      line  = 100.2
      samp  = 89.9
      
      status = MTK_BLS_TO_SOMXY( path, res, block, line, samp, somx, somy )
      
      ;;
      ;; Output...
      ;;
      print, 'path                  : ', path
      print, 'resolution (meters)   : ', res
      print, 'block number          : ', block
      print, 'block line            : ', line
      print, 'block sample          : ', samp
      print, '================================================='
      print, 'SOM X                 : ', somx, FORMAT = '(A,F15.3)'
      print, 'SOM Y                 : ', somy, FORMAT = '(A,F15.3)'

   IDL outputs:
   
      path                  : 230
      resolution (meters)   : 1100.000
      block number          : 69
      block line            : 100.2000
      block sample          : 89.9000
      =================================================
      SOM X                 : 17145919.997
      SOM Y                 :   222089.993

-Particulars
   None.

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

-Version
   -IDL-MTK Version 1.2.0