MER-B 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 MER GDS setup area:

   %source /mer/gds/setup/naif/aliases.mer1_x

      or directly from the OSS branch for that activity:

   %source /oss/merb/?/?/surface/strategic/ref/naif/misc/chronos/aliases.mer1_?


Command-line short-cuts for MER-B for primary time systems/types
----------------------------------------------------------------

FR\TO |    lstb          ltst        scet         ert          sclk          sclkd
-------------------------------------------------------------------------------------
lstb  | ------------ lstb2ltst.b  lstb2scet.b  lstb2ert.b   lstb2sclk.b  lstb2sclkd.b
ltst  | ltst2lstb.b  -----------  ltst2scet.b  ltst2ert.b   ltst2sclk.b  ltst2sclkd.b
scet  | scet2lstb.b  scet2ltst.b  -----------  scet2ert.b   scet2sclk.b  scet2sclkd.b
ert   | ert2lstb.b   ert2ltst.b   ert2scet.b   -----------  ert2sclk.b   ert2sclkd.b
sclk  | sclk2lstb.b  sclk2ltst.b  sclk2scet.b  sclk2ert.b   -----------  sclk2sclkd.b
sclkd | sclkd2lstb.b sclkd2ltst.b sclkd2scet.b sclkd2ert.b  sclkd2sclk.b ------------

where the time systems/types are:

   lstb  -- MER-B Hybrid Local Solar Time
   ltst  -- MER-B Local True Solar Time
   scet  -- UTC Spacecraft Event Time
   ert   -- UTC Earth Receive Time
   sclk  -- MER-B on-board clock, byte-based format
   sclkd -- MER-B on-board clock, decimal format

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


Command-line short-cuts for MER-B for auxiliary time systems/types
------------------------------------------------------------------

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

   scet2et.b/et2scet.b   -- between UTC SCET and Ephemeris Time

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

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

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

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

   scet2pst.b/scet2pdt.b -- UTC SCET to PDT and PST

   scet2pstert.b         -- UTC SCET to PST/ERT

   scet2pdtert.b         -- UTC SCET to PDT/ERT

   chronos.kernels.b     -- display all kernels used by CHRONOS

   chronos.sclk.b        -- 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

   Hybrid Local Solar Time (LSTB) and 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
      -- seconds, or seconds and minutes may be omitted
      -- "SOL" marker can upper or lower case but not mixed case

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

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

      -  must be provided in SSSSSSSSS.DDD.. format where SSSSSSSSS are
         integer seconds and DDD... are decimal fraction
      -- also may be prefixed with partition number
         
   On-board sclk, hexadecimal format (HEX):      

      -- HEX SCLK must be provided in XXXXXXXX.YY or XXXXXXXX:YY format 
         where YYYYYYYY are integer seconds (first four bytes of
         5-byte TLM SCLK) and YY are fractional second (last byte
         of 5-byte TLM SCLK); for example "07A6AB9F:81"
      -- 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"