MSL CHRONOS Aliases Cheat-sheet
=========================================================================

Making the time conversion short-cuts (aliases) available
---------------------------------------------------------

   1) start/use "tcsh" as your shell (note that the aliases will not work
      with "csh"!)

   2) "source" CHRONOS aliases file for the activity of interest from 
      the MSL GDS setup area:

         %source /ods/?/strategic/naif/misc/chronos/aliases.msl_?

      (If you are using a local installation of CHRONOS Aliases, 
      "source" the local "aliases.msl_?" alias setup script instead.)


Command-line short-cuts for MSL for primary time systems/types
----------------------------------------------------------------

FR\TO |   lmst        ltst      scet       ert        sclk       sclkd
-------------------------------------------------------------------------
lmst  | ---------- lmst2ltst  lmst2scet  lmst2ert   lmst2sclk  lmst2sclkd
ltst  | ltst2lmst  ---------  ltst2scet  ltst2ert   ltst2sclk  ltst2sclkd
scet  | scet2lmst  scet2ltst  ---------  scet2ert   scet2sclk  scet2sclkd
ert   | ert2lmst   ert2ltst   ert2scet   ---------  ert2sclk   ert2sclkd
sclk  | sclk2lmst  sclk2ltst  sclk2scet  sclk2ert   ---------  sclk2sclkd
sclkd | sclkd2lmst sclkd2ltst sclkd2scet sclkd2ert  sclkd2sclk ----------

where the time systems/types are:

   lmst  -- MSL Local Mean Solar Time
   ltst  -- MSL Local True Solar Time
   scet  -- UTC Spacecraft Event Time
   ert   -- UTC Earth Receive Time
   sclk  -- MSL on-board clock, byte-based format
   sclkd -- MSL on-board clock, decimal format

lmst and ltst can be computed only for times after landing.


Command-line short-cuts for MSL for auxiliary time systems/types
------------------------------------------------------------------

   scet2ett/ett2scet -- between UTC SCET and UTC Earth Transmit Time

   scet2et/et2scet   -- between UTC SCET and Ephemeris Time

   scet2doy/doy2scet -- between UTC SCET in date and DOY format

   sclk2hex/hex2sclk -- between SCLK in decimal and hex format

   scet2lsun         -- L-sub-S for given UTC SCET

   scet2lt           -- one-way-light time for given UTC SCET

   scet2pst/scet2pdt -- UTC SCET to PDT and PST

   scet2pstert       -- UTC SCET to PST/ERT

   scet2pdtert       -- UTC SCET to PDT/ERT

   chronos.kernels   -- display all kernels used by CHRONOS

   chronos.sclk      -- displays original SCLK name


Notes on the input/output time formats
--------------------------------------

   SCET and ERT:

      -- on the input SCET and ERT maybe be provided in a wide variety formats
      -- on the output the format is always YYYY-MM-DD HR:MN:SC.######
      -- only a few input formats are not supported, among which  
         is a common DOY format with "/" separating YYYY and DOY;
         for example this SCET "2004/006-12:00" will not work

   Local True Solar Time (LTST): 

      -- can be computed only for times after landing
      -- must be provided in "SOL DDD HR:MN:SC" format
      -- seconds must not have fractional part
      -- consequent fields on the right (seconds, seconds and minutes, etc)
         may be omitted
      -- "SOL" marker can be upper or lower case but not mixed case

   Local Mean Solar Time (LMST): 

      -- can be computed only for times after landing
      -- must be provided in "Sol-nnnnnMhh:mm:ss.sssss" format
      -- consequent fields on the right (decimal seconds, decimal seconds and 
         seconds, etc) may be omitted
      -- "Sol" marker and "m" can be upper, lower, or mixed case

   On-board clock, two-byte-based format (SCLK):

      -- must be provided in SSSSSSSSS-FFFFF or SSSSSSSSS:FFFFF format 
         where SSSSSSSSS are integer seconds (first four bytes of
         6-byte TLM SCLK) and FFFFF are fractional seconds (last two bytes
         of 6-byte TLM SCLK) (Note that FFFFF is NOT a decimal fraction);
         for example "128363423-12956"
      -- may be prefixed with "N/" indicating SPICE SCLK partition
         number; since only one partition is expected for MSL,
         this prefix should always be "1/" and is normally omitted
         
   On-board clock, decimal format (SCLKD):

      -- must be provided in SSSSSSSSS.DDDDDD format where SSSSSSSSS are
         integer seconds and DDDDDD is decimal fraction (can be given
         with any number of decimal places)
      -- also may be prefixed with partition number
         
   On-board sclk, hexadecimal format (HEX):      

      -- HEX SCLK must be provided in XXXXXXXX-YYYY or XXXXXXXX:YYYY format 
         where YYYYYYYY are integer seconds (first four bytes of
         6-byte TLM SCLK) and YYYY are fractional seconds (last two bytes
         of 6-byte TLM SCLK); for example "07A6AB9F:81A0"
      -- may also be prefixed with partition number

   UTC SCET in DOY format:

      -- the date and time parts must be separated by double
         slash, "//", or "T"; for example "2004-012//12:00:00.000"
         or "2004-012T12:00:00.000", but not "2004-012 12:00"