List of Routines By Functionality |  MISR Toolkit: Main Page

-Abstract

   MTK_SETREGION_BY_ULC_LRC creates a region structure that defines an approximate region of interest given
   upper left corner and lower right corner latitude/longitude coordinates. This structure is used as input to
   other MTK routines, Mtk_ReadData in particular. 

-Copyright

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

-I/O
   
   Given:
   
      ul_lat         upper-left latitude
      ul_lon         upper-left longitude
      lr_lat         lower-right latitude
      lr_lon         lower-right longitude

   the call:
   
      status = MTK_SETREGION_BY_ULC_LRC( ul_lat, ul_lon, lr_lat, lr_lon, region )
   
   returns:
   
      status         0 on success; otherwise failure
      region         MTK region structure

-Examples

      ;;
      ;; Set up input parameters
      ;;
      ul_lat      = 67.0
      ul_lon      = -90.0
      lr_lat      = 65.0
      lr_lon      = -88.0
      status      = MTK_SETREGION_BY_ULC_LRC( ul_lat, ul_lon, lr_lat, lr_lon, region )
      
      ;;
      ;; Output...
      ;;
      print, 'upper-left latitude   : ', ul_lat
      print, 'upper-left longitude  : ', ul_lon
      print, 'lower-right latitude  : ', lr_lat
      print, 'lower-right longitude : ', lr_lon
      print, '================================================='
      FOR i=0,N_TAGS(region)-1 DO $
         PRINT, STRTRIM((TAG_NAMES(region))[i],2),': ', $
         STRTRIM(region.(i),2),FORMAT='(A-22,A2,A)'

   IDL outputs:
   
      upper-left latitude   : 67.0000
      upper-left longitude  : -90.0000
      lower-right latitude  : 65.0000
      lower-right longitude : -88.0000
    =================================================
      GEO_CTR_LAT           : 66.000000
      GEO_CTR_LON           : -89.000000
      HEXTENT_XLAT          : 111319.54
      HEXTENT_YLON          : 111319.54

-Particulars
   None.

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

-Version
   -IDL-MTK Version 1.2.0