List of Routines By Functionality |  MISR Toolkit: Main Page

-Abstract

   MTK_REGION_TO_PATHLIST returns a list of paths intersecting a given region.

-Copyright

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

-I/O
   
   Given:
   
      region       region structure

   the call:
   
      status = MTK_REGION_TO_PATHLIST( region, path_cnt, path_list )
   
   returns:
   
      status         0 on success; otherwise failure
      path_cnt       number of paths returned
      path_list      array of returned paths

-Examples

      ;;
      ;; Set up input parameters
      ;;
      lat         = 40.0
      lon         = -120.0
      lat_extent  = 0.1
      lon_extent  = 0.1
      status      = MTK_SETREGION_BY_LATLON_EXTENT( lat, lon, lat_extent, lon_extent, "degrees", region )
      status      = MTK_REGION_TO_PATHLIST( region, path_cnt, path_list )
      
      ;;
      ;; Output...
      ;;
      print, 'center latitude       : ', lat
      print, 'center longitude      : ', lon
      print, 'latitudinal extent    : ', lat_extent
      print, 'longitudinal extent   : ', lon_extent
      print, '================================================='
      print, '--- PATH LIST ---'
      FOR i=0,path_cnt-1 DO PRINT, path_list[i]

   IDL outputs:
   
      center latitude       : 40.000
      center longitude      : 120.000
      latitudinal extent    : 0.100
      longitudinal extent   : 0.100
    =================================================
      --- PATH LIST ---
                41
                42
                43
                44
                45

-Particulars
   None.

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

-Version
   -IDL-MTK Version 1.2.0