Index Page
cspice_wnfild
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_WNFILD fills small gaps between adjacent intervals
   of a double precision window. 
   
   For important details concerning this module's function, please refer to
   the CSPICE routine wnfild_c.

I/O

   
   Given:

      small    the scalar double precision limiting measure of the 
               small intervals to fill. Adjacent intervals separated 
               by gaps of measure less than or equal to 'small' are 
               merged.

      window   a scalar, double precision window containing zero
               or more intervals. 'window' must be created as a window 
               structure via a cspice_celld call.

   the call:

      cspice_wnfild, small, window

   returns:

      window   on output, is the original window, after adjacent 
               intervals separated by 'small' gaps have been merged.

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 four intervals.
      ;;
      darray = [ [ 1.d, 3.0], [ 7.0, 11.0], [23.0, 27.0], [29.d, 29.d] ]

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

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

      endfor

      ;;
      ;; Fill the gaps:
      ;;
      cspice_wnfild, 3.d0, win1

      ;;
      ;; Calculate the number of intervals in the
      ;; return window 'win1'.
      ;;
      no_intervals = cspice_wncard(win1)

      ;;
      ;; Output the intervals.
      ;;
      for i= 0, (no_intervals -1 ) do begin

         cspice_wnfetd, win1, i, left, right
         print, left, right

      endfor

   IDL outputs:

      1.0000000       3.0000000
      7.0000000       11.000000
      23.000000       29.000000

      The call combined adjacent intervals separated by a
      gap of less than or equal to 'small'. In this case the 
      intervals:

      [ 23, 27 ]  [ 29, 29 ] 
      
      combine to:
      
      [23, 29]

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.2, 26-NOV-2007, EDW (JPL)

      Implemented use of cspice_wncard function to return 
      window cardinality.

   -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

 
   fill small gaps in a d.p. window 
 



Wed Apr  5 17:58:05 2017