Procedure

     SCID2N  ( SCLK ID code to name )

     ENTRY SCID2N ( CLKID, CLKNAM, FOUND )

Abstract

     Convert a NAIF integer code for a spacecraft clock to an SCLK name
     string.

Required_Reading

     SCLK

Keywords

     CONVERSION
     PARSING
     SCLK
     TIME
     UTILITY

Declarations

    IMPLICIT NONE

    INTEGER               CLKID
    CHARACTER*(*)         CLKNAM
    LOGICAL               FOUND

Brief_I/O

     VARIABLE  I/O  DESCRIPTION
     --------  ---  --------------------------------------------------
     CLKID      I   NAIF integer code of spacecraft clock.
     CLKNAM     O   String giving spacecraft clock name.
     FOUND      O   Flag indicating whether item was found.

Detailed_Input

     CLKID    is the NAIF integer code of a spacecraft clock of
              interest.

Detailed_Output

     CLKNAM   is a short, human-readable string identifying
              the specified spacecraft clock. The returned
              string has the form

                 <spacecraft name or acronym> SCLK

              where the spacecraft name is the same string
              returned by BODC2N when CLKID is supplied as the
              input code.

              CLKNAM is defined only if the output flag FOUND is
              returned .TRUE.

     FOUND    is a logical flag indicating whether the input
              code specified a clock known to this routine.

Parameters

     None.

Exceptions

     Error free.

     1)  If the input code is not recognized, FOUND is set to .FALSE.
         CLKNAM is not modified.

     2)  If the input code is recognized but does not refer to a
         spacecraft, no error is signaled. For example, the code
         5 maps to the string 'JUPITER BARYCENTER SCLK'.

Files

     None.

Particulars

     This routine converts a NAIF spacecraft clock code to a human-
     readable string. This function is useful for constructing
     messages.

Examples

     1)  Look up the spacecraft clock name for code -77.

            CALL SCID2N ( -77, CLKNAM, FOUND )

         The outputs will be

            CLKNAM  =  'GALILEO ORBITER SCLK'
            FOUND   =  .TRUE.

Restrictions

     None.

Literature_References

     None.

Author_and_Institution

     N.J. Bachman       (JPL)
     J. Diaz del Rio    (ODC Space)

Version

    SPICELIB Version 1.0.1, 12-AUG-2021 (JDR)

        Edited the header to comply with NAIF standard.

    SPICELIB Version 1.0.0, 25-FEB-2000 (NJB)

        Updated to use BODTRN for SCLK name/code mapping.

    SPICELIB Version 1.0.0, 17-NOV-1995 (NJB)