
General information about SPICE DS-kernels
==========================================

   The purpose of the DS-kernel -- which stands for Digital Shape
   Kernel -- is to allow various digital shape representations, such as
   triangular plate models or digital elevation models, to be combined
   under a common file format and accessed by a common set of
   subroutines.

   Starting with the SPICE Toolkit version N0066, DSKs can be accessed
   by subroutines that are part of the SPICE library, the major
   component of the SPICE Toolkit. For earlier Toolkits, before N0066,
   DSKs can be accessed by subroutines from a special library called
   DSKLIB. These subroutines can be integrated into user application
   programs. For information on the SPICE Toolkit and/or how to obtain
   it, please consult SPICE_INST.CAT and SOFT.CAT.

   To use DS-kernels, Leapseconds (LSK), a Frame Definitions Kernel
   (FK), Planetary Constants Kernel (PcK), and possibly even C-Kernel
   (CK) files may also be required.

   Refer to the DSK.REQ document provided with the Toolkit to get more
   information on how to access DS-kernel data.


ROSETTA DSK Files
=================

   This file describes the contents of the DATA/DSK directory of the
   ROSETTA SPICE data set.

   The contents of any DSK file may be easily determined using the
   'dskbrief' utility program, Example:

      % dskbrief <dsk_file_name>

   Descriptive information about how/why/when an DSK file was created
   is usually available in the 'comment area' of the file. This may be
   viewed using the 'commnt' utility program available in all copies of
   the SPICE Toolkit. Use the '-r' option to read the comments.
   Example:

      % commnt -r <dsk_file_name>

   All binary DSK files (*.BDS) contained in this directory are
   little-endian (LTL-IEEE) binary files.


ROSETTA DSK-Kernels Naming Scheme
=================================

   The DSK-kernels provided in this data set are named according to
   this naming scheme:

      PPP_BB_RRRR_IMETPRO_N_VV.BDS

   where:

      PPP     -  project prefix: ROS

      BB      -  body: CG for 67P/C-G, LU for Lutetia, or ST for Steins

      RRRR    -  number of plates: Knnn (for nnn thousand plates) or
                 Mnnn (for mmm million plates)

      IMETPRO -  camera-method-producer combined into a single
                 7-character token:

                   I   -  camera:

                          O for OSIRIS
                          N for NAVCAM
                          M for multiple

                   MET -  method:

                          SPC for StereoPhotoClinometry
                          MSD for Multi-Resolution StereoPhotoClinometry
                          SPG for StereoPhotoGranulometry

                   PRO -  producer:

                          ESA for European Space Agency/ESOC
                          LAM for Laboratoire d'Astrophysique de Marseille
                          LPS for Laboratoire d'Astrophysique de Marseille
                                  + Planetary Science Institute
                          DLR for Deutsches Zentrum fur Luft- und
                                  Raumfahrt e.V.

      N      -  surface naming: U for unnamed (surface ID = body ID, for
                use with Toolkits N0065 or earlier) or N for named
                (surface IDs are set to distinct numbers that are mapped
                to surface names using keywords provided in the project
                FK v25 or later)

      VV     -  version: V1, V2, V3 ....

      BDS    -  extension: .BDS


