Index Page
cspice_wnvald
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_WNVALD forms a valid double precision window from the contents
   of an 2Mx1 array.

I/O


   Given:

      window_i   2M endpoints of (possibly unordered and non-disjoint)
                 intervals.

                 [2m,1] = size(window_i); double = class(window_i)

   the call:

      window_f = cspice_wnvald(window_i)

   returns:

      window_f   SPICE window containing the ordered union of the intervals in
                 the input array 'window_i'.

                 [2n,1] = size(window_f); double = class(window_f)

                 The 'window_f' output may overwrite the input 'window_i'.

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.

      Define an array containing a set of unordered intervals:

      >> windata = [ [0;   0]; ...
                     [10; 12]; ...
                     [2;   7]; ...
                     [13; 15]; ...
                     [1;   5]; ...
                     [23; 29] ];

      Validate the array as a SPICE window:

      >> w1 = cspice_wnvald(windata)

      w1 =

           0
           0
           1
           7
          10
          12
          13
          15
          23
          29

   Representing the intervals:

     [0, 0] [1, 7] [10, 12] [13, 15] [23, 29]

Particulars


   On input, 'window' is a 2Mx1 array. During validation, the intervals
   are ordered, and overlapping intervals are merged. The size of the output
   window equals the number of endpoints remaining, and window is ready for
   use with any of the window routines.

Required Reading


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

   MICE.REQ
   WINDOWS.REQ

Version


   -Mice Version 1.1.1, 12-MAR-2012, EDW (JPL), SCK (JPL)

      Edited I/O section to conform to NAIF standard for Mice documentation.

   -Mice Version 1.1.0, 27-JUL-2009, EDW (JPL)

      'zzmice_cell' modified to include the cell type identifier 'double'.

   -Mice Version 1.0.0, 17-DEC-2008, EDW (JPL)

Index_Entries


   validate a d.p. window


Wed Apr  5 18:00:36 2017