Документ взят из кэша поисковой машины. Адрес
оригинального документа
: http://www.stsci.edu/~sontag/spicedocs/cspice/dafus_c.html
Дата изменения: Sat Dec 17 06:08:43 2005 Дата индексирования: Sun Apr 10 23:24:23 2016 Кодировка: |
Unpack an array summary into its double precision and integer components.
DAF
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.
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.
dc are the double precision components of the summary. ic are the integer components of the summary.
None.
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).
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 ); }
None.
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.
None.
N.J. Bachman (JPL) I.M. Underwood (JPL)
NAIF Document 167.0, "Double Precision Array Files (DAF) Specification and User's Guide"
-CSPICE Version 1.0.0, 01-AUG-1999 (NJB), (IMU)
unpack daf summary