INSIGHT CHRONOS Aliases Cheat-sheet ========================================================================= BVS/NAIF, 11/14/13, for aliases.insight_e9_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 INSIGHT GDS setup area: %source /gds/naif/chronos/aliases.insight_? (If you are using a local installation of CHRONOS Aliases, "source" the local "aliases.insight_?" 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 INSIGHT 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 -- INSIGHT Local Mean Solar Time ltst -- INSIGHT Local True Solar Time scet -- UTC Spacecraft Event Time ert -- UTC Earth Receive Time sclk -- INSIGHT on-board clock, byte-based format sclkd -- INSIGHT on-board clock, decimal format lmst and ltst can be computed only for times after landing. Single-time Aliases for INSIGHT 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.