Index Page
cspice_dafbbs
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_DAFBBS initiates a backwards search for arrays in a DAF
   file.

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

I/O


   Given:

      handle   the scalar integer file handle referring to a DAF.

   the call:

      cspice_dafbbs, handle

   starts a backwards search, i.e. end of file to start of file,
   on a DAF.

   returns:

      None.

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 backwards search for the DAF arrays,
   prints the segment description for each array found, then closes the DAF.

   PRO dafb_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_dafbbs, handle

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

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

         cspice_dafgs, ND, NI, dc, ic

         print, 'Doubles:  ', dc

         print, FORMAT='(A,6I8)', 'Integers: ', ic
         print, ' '


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

      endwhile

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

   END

   IDL outputs:

      IDL> dafb_t, 'de421.bsp'

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

   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 end of the file (high value index) towards the beginning
   (low value index).

Particulars


   None.

Required Reading


   ICY.REQ
   DAF.REQ

Version


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

      Minor edits and clean up to header text.
      
   -Icy Version 1.0.1, 08-AUG-2008, EDW (JPL)

      Minor edits to header text.

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

Index_Entries


   begin DAF backward search




Wed Apr  5 17:57:59 2017