Index Page
cspice_wnincd
A  B  C  D  E  F  G  H  I  J  K  L  M  N  O  P  Q  R  S  T  U  V  W  X 

Abstract
I/O
Examples
Particulars
Required Reading
Version
Index_Entries

Abstract


   CSPICE_WNINCD determines whether an interval is 
   included in a double precision window.

   For important details concerning this module's function, please refer to
   the CSPICE routine wnincd_c.

I/O

   
   Given:

      left, 
      right    the scalar, double precision endpoints of an 
               interval, which may or may not be contained in 
               one of the intervals in window.       
      
      window   scalar, double precision window, containing
               zero or more intervals. 

               The user must create 'window' using 
               cspice_celld.

   the call:

      boolean = cspice_wnincd( left, right, window )

   returns:
   
      a scalar boolean, TRUE if the input interval is included 
      in the input window---that is, if  

         a(i)  <  left  <  right  <  b(i) 
               -        -         - 
            
      for some interval [ a(i), b(i) ] in window---and returns FALSE 
      otherwise. 

Examples


   Any numerical results shown for this example may differ between
   platforms as the results depend on the SPICE kernels used as input
   and the machine specific arithmetic implementation.

      ;; 
      ;; Create a cell containing a double precision
      ;; 8-vector.
      ;;
      win1 = cspice_celld( 8 )

      ;;
      ;; Define a window with three intervals.
      ;;
      darray = [ [ 1.d, 3.0], [ 7.0, 11.0], [23.0, 27.0] ]

      ;;
      ;; Add the window data to the cell.
      ;;
      for i=0, 2 do begin

         cspice_wninsd, darray[0,i], darray[1,i], win1

      endfor

      ;;
      ;; Define a set of test intervals.
      ;;
      test_array = [ [ 1.d, 3.d0], [ 9.d, 10.d], $
                     [ 0.d, 2.d0], [13.d, 15.d], $
                     [29.d,30.d] ]

      for i=0, (n_elements(test_array)/2) -1 do begin

        if( cspice_wnincd( test_array[0,i], $
                           test_array[1,i], win1) ) then begin
         
            print, test_array[0,i], test_array[1,i], +$
                          " - an element of the window"
         
         endif else begin
         
            print, test_array[0,i], test_array[1,i], +$
                      " - not an element of the window"
         
         endelse

      endfor

   IDL outputs:

      1.0000000   3.0000000 - an element of the window
      9.0000000   10.000000 - an element of the window
      0.0000000   2.0000000 - not an element of the window
      13.000000   15.000000 - not an element of the window
      29.000000   30.000000 - not an element of the window

Particulars


   The user must create any needed window structures with
   cspice_celld prior to use regardless of whether the routine
   uses the window as input or returns it as output.

Required Reading


   ICY.REQ
   CELLS.REQ
   WINDOWS.REQ

Version


   -Icy Version 1.0.1, 12-SEP-2006, EDW (JPL)

      Correct Required Reading citation CELL.REQ to CELLS.REQ.

   -Icy Version 1.0.0, 08-AUG-2004, EDW (JPL)

Index_Entries

 
   included in a d.p. window 
 



Wed Apr  5 17:58:05 2017