ROSETTA DSK-Kernels Contained in this Data Set
==============================================

   The following DSK-kernels are provided in this data set:

   Comet 67P/C-G DSKs, for use with Toolkit N0066 or later:

      ROS_CG_K006_OMSDLAM_N_V1.BDS
      ROS_CG_K012_OMSDLAM_N_V1.BDS
      ROS_CG_K024_OMSDLAM_N_V1.BDS
      ROS_CG_K048_OMSDLAM_N_V1.BDS
      ROS_CG_K098_OMSDLAM_N_V1.BDS
      ROS_CG_K191_OMSDLAM_N_V1.BDS
      ROS_CG_K391_OMSDLAM_N_V1.BDS
      ROS_CG_K760_OMSDLAM_N_V1.BDS
      ROS_CG_M001_OMSDLAM_N_V1.BDS  Contain 67P/C-G shape data based on
                                    OSIRIS images produced by LAM using
                                    MSPCD method with plate numbers
                                    from 6K to 1M, for use with
                                    Toolkits N0066 or later.

      ROS_CG_K006_OSPCLPS_N_V1.BDS
      ROS_CG_K006_OSPCLPS_N_V2.BDS
      ROS_CG_K012_OSPCLPS_N_V1.BDS
      ROS_CG_K012_OSPCLPS_N_V2.BDS
      ROS_CG_K024_OSPCLPS_N_V1.BDS
      ROS_CG_K024_OSPCLPS_N_V2.BDS
      ROS_CG_K050_OSPCLPS_N_V1.BDS
      ROS_CG_K050_OSPCLPS_N_V2.BDS
      ROS_CG_K096_OSPCLPS_N_V1.BDS
      ROS_CG_K097_OSPCLPS_N_V1.BDS
      ROS_CG_K195_OSPCLPS_N_V1.BDS
      ROS_CG_K199_OSPCLPS_N_V1.BDS
      ROS_CG_K384_OSPCLPS_N_V1.BDS
      ROS_CG_K399_OSPCLPS_N_V1.BDS
      ROS_CG_K786_OSPCLPS_N_V1.BDS
      ROS_CG_K788_OSPCLPS_N_V1.BDS
      ROS_CG_M001_OSPCLPS_N_V1.BDS
      ROS_CG_M003_OSPCLPS_N_V1.BDS  Contain 67P/C-G shape data based on
                                    OSIRIS images produced by LAM-PSI
                                    using SPC method with plate numbers
                                    from 6K to 786K, for use with
                                    Toolkits N0066 or later.

      ROS_CG_K104_NSPCESA_N_V1.BDS
      ROS_CG_K250_NSPCESA_N_V1.BDS
      ROS_CG_M002_NSPCESA_N_V1.BDS
      ROS_CG_M004_NSPCESA_N_V1.BDS  Contain 67P/C-G shape data based on
                                    NAVCAM images produced by ESA using
                                    SPC method with plate numbers from 
                                    104K to 4M, for use with Toolkits 
                                    N0066 or later.

      ROS_CG_K050_OSPGDLR_N_V1.BDS
      ROS_CG_K100_OSPGDLR_N_V1.BDS
      ROS_CG_K200_OSPGDLR_N_V1.BDS
      ROS_CG_M001_OSPGDLR_N_V1.BDS 
      ROS_CG_M004_OSPGDLR_N_V1.BDS  OSIRIS images produced by DLR using 
                                    the SPG method with plate numbers 
                                    from 50K to 4M, for use with
                                    Toolkits N0066 or later.

   Comet 67P/C-G DSKs, for use with Toolkit N0065 or earlier:

      ROS_CG_K006_OMSDLAM_U_V1.BDS
      ROS_CG_K012_OMSDLAM_U_V1.BDS
      ROS_CG_K024_OMSDLAM_U_V1.BDS
      ROS_CG_K048_OMSDLAM_U_V1.BDS
      ROS_CG_K098_OMSDLAM_U_V1.BDS
      ROS_CG_K191_OMSDLAM_U_V1.BDS
      ROS_CG_K391_OMSDLAM_U_V1.BDS
      ROS_CG_K760_OMSDLAM_U_V1.BDS
      ROS_CG_M001_OMSDLAM_U_V1.BDS  Contains 67P/C-G shape data based
                                    on OSIRIS images produced by LAM
                                    using MSPCD method with plate
                                    numbers from 6K to 1M, for use with
                                    Toolkits N0065 or earlier.

      ROS_CG_K006_OSPCLPS_U_V1.BDS
      ROS_CG_K006_OSPCLPS_U_V2.BDS
      ROS_CG_K012_OSPCLPS_U_V1.BDS
      ROS_CG_K012_OSPCLPS_U_V2.BDS
      ROS_CG_K024_OSPCLPS_U_V1.BDS
      ROS_CG_K024_OSPCLPS_U_V2.BDS
      ROS_CG_K050_OSPCLPS_U_V1.BDS
      ROS_CG_K050_OSPCLPS_U_V2.BDS
      ROS_CG_K096_OSPCLPS_U_V1.BDS
      ROS_CG_K097_OSPCLPS_U_V1.BDS
      ROS_CG_K195_OSPCLPS_U_V1.BDS
      ROS_CG_K199_OSPCLPS_U_V1.BDS
      ROS_CG_K384_OSPCLPS_U_V1.BDS
      ROS_CG_K399_OSPCLPS_U_V1.BDS
      ROS_CG_K786_OSPCLPS_U_V1.BDS
      ROS_CG_K788_OSPCLPS_U_V1.BDS
      ROS_CG_M001_OSPCLPS_U_V1.BDS
      ROS_CG_M003_OSPCLPS_U_V1.BDS  Contains 67P/C-G shape data based
                                    on OSIRIS images produced by
                                    LAM-PSI using SPC method with plate
                                    numbers from 6K to 3M, for use
                                    with Toolkits N0065 or earlier.

      ROS_CG_K104_NSPCESA_U_V1.BDS
      ROS_CG_K250_NSPCESA_U_V1.BDS
      ROS_CG_M002_NSPCESA_U_V1.BDS
      ROS_CG_M004_NSPCESA_U_V1.BDS  Contains 67P/C-G shape data based
                                    on NAVCAM images produced by ESA
                                    using SPC method with plate numbers
                                    from 104K to 4M plates, for use 
                                    with Toolkits N0065 or earlier.

      ROS_CG_K100_OSPGDLR_U_V1.BDS 
      ROS_CG_K050_OSPGDLR_U_V1.BDS
      ROS_CG_K200_OSPGDLR_U_V1.BDS
      ROS_CG_M001_OSPGDLR_U_V1.BDS 
      ROS_CG_M004_OSPGDLR_U_V1.BDS  Contain 67P/C-G shape data based on
                                    OSIRIS images produced by DLR using 
                                    the SPG method with plate numbers 
                                    from 50K to 4M, for use with
                                    Toolkits N0065 or earlier.

   Asteroid 21 Lutetia DSKs, for use with Toolkit N0066 or later:

      ROS_LU_K003_OSPCLAM_N_V1.BDS
      ROS_LU_K006_OSPCLAM_N_V1.BDS
      ROS_LU_K012_OSPCLAM_N_V1.BDS
      ROS_LU_K025_OSPCLAM_N_V1.BDS
      ROS_LU_K048_OSPCLAM_N_V1.BDS
      ROS_LU_K098_OSPCLAM_N_V1.BDS
      ROS_LU_K190_OSPCLAM_N_V1.BDS
      ROS_LU_K240_OSPCLAM_N_V1.BDS
      ROS_LU_K380_OSPCLAM_N_V1.BDS
      ROS_LU_K780_OSPCLAM_N_V1.BDS
      ROS_LU_M002_OSPCLAM_N_V1.BDS
      ROS_LU_M003_OSPCLAM_N_V1.BDS  Contain Lutetia shape data based on
                                    OSIRIS images produced by LAM using
                                    SPC method with plate numbers from
                                    3K to 3M, for use with Toolkits
                                    N0066 or later.

   Asteroid 21 Lutetia DSKs, for use with Toolkit N0065 or earlier:

      ROS_LU_K003_OSPCLAM_U_V1.BDS
      ROS_LU_K006_OSPCLAM_U_V1.BDS
      ROS_LU_K012_OSPCLAM_U_V1.BDS
      ROS_LU_K025_OSPCLAM_U_V1.BDS
      ROS_LU_K048_OSPCLAM_U_V1.BDS
      ROS_LU_K098_OSPCLAM_U_V1.BDS
      ROS_LU_K190_OSPCLAM_U_V1.BDS
      ROS_LU_K240_OSPCLAM_U_V1.BDS
      ROS_LU_K380_OSPCLAM_U_V1.BDS
      ROS_LU_K780_OSPCLAM_U_V1.BDS
      ROS_LU_M002_OSPCLAM_U_V1.BDS
      ROS_LU_M003_OSPCLAM_U_V1.BDS  Contain Lutetia shape data based on
                                    OSIRIS images produced by LAM using
                                    SPC method with plate numbers from
                                    3K to 3M, for use with Toolkits
                                    N0065 or earlier.


   Asteroid 2867 Steins DSKs, for use with Toolkit N0066 or later:

      ROS_ST_K020_OSPCLAM_N_V1.BDS  Contains Steins shape data based on
                                    OSIRIS images produced by LAM using
                                    SPC method with 20K plates, for use
                                    with Toolkits N0066 or later.


   Asteroid 2867 Steins DSKs, for use with Toolkit N0065 or earlier:

      ROS_ST_K020_OSPCLAM_U_V1.BDS  Contains Steins shape data based on
                                    OSIRIS images produced by LAM using
                                    SPC method with 20K plates, for use
                                    with Toolkits N0065 or earlier.


   Solar System Bodies DSKs, for use with Toolkit N0066 or later:

      PHOBOS_K275_DLR_V02.BDS       Contains Phobos shape data based on
                                    Mars-Express HRSC images.

      PHOBOS_M003_GAS_V01.BDS       Contains Phobos shape data by Robert
                                    Gaskell based on Viking Orbiter 1 VIS-A
                                    and VIS-B camera images.

      DEIMOS_K005_THO_V01.BDS       Contains Deimos shape data by Peter
                                    Thomas based on Viking Orbiter images.

      TEMPEL1_9P_K032_THO_V01.BDS   Contains 9P/Tempel 1 comet shape data by
                                    Peter Thomas based on Deep Impact and
                                    Stardust spacecraft data.


Kernel File Details
===================

   The most detailed description of the data in each DSK file is
   provided in metadata included inside the comment area of the file.
   This information can be viewed using utility programs 'commnt'
   included in the SPICE Toolkit.

   At least a basic knowledge of the SPICE system is needed in order to
   use these kernels. The SPICE Toolkit provides versions in Fortran
   (SPICELIB), C (CSPICE), IDL (icy), Matlab (Mice), and Java
   (JNISpice) and the user can choose any one that suits him/her.

   Starting with the Toolkit version N0066, the SPICE routine FURNSH
   can be used to load a DS-kernel file into a SPICE-based application
   to make kernel data usable with SPICE APIs. In earlier versions of
   the Toolkit, prior to N0066, the low level DASOPR routine can be
   used to open a DSK file for read access.

