Index Page
cspice_dafgs
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_DAFGS returns the summary of the current DAF array,
   i.e. the array found by the previous call to cspice_daffna
   or cspice_daffpa.

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

I/O


   Given:

      nd   a scalar integer defining the size of the return
           double precision array.

      ni   a scalar integer defining the size of the return
           integer array.

      For an SPK file, 'nd' always equals 2, 'ni' always equals 6. The precise
      contents of the vectors depend on the type of DAF but the
      final two elements of the 'ic' (integer) vector always contains the
      initial and final addresses respectively of the array.

   the call:

      cspice_dafgs, nd, ni, dc, ic

   returns:

      dc   the array of double precision components of the summary.

      ic   the array of integer components of the summary.

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.

   Use a simple function to output the double precision and integer
   values stored in an SPK's segments descriptors. This function opens
   a DAF for read, performs a forwards search for the DAF arrays,
   prints segments description for each array found, then closes the DAF.

   PRO daf_t, kernel

      ;;
      ;; Open a DAF file for read. Return a 'handle' referring to the file.
      ;;
      cspice_dafopr, kernel, handle

      ;;
      ;; Define the summary parameters appropriate
      ;; for an SPK file.
      ;;
      ND = 2L
      NI = 6L

      ;;
      ;; Begin a forward search on the file.
      ;;
      cspice_dafbfs, handle

      ;;
      ;; Search until a DAF array is found.
      ;;
      cspice_daffna, found

      ;;
      ;; Loop while the search finds subsequent DAF arrays.
      ;;
      while found do begin

         cspice_dafgs, ND, NI, dc, ic

         print, 'Doubles:  ', dc

         print, 'Integers: ', ic
         print, ' '


         ;;
         ;; Check for another segment.
         ;;
         cspice_daffna, found

      endwhile

      ;;
      ;; Safely close the DAF file.
      ;;
      cspice_dafcls, handle

   END

   IDL outputs:

      IDL> daf_t, 'de421.bsp'

      Doubles:    -3.1691952e+09   1.6968528e+09
      Integers:        1       0       1       2     641  310404

      Doubles:    -3.1691952e+09   1.6968528e+09
      Integers:        2       0       1       2  310405  423048

      Doubles:    -3.1691952e+09   1.6968528e+09
      Integers:        3       0       1       2  423049  567372

      Doubles:    -3.1691952e+09   1.6968528e+09
      Integers:        4       0       1       2  567373  628976

      Doubles:    -3.1691952e+09   1.6968528e+09
      Integers:        5       0       1       2  628977  674740

      Doubles:    -3.1691952e+09   1.6968528e+09
      Integers:        6       0       1       2  674741  715224

      Doubles:    -3.1691952e+09   1.6968528e+09
      Integers:        7       0       1       2  715225  750428

      Doubles:    -3.1691952e+09   1.6968528e+09
      Integers:        8       0       1       2  750429  785632

      Doubles:    -3.1691952e+09   1.6968528e+09
      Integers:        9       0       1       2  785633  820836

      Doubles:    -3.1691952e+09   1.6968528e+09
      Integers:       10       0       1       2  820837  944040

      Doubles:    -3.1691952e+09   1.6968528e+09
      Integers:      301       3       1       2  944041 1521324

      Doubles:    -3.1691952e+09   1.6968528e+09
      Integers:      399       3       1       2 1521325 2098608

      Doubles:    -3.1691952e+09   1.6968528e+09
      Integers:      199       1       1       2 2098609 2098620

      Doubles:    -3.1691952e+09   1.6968528e+09
      Integers:      299       2       1       2 2098621 2098632

      Doubles:    -3.1691952e+09   1.6968528e+09
      Integers:      499       4       1       2 2098633 2098644

   Note, the specific contents of 'ic' and 'dc' depend on the
   type of DAF.

   Note, the final entries in the integer array contain the segment
   start/end indexes. The output indicates the search proceeded
   from the start of the file (low value index) towards the end
   (high value index).

Particulars


   A single call to cspice_dafgs equates to the C calls:

      dafgs_c( sum );
      dafus_c( sum, nd, ni, dc, ic );

   without use of the 'sum' variable.

Required Reading


   ICY.REQ
   DAF.REQ

Version


   -Icy Version 1.0.1, 11-NOV-2013, EDW (JPL)

      Edits and clean up to header text.

   -Icy Version 1.0.0, 16-JUN-2003, EDW (JPL)

Index_Entries


   get DAF summary




Wed Apr  5 17:57:59 2017