List of Routines By Functionality |  MISR Toolkit: Main Page

-Abstract

   MTK_REGION_PATH_TO_BLOCKRANGE returns a starting and ending block for a given path and region.

-Copyright

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

-I/O
   
   Given:
   
      region       region structure
      path         path number

   the call:
   
      status = MTK_REGION_PATH_TO_BLOCKRANGE( region, path, start_block, end_block )
   
   returns:
   
      status         0 on success; otherwise failure
      start_block    start block for region/path
      end_block      end block for region/path

-Examples

      ;;
      ;; Set up input parameters
      ;;
      path        = 37
      lat         = 66.0
      lon         = -89.0
      lat_extent  = 10.0
      lon_extent  = 10.0
      status      = MTK_SETREGION_BY_LATLON_EXTENT( lat, lon, lat_extent, lon_extent, "degrees", region )
      status      = MTK_REGION_PATH_TO_BLOCKRANGE( region, path, start_block, end_block )
      
      ;;
      ;; Output...
      ;;
      print, 'path                  : ', path
      print, 'center latitude       : ', lat
      print, 'center longitude      : ', lon
      print, 'latitudinal extent    : ', lat_extent
      print, 'longitudinal extent   : ', lon_extent
      print, '================================================='
      print, 'STARTING BLOCK        : ', start_block
      print, 'ENDING BLOCK          : ', end_block

   IDL outputs:
   
      path                  : 37
      center latitude       : 66.000
      center longitude      : -89.000
      latitudinal extent    : 10.000
      longitudinal extent   : 10.000
    =================================================
      STARTING BLOCK        : 32
      ENDING BLOCK          : 40

-Particulars
   None.

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

-Version
   -IDL-MTK Version 1.2.0