KPL/SCLK

MSR_SRL SCLK File Implementing LMST at GZ4A_REQ_V1 Landing Site
===========================================================================

     This file is a SPICE spacecraft clock (SCLK) kernel implementing
     Local Mean Solar Time (LMST). This file contains information required
     to convert between Ephemeris Time (ET) and LMST at the MSR_SRL landing
     site GZ4A_REQ_V1 (Jezero Green Zone 4a, Required Landing Date, v1) 
     for the landing date/time 2030-11-11T22:29:01 using SPICE SCLK time
     conversion routines/tools.


Version
--------------------------------------------------------

     1.0.0 -- February 20, 2023 -- BVS/NAIF

         Initial Release.


References
--------------------------------------------------------

     1. SCLK Required Reading Document


Implementation Details
--------------------------------------------------------

     LMST for MSR_SRL at the landing site GZ4A_REQ_V1 and landing date/time
     2030-11-11T22:29:01 can be represented by a simple linear
     function.

     The starting point for this function is the ET corresponding to
     the midnight LMST of the SOL 0 -- 2030-11-11T05:58:08.1 UTC
     (or 973879157.283 ET seconds past J2000).

     This function "runs" at the constant rate of 1.02749125 ET
     seconds in 1 local Martian second, which is equal the SCLK rate of
     88775.24400000 ET seconds in 1 local Martian day that appears in
     the COEFFICIENTS keyword below.

     The ID for this clock is chosen to be 232900 to indicate that
     this is NOT an actual SCLK for the MSR_SRL on-board clock but a
     special SCLK file that enables LMST-ET time conversions using the
     APIs of the SCLK subsystem of SPICE.


LMST Format
--------------------------------------------------------

     The LMST string, the conversion for which is provided by this SCLK
     file, consists of four fields:

          DDDDD:HR:MN:SC:TMSEC

     where:

          DDDDD -- count of LMST (SOL) days (0..36525)
          HR    -- count of LMST hours (0..23)
          MN    -- count of LMST minutes (0..59)
          SC    -- count of LMST seconds (0..59)
          TMSEC -- count of LMST 10-microsecond ticks (0..99999)

Usage
--------------------------------------------------------

     In order to use the SPICELIB SCLK family routines to convert
     MSR_SRL LMST at the landing site GZ4A_REQ_V1 to ET and vice versa,
     this file must be loaded into the user's program by a call to the
     FURNSH routine

          CALL FURNSH( 'this_file_name' )            (FORTRAN)
          furnsh_c   ( "this_file_name" );           (C)
          cspice_furnsh, 'this_file_name'            (IDL)
          cspice_furnsh( 'this_file_name' )          (MATLAB)

     Once loaded, the routine SCE2S can be used to convert an ET time
     to an LMST string in the format DDDDD:HR:MN:SC:TMSEC:

          CALL SCE2S( -232900, ET, LMST )             (FORTRAN)
          sce2s_c   ( -232900, et, maxlen, lmst );    (C)
          cspice_sce2s, -232900, et, lmst             (IDL)
          lmst = cspice_sce2s( -232900, et );         (MATLAB)

     and the routine SCS2E can be used for backward conversion -- from
     LMST in DDDDD:HR:MN:SC:TMSEC format to ET:

          CALL SCS2E( -232900, LMST, ET )             (FORTRAN)
          scs2e_c   ( -232900, lmst, &et );           (C)
          cspice_scs2e, -232900, lmst, et             (IDL)
          et = cspice_scs2e( -232900, lmst )          (MATLAB)


Inquiries
--------------------------------------------------------

     If you have any questions regarding this file contact NAIF at JPL

           Charles H. Acton, Jr
           (818) 354-3869
           Chuck.Acton@jpl.nasa.gov

           Boris V. Semenov
           (818) 354-8136
           Boris.Semenov@jpl.nasa.gov


Kernel DATA
--------------------------------------------------------

     \begindata

         SCLK_KERNEL_ID              = ( @2023-02-20-05:47:17 )

         SCLK_DATA_TYPE_232900        = ( 1 )
         SCLK01_TIME_SYSTEM_232900    = ( 1 )
         SCLK01_N_FIELDS_232900       = ( 5 )
         SCLK01_MODULI_232900         = ( 36525 24 60 60 100000 )
         SCLK01_OFFSETS_232900        = ( 0     0  0  0  0  )
         SCLK01_OUTPUT_DELIM_232900   = ( 2 )

         SCLK_PARTITION_START_232900  = ( 0.00000000000000E+00 )

         SCLK_PARTITION_END_232900    = ( 3.15576000000000E+14 )

         SCLK01_COEFFICIENTS_232900   = (
             0.0000000000000E+00     973879157.283    88775.24400000
                                  )

     \begintext