wninsd_c |

Table of contents## Procedurewninsd_c ( Insert an interval into a DP window ) void wninsd_c ( SpiceDouble left, SpiceDouble right, SpiceCell * window ) ## AbstractInsert an interval into a double precision window. ## Required_ReadingWINDOWS ## KeywordsWINDOWS ## Brief_I/OVARIABLE I/O DESCRIPTION -------- --- -------------------------------------------------- left, right I Left, right endpoints of new interval. window I-O Input, output window. ## Detailed_Inputleft, right are the left and right endpoints of the interval to be inserted. window on input, is a SPICE window containing zero or more intervals. `window' must be declared as a double precision SpiceCell. CSPICE provides the following macro, which declares and initializes the cell SPICEDOUBLE_CELL ( window, WINDOWSZ ); where WINDOWSZ is the maximum capacity of `window'. ## Detailed_Outputwindow on output, is the original window following the insertion of the interval from `left' to `right'. ## ParametersNone. ## Exceptions1) If `left' is greater than `right', the error SPICE(BADENDPOINTS) is signaled by a routine in the call tree of this routine. 2) If the insertion of the interval causes an excess of elements, the error SPICE(WINDOWEXCESS) is signaled by a routine in the call tree of this routine. 3) The cardinality of the input `window' must be even. Left endpoints of stored intervals must be strictly greater than preceding right endpoints. Right endpoints must be greater than or equal to corresponding left endpoints. Invalid window data are not diagnosed by this routine and may lead to unpredictable results. 4) If the `window' cell argument has a type other than SpiceDouble, the error SPICE(TYPEMISMATCH) is signaled. ## FilesNone. ## ParticularsThis routine inserts the interval from `left' to `right' into the input window. If the new interval overlaps any of the intervals in the window, the intervals are merged. Thus, the cardinality of the input window can actually decrease as the result of an insertion. However, because inserting an interval that is disjoint from the other intervals in the window can increase the cardinality of the window, the routine signals an error. ## ExamplesThe numerical results shown for this example may differ across platforms. The results depend on the SPICE kernels used as input, the compiler and supporting libraries, and the machine specific arithmetic implementation. 1) The following code example demonstrates how to insert an interval into an existing double precision SPICE window, and how to loop over all its intervals to extract their left and right points. Example code begins here. /. Program wninsd_ex1 ./ #include <stdio.h> #include "SpiceUsr.h" int main() { /. Local parameters. ./ #define WNSIZE 10 /. Local variables. ./ SpiceDouble left; SpiceDouble right; SPICEDOUBLE_CELL ( window, WNSIZE ); SpiceInt i; /. Validate the window with size WNSIZE and zero elements. ./ wnvald_c ( WNSIZE, 0, &window ); /. Insert the intervals [ 1, 3 ] [ 7, 11 ] [ 23, 27 ] into `window'. ./ ## RestrictionsNone. ## Literature_ReferencesNone. ## Author_and_InstitutionN.J. Bachman (JPL) J. Diaz del Rio (ODC Space) K.R. Gehringer (JPL) H.A. Neilan (JPL) W.L. Taber (JPL) I.M. Underwood (JPL) ## Version-CSPICE Version 1.0.1, 25-AUG-2021 (JDR) Edited the header to comply to NAIF standard. Added complete code example, problem statement and solution. Extended description of argument "window" in -Detailed_Input to include type and preferred declaration method. Added entry #3 in -Exceptions section. Removed irrelevant information related to other unary window routines from -Particulars section. -CSPICE Version 1.0.0, 29-JUL-2002 (NJB) (KRG) (HAN) (WLT) (IMU) ## Index_Entriesinsert an interval into a d.p. window |

Fri Dec 31 18:41:15 2021