List of Routines By Functionality |  MISR Toolkit: Main Page

-Abstract

   MTK_TIMERANGE_TO_ORBITLIST returns a list of orbits given a period of time.

-Copyright

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

-I/O
   
   Given:
   
      start_time     beginning time
      end_time       ending time

   the call:
   
      status = MTK_TIMERANGE_TO_ORBITLIST( start_time, end_time, orbit_cnt, orbit_list )
   
   returns:
   
      status         0 on success; otherwise failure
      orbit_cnt      number of orbits returned
      orbit_list     array of returned orbits

-Examples

      ;;
      ;; Set up input parameters
      ;;
      start_time  = '2005-02-02T02:00:00Z' ;YYYY-MM-DDThh:mm:ssZ
      end_time    = '2005-02-02T03:00:00Z' ;YYYY-MM-DDThh:mm:ssZ
      status      = MTK_TIMERANGE_TO_ORBITLIST( start_time, end_time, orbit_cnt, orbit_list )
      
      ;;
      ;; Output...
      ;;
      print, 'start time            : ', start_time
      print, 'end time              : ', end_time
      print, '================================================='
      print, '--- ORBIT LIST ---'
      FOR i=0,orbit_cnt-1 DO PRINT, orbit_list[i]

   IDL outputs:
   
      start time            : 2005-02-02T02:00:00Z
      end time              : 2005-02-02T03:00:00Z
    =================================================
      --- ORBIT LIST ---
             27271
             27272

-Particulars
   None.

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

-Version
   -IDL-MTK Version 1.2.0