Index Page
cspice_dskgd
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_DSKGD returns the DSK descriptor from a DSK segment
   identified by a DAS handle and DLA descriptor.

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

I/O


   Given:

      handle    the handle of a DSK file that is open for
                read access.

      dladsc    the DLA segment descriptor corresponding to
                a DSK segment.


   the call:

      cspice_dskgd, handle, dladsc, dskdsc

   returns:

      dskdsc    the DSK segment descriptor of the segment
                designated by the input handle and DLA descriptor.

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.

   Dump the DSK descriptor of the first segment of a DSK file.

      PRO dskgd_t1, dsk

         @IcyUser

         cspice_dasopr, dsk, handle

         ;;
         ;; Search for the first segment in the file; obtain
         ;; the segment's DLA descriptor.
         ;;
         cspice_dlabfs, handle, nxtdsc, found

         while ( found ) do begin

            dladsc = nxtdsc

            cspice_dskgd, handle, dladsc, dskdsc

            print, 'DSK descriptor contents:'

            print, '   ', long( dskdsc[SPICE_DSK_SRFIDX] )
            print, '   ', long( dskdsc[SPICE_DSK_CTRIDX] )
            print, '   ', long( dskdsc[SPICE_DSK_CLSIDX] )
            print, '   ', long( dskdsc[SPICE_DSK_TYPIDX] )
            print, '   ', long( dskdsc[SPICE_DSK_FRMIDX] )
            print, '   ', long( dskdsc[SPICE_DSK_SYSIDX] )

            for i = 0, SPICE_DSK_NSYPAR-1 do begin
               print, '   ', dskdsc[SPICE_DSK_PARIDX+i]
            endfor

            print, '   ',    dskdsc[SPICE_DSK_MN1IDX]
            print, '   ',    dskdsc[SPICE_DSK_MX1IDX]
            print, '   ',    dskdsc[SPICE_DSK_MN2IDX]
            print, '   ',    dskdsc[SPICE_DSK_MX2IDX]
            print, '   ',    dskdsc[SPICE_DSK_MN3IDX]
            print, '   ',    dskdsc[SPICE_DSK_MX3IDX]
            print, dskdsc[SPICE_DSK_BTMIDX]
            print, dskdsc[SPICE_DSK_ETMIDX]

            ;;
            ;; Fetch next DLA descriptor.
            ;;
            cspice_dlafns, handle, dladsc, nxtdsc, found

         endwhile

      END

   IDL outputs:

      IDL> dskgd_t1, 'phobos512.bds'
      DSK descriptor contents:
                  401
                  401
                    1
                    2
                10021
                    1
                0.0000000
                0.0000000
                0.0000000
                0.0000000
                0.0000000
                0.0000000
                0.0000000
                0.0000000
                0.0000000
                0.0000000
               -3.1415927
                3.1415927
               -1.5707963
                1.5707963
                8.0496322
                13.940940
        -1.5778800e+09
         1.5778801e+09

Particulars


   This is a convenience routine intended for use by low-level routines
   that read DSK segments. This routine may also be called by user
   applications that must access DSK files at the segment level.

Required Reading


   ICY.REQ
   DAS.REQ
   DSK.REQ

Version


   -Icy Version 1.0.0, 13-DEC-2016, ML (JPL), EDW (JPL)

Index_Entries


   return dsk segment_descriptor



Wed Apr  5 17:58:00 2017