MSR SRL CHRONOS Aliases Cheat-sheet ========================================================================= BVS/NAIF, 02/20/23, for msr_srl_gz4a_*_v1 or later. 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 MSR SRL GDS setup area: %source /gds/naif/chronos/aliases.msr_srl_? (If you are using a local installation of CHRONOS Aliases, "source" the local "aliases.msr_srl_?" alias setup script instead.) Doing Time Conversions --------------------------------------------------------- 3a) Run a single-time conversion alias, for example lmst2scet Sol-00001M21:10:52.48011 scet2lmst 2016-10-07 12:15:23.000000 3b) Or, for a list of times provided in a text file with one time per line and no blank or other non-time lines, run a batch conversion alias, for example lmst2scet_batch input_lmst_times.txt output_scet_times.txt scet2lmst_batch input_scet_times.txt output_lmst_times.txt Single-time Aliases for MSR SRL for Primary Time Systems/Types ---------------------------------------------------------------- The single-time conversion aliases for "primary" time systems/types are shown in this table: 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 -- MSR SRL Local Mean Solar Time ltst -- MSR SRL Local True Solar Time scet -- UTC Spacecraft Event Time ert -- UTC Earth Receive Time sclk -- MSR SRL on-board clock, byte-based format sclkd -- MSR SRL on-board clock, decimal format lmst and ltst can be computed only for times after landing. Single-time Aliases for MSR SRL for Auxiliary Time Systems/Types ------------------------------------------------------------------ The single-time conversion aliases for "Auxiliary" time systems/types are: 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 Command-line Batch Conversion Batch ------------------------------------------------------------------ The batch conversion alias is provided for each of the single-time conversion aliases mentioned above and has the same name with an additional suffix "_batch". For example Single-time Batch Conversion ----------- ---------------- lmst2scet lmst2scet_batch scet2lmst scet2lmst_batch sclk2scet sclk2scet_batch ...and so on Kernel Information Short-cuts ------------------------------------------------------------------ These aliases display information about kernels used by other aliases: 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; 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" End of cheat-sheet.