dafus_c

Index Page dafus_c
A B C D E F G H I J K L M N O P Q R S T U V W X
Procedure Abstract Required_Reading Keywords Brief_I/O Detailed_Input | Detailed_Output Parameters Exceptions Files Particulars Examples | Restrictions Literature_References Author_and_Institution Version Index_Entries
#### Procedure
       void dafus_c ( ConstSpiceDouble   sum [],
                      SpiceInt           nd,
                      SpiceInt           ni,
                      SpiceDouble        dc  [],
                      SpiceInt           ic  []  )
#### Abstract
       Unpack an array summary into its double precision and integer
       components.
#### Required_Reading
       DAF
#### Keywords
       CONVERSION
       FILES
#### Brief_I/O
       Variable  I/O  Description
       --------  ---  --------------------------------------------------
       sum        I   Array summary.
       nd         I   Number of double precision components.
       ni         I   Number of integer components.
       dc         O   Double precision components.
       ic         O   Integer components.
#### Detailed_Input
       sum         is an array summary. This identifies the contents and
                   location of a single array within a DAF.

       nd          is the number of double precision components in
                   the summary.

       ni          is the number of integer components in the summary.
#### Detailed_Output
       dc          are the double precision components of the summary.

       ic          are the integer components of the summary.
#### Parameters
        None.
#### Exceptions
       Error free.

       1) If nd is zero or negative, no double precision components
          are returned.

       2) If ni is zero or negative, no integer components are returned.

       3) If the total size of the summary is greater than 125 double
          precision words, some components may not be returned.
#### Files
       None.
#### Particulars
       The components of array summaries are packed into double
       precision arrays for reasons outlined in [1]. Two routines,
       DAFPS (pack summary) and dafus_c (unpack summary) are provided
       for packing and unpacking summaries.

       The total size of the summary is

               (ni - 1)
          nd + -------- + 1
                   2

       double precision words (where nd, ni are nonnegative).
#### Examples
       In the following code fragment, dafopr_c is used to open a file,
       which is then searched for DAFs containing data for a particular
       object.  dafus_c is used to unpack the summaries so the applicability
       of the segments can be determined.

          #include "SpiceUsr.h"
               .
               .
               .
          dafopr_c ( fname, &handle );
          dafbfs_c ( handle );

          daffna_c ( &found );

          while ( found )
          {
             dafgs_c ( sum );
             dafus_c ( sum, ND, NI, dc, ic );

             if ( ic[0] == target_object )
             {
                .
                .
                .
             }

             daffna_c ( &found );
          }
#### Restrictions
       None.
#### Literature_References
       NAIF Document 167.0, "Double Precision Array Files (DAF)
       Specification and User's Guide"
#### Author_and_Institution
       N.J. Bachman    (JPL)
       I.M. Underwood  (JPL)
#### Version
       -CSPICE Version 1.0.0, 01-AUG-1999 (NJB), (IMU)
#### Index_Entries
       unpack daf summary
#### Link to routine dafus_c source file dafus_c.c

    Thu Apr 16 08:57:41 2009