Review notes on NHSP_1000 0002 (with checksum.tab dated 2014 Jul 14 17:03) Boris Semenov, NAIF/JPL, August 14, 2014 ==================================================================== Summary of proposed liens, details follow after this section: --------------------- General - strongly recommend to use scripts and follow the guidelines from the SPICE PDS3 Archiving Guide; --------------------- Data - all new CKs -- update CK comments to contain starting boiler-plate description like the one in CKs from release 0001 - all new CKs -- report back to the project overly long Type 2 interpolation intervals and incorrect Type 3 interpolation intervals (some spin-up/despin periods) to see if any corrections in the CK pipeline can be made - nh_soc_misc_v001.tf -- change to use correct asteroid ID or remove from the archive; if removed, drop it from MK - nh_ralph_v100.ti -- add to the archive a new version of this IK with complete FOV definition for NH_RALPH/-98200; use it in MK - nh_stars_kbo_centaur_ppinp.tpc -- update comments and add KERBEROS/904 and STYX/905 name/ID mappings - nh_extras.bsp -- add internal comments - pck00010.tpc -- add to the archive; use it in MK - plu043.bsp -- maybe add new Pluto ephemeris to the archive? if added, use it in MK - gap-filler CK -- maybe add a Sun-pointed, 5-RPM spin CK filling gaps in the archives CKs? if added, use it in MK - nh_v02.tm -- update comments, change kernel order, remove some files, replace some files with new versions --------------------- Other - temporary files -- remove from the archive; they caused numerous checksum verification errors; - mission.cat -- improve formatting - ref.cat -- update LABEL_REVISION_NOTE - spiceds.cat -- update STOP_TIME, remove 0002 sections - most *info.txt files -- fix minor errors and typos - index.tab/lbl -- re-generate using SPICE Archiving Guide scripts; or, if done by other scripts, change some column definitions in the label - dsindex.tab/lbl -- make and add to the archive above the volume root directory level - mkinfo.txt and voldesc.cat -- revert to versions from release 0001 - data labels -- fix DESCRIPTION in a few labels - errata.txt -- * add a note about long Type 2 interpolations * add a note about incorrect Type 3 interpolations (some spin-up/despin periods) * add a note(s) about MISSION_PHASE_NAME * add a note that changed mission phase names in mission.cat invalidated values included in the release 0001 labels * if new RALPH IK is added, remove the note about RALPH FOV ==================================================================== Details on new and updated files: --------------------------------- index/checksum.lbl index/checksum.tab -- initial checksum errors: total 66 errors, all for temporary files starting with "._"; see full report at the end of these notes. -- with "._" files removed checksum check shows no discrepancies --------------------------------- aareadme.htm -- is OK --------------------------------- aareadme.txt -- is OK --------------------------------- catalog/mission.cat -- bad formatting in new paragraph in "Mission Phases" section -- changing "JUPITER" to "JUPITER ENCOUNTER" invalidated any existing labels that used just JUPITER as the mission phase name (e.g. merged_nhpc_2007_v006.lbl) --------------------------------- catalog/ref.cat -- was changed but LABEL_REVISION_NOTE was not updated --------------------------------- catalog/release.cat -- is OK --------------------------------- catalog/spice_hsk.cat -- is OK --------------------------------- catalog/spiceds.cat -- why is STOP_TIME set to 2013-08-20T00:00:00 instead of 2013-08-21T10:59:32 (end of CK coverage) or 2013-08-20T15:26:00 (tracking DCO according to SPK comments). I'd prefer the CK date. -- remove "Release 0002" paragraphs from FK and LSK sections --------------------------------- data/ck/ckinfo.txt -- "CK file" -> "CK files" on line 58 -- "spacacraft" -> "spacecraft" on line 97 -- "merged_nhpc_2007_v005.bc" -> "merged_nhpc_2007_v006.bc" line 53 -- "merged_nhpc_2016_v001.bc" -> "merged_nhpc_2013_v001.bc" line 62 -- add a note about incorrect Type 3 interpolation during some de-spin/spin-up periods -- add a note about long Type 2 interpolation during some periods --------------------------------- data/fk/fkinfo.txt -- is OK --------------------------------- data/ik/ikinfo.txt -- since this info.txt explicitly mentions all IKs, nh_alice_v110.ti should not be simply replaced with nh_alice_v120.ti. Instead the current line should be modified to mention version 110 and a new line should be added for version 120. --------------------------------- data/lsk/lskinfo.txt -- same as for ikinfo.txt -- should either mentions both LSKs by name or none (just the naming scheme) --------------------------------- data/pck/pckinfo.txt -- "spacecrafte" -> "spacecraft" on line 57 -- "nh_stars_kbo_centour_ppinp" -> "nh_stars_kbo_centaur_ppinp" on line 51 --------------------------------- data/sclk/sclkinfo.txt -- "to user" -> "to use" on line 47 --------------------------------- data/spk/spkinfo.txt -- "Kerboros" -> "Kerberos" on line 117 -- "nh_pred_od77.bsp" -> "nh_pred_od077.bsp" on line 91 -- change plu013.bsp - Ephemeris data for Pluto and Charon to nh_plu017.bsp - Ephemeris data for Pluto, Charon, Nix, and Hydra -- on line 119 add "CALLIRRHOE" because Kerberos and Styx were not extracted from jup ephemeris --------------------------------- document/docinfo.txt -- remove lines mentioning nh_pdsdd_incremental.ful and nh_cov.txt as these are not included in the data set -- change "The previous statement is true with the following exceptions:" to "The "spinstate" subdirectory contains the following additional documents:" --------------------------------- extras/mk/mkinfo.txt -- revert the file completely to the previous version from release 0001 --------------------------------- index/index.lbl index/index.tab -- while index.tab and .lbl are valid, they were not made using NAIF scripts and there fore differ in format and set of label keywords from index tables and label in all other data set -- recommend to regenerate these files using the NAIF scripts -- or, at least, re-sort the table by release, kernel type add to the label INDEXED_FILE_NAME and VOLUME_ID change START_TIME, STOP_TIME, and PRODUCT_CREATION_TIME column types from CHARACTER to TIME change RELEASE_DATE column type from CHARACTER to DATE change column descriptions to what they are in the previous release index label --------------------------------- voldesc.cat -- revert the file completely to the previous version from release 0001 --------------------------------- data/*/*.lbl -- MISSION_PHASE_NAME is set to N/A in all labels except those for CKs. This applies even to labels from the first release (my mistake, I had requested for it to be set to not N/A for some file but it did not get done). Since (1) NH changed their mission phase names, (2) this keyword is almost never set consistently -- especially for files with coverage spanning many mission phases, -- and (3) labels from release 0001 that have it wrong should not be touched, I propose to simply mention this is in errata.txt and onlabels.txt -- most DESCRIPTIONs in the labels are rather non-descriptive. It's not good but since they were like this in release 0001 we should probably let them be except for a few that clearly incorrect, specifically: data/fk/nh_soc_misc_v001.lbl has DESCRIPTION = "NH frames kernel" but it is clearly not another version of the project's main FK. data/ik/nh_pepssi_v110.lbl says that it's "NH Alice instrument kernel" but it's an IK for PEPSSI. data/pck/nh_stars_kbo_centaur_ppinp.lbl says that "NAIF planetary constants kernel" but it is clearly not another version of the generic PCK. data/spk/nh_pred_od077.lbl says that it's "Misc body/bodies kernel" while it should say "Reconstructed NH trajectory kernel". --------------------------------- data/ck/merged_nhpc_2007_v006.lbl -- MISSION_PHASE_NAME should be { JUPITER, "PLUTO CRUISE" } instead of just JUPITER --------------------------------- data/ck/*bc -- comments in new CKs do not include the top description block that talks about data source, quality flags and accuracy as did CKs from release 0001 -- some pointing instances in type 2 segments cover tens of thousands of seconds (e.g. 2008-10-25, 2008-11-15, 2008-11-20); see plot nhsp_1000_r2_bvs_ck2_durations.png -- the coverage of type 3 segments (for 3 axis stabilized attitude) start to early and ends too late in a few cases, getting into s/c spinning attitude periods and causing incorrect interpolation during when spacing between records becomes too sparse to rotation rate (see plots); see plots nhsp_1000_r2_bvs_avmag_*.png --------------------------------- data/fk/nh_soc_misc_v001.tf -- the 2002 JF56 NAIF ID in the SPK included in the archive is 2132524: % brief data/spk/sb_2002jf56_2.bsp ... Summary for: data/spk/sb_2002jf56_2.bsp .... Body: 2132524 Start of Interval (ET) End of Interval (ET) ----------------------------- ----------------------------- 2006 JAN 19 00:00:00.000 2006 OCT 02 00:00:00.000 which makes the body-name assignments in nh_soc_misc_v001.tf incorrect in the context of the archive. The file has to either be changed to map ID 2132524 to the same set of names or removed from the archive all together. If it is removed, the index, MK, fkinfo.txt, and checksum should be changed accordingly. --------------------------------- data/fk/nh_v220.tf -- is OK --------------------------------- data/ik/nh_alice_v120.ti -- has a TAB in comments -- otherwise is OK. --------------------------------- data/ik/nh_ralph_v100.ti -- new version of IK for RALPH containing complete definition for NH_RALPH/-98200 should be added to the archive. The FOV of most commonly used detector, or a FOV that envelopes all other FOVs, or something else can be used to define it. Most modern SPICE-based tools that understand SPICE FOVs require them to be complete. Such tools will "break" if they try to get FOV data from this IK. If new IK is added, then index, MK, ikinfo, checksum, and errata.txt should be changed. --------------------------------- data/lsk/naif0010.tls -- is OK --------------------------------- data/pck/nh_stars_kbo_centaur_ppinp.tpc -- needs better internal comments explaining what (a) various set of keywords are, (b) what bogus values are used and why, and (c) a summary showing which sets of keywords are used for which bodies. These comments should also state the purpose of various data items and briefly explain how they were used in NH SDC pipeline. -- it seems that between NH_TARGET_BODIES list at the top and NH_TARGET_BODIES += interspersed with other data some IDs will appear twice. -- P4/904 and P5/905 defined in this file will mask KERBEROS/904 and STYX/905 built-into the SPICE toolkit. Is this OK? If not, name/ID mappings for them should be dropped from this file or KERBEROS/904 and STYX/905 should be added after P4/904 and P5/905 with higher priority. --------------------------------- data/sclk/new_horizons_0664.tsc -- is OK --------------------------------- data/spk/de418.bsp -- is OK --------------------------------- data/spk/kbo_centaur_20131129.bsp -- is OK --------------------------------- data/spk/nh_extras.bsp -- does not have any internal comments. Adequate comments should be added to the comment area of the file. --------------------------------- data/spk/nh_pred_od077.bsp -- is OK --------------------------------- document/spinstate/nh_spin_state.asc document/spinstate/nh_spin_state.csv document/spinstate/nh_spin_state.lbl document/spinstate/nh_spin_state.py -- are OK --------------------------------- extras/mk/nh_v02.tm -- replace This file was created on January 9, 2009 by Andrew Steffl, SwRI. with This file was created on July 14, 2014 by Brian Carcich under contract to SwRI. The original name of this file was nh_v02.tm. -- drop nh_recon_j2sep07_prelimv1.bsp from the list as it is fully superseded by nh_pred_od077.bsp -- move nh_pred_od077.bsp to be after nh_recon_e2j_v1.bsp and have higher priority -- if nh_soc_misc_v001.tf is dropped from the archive, remove it from MK -- if new version of RALPH IK is added to the archive, update MK to list that newer version instead of the current IK (nh_ralph_v100.ti) -- if pck00010.tpc is added to the archive, update MK to list that PCK of the current PCK (pck00008.tpc) -- add blank lines separating groups of kernels of the same type from the other types in the list block. --------------------------------- missing kernels: -- pck00010.tpc should be added to the archive. pck00008.tpc has the old, other-side-pole constants for Pluto and Charon. pckinfo.txt should be changed to mention pck00010.tpc and to say that pck00008.tpc is obsolete. MK nh_v02.tm should be changed to list pck00010.tpc instead of pck00008.tpc -- should new Pluto system ephemeris (e.g. plu043.bsp) be added to the archive? plu043 differs from nh_plu017/de418 by ~1700 km in 2015. -- gap-filler CK? Can attitude during many longs gap when s/c was hibernating be described by a simple (or two)? If yes, can a CK and/or dynamic frame and CK be made to "fill" these gaps with some data? --------------------------------- missing meta information files: -- missing dsindex.cat and dsindex.lbl; to be added one level up from the volume root level. ==================================================================== Appendix 1: Checksum verification errors: ._catalog found in ./ has no entry in ./index/checksum.tab ._data found in ./ has no entry in ./index/checksum.tab ._document found in ./ has no entry in ./index/checksum.tab ._errata.txt found in ./ has no entry in ./index/checksum.tab ._extras found in ./ has no entry in ./index/checksum.tab ._index found in ./ has no entry in ./index/checksum.tab ._software found in ./ has no entry in ./index/checksum.tab catalog/._catinfo.txt found in ./ has no entry in ./index/checksum.tab catalog/._person.cat found in ./ has no entry in ./index/checksum.tab catalog/._spice_inst.cat found in ./ has no entry in ./index/checksum.tab data/._ck found in ./ has no entry in ./index/checksum.tab data/._ek found in ./ has no entry in ./index/checksum.tab data/._fk found in ./ has no entry in ./index/checksum.tab data/._ik found in ./ has no entry in ./index/checksum.tab data/._lsk found in ./ has no entry in ./index/checksum.tab data/._pck found in ./ has no entry in ./index/checksum.tab data/._sclk found in ./ has no entry in ./index/checksum.tab data/._spk found in ./ has no entry in ./index/checksum.tab data/ck/._merged_nhpc_2006_v011.bc found in ./ has no entry in ./index/checksum.tab data/ck/._merged_nhpc_2006_v011.lbl found in ./ has no entry in ./index/checksum.tab data/ck/._merged_nhpc_2007_v006.bc found in ./ has no entry in ./index/checksum.tab data/ck/._merged_nhpc_2007_v006.lbl found in ./ has no entry in ./index/checksum.tab data/ek/._ekinfo.txt found in ./ has no entry in ./index/checksum.tab data/fk/._nh_v200.lbl found in ./ has no entry in ./index/checksum.tab data/fk/._nh_v200.tf found in ./ has no entry in ./index/checksum.tab data/ik/._nh_alice_v110.lbl found in ./ has no entry in ./index/checksum.tab data/ik/._nh_alice_v110.ti found in ./ has no entry in ./index/checksum.tab data/ik/._nh_lorri_v100.lbl found in ./ has no entry in ./index/checksum.tab data/ik/._nh_lorri_v100.ti found in ./ has no entry in ./index/checksum.tab data/ik/._nh_pepssi_v110.lbl found in ./ has no entry in ./index/checksum.tab data/ik/._nh_pepssi_v110.ti found in ./ has no entry in ./index/checksum.tab data/ik/._nh_ralph_v100.lbl found in ./ has no entry in ./index/checksum.tab data/ik/._nh_ralph_v100.ti found in ./ has no entry in ./index/checksum.tab data/ik/._nh_rex_v100.lbl found in ./ has no entry in ./index/checksum.tab data/ik/._nh_rex_v100.ti found in ./ has no entry in ./index/checksum.tab data/ik/._nh_sdc_v101.lbl found in ./ has no entry in ./index/checksum.tab data/ik/._nh_sdc_v101.ti found in ./ has no entry in ./index/checksum.tab data/ik/._nh_swap_v100.lbl found in ./ has no entry in ./index/checksum.tab data/ik/._nh_swap_v100.ti found in ./ has no entry in ./index/checksum.tab data/lsk/._naif0009.lbl found in ./ has no entry in ./index/checksum.tab data/lsk/._naif0009.tls found in ./ has no entry in ./index/checksum.tab data/pck/._pck00008.lbl found in ./ has no entry in ./index/checksum.tab data/pck/._pck00008.tpc found in ./ has no entry in ./index/checksum.tab data/sclk/._new_horizons_413.lbl found in ./ has no entry in ./index/checksum.tab data/sclk/._new_horizons_413.tsc found in ./ has no entry in ./index/checksum.tab data/spk/._de413.bsp found in ./ has no entry in ./index/checksum.tab data/spk/._de413.lbl found in ./ has no entry in ./index/checksum.tab data/spk/._jup260.bsp found in ./ has no entry in ./index/checksum.tab data/spk/._jup260.lbl found in ./ has no entry in ./index/checksum.tab data/spk/._nh_nep_ura_000.bsp found in ./ has no entry in ./index/checksum.tab data/spk/._nh_nep_ura_000.lbl found in ./ has no entry in ./index/checksum.tab data/spk/._nh_plu017.bsp found in ./ has no entry in ./index/checksum.tab data/spk/._nh_plu017.lbl found in ./ has no entry in ./index/checksum.tab data/spk/._nh_recon_e2j_v1.bsp found in ./ has no entry in ./index/checksum.tab data/spk/._nh_recon_e2j_v1.lbl found in ./ has no entry in ./index/checksum.tab data/spk/._nh_recon_j2sep07_prelimv1.bsp found in ./ has no entry in ./index/checksum.tab data/spk/._nh_recon_j2sep07_prelimv1.lbl found in ./ has no entry in ./index/checksum.tab data/spk/._sb_2002jf56_2.bsp found in ./ has no entry in ./index/checksum.tab data/spk/._sb_2002jf56_2.lbl found in ./ has no entry in ./index/checksum.tab document/._lblinfo.txt found in ./ has no entry in ./index/checksum.tab document/._onlabels.txt found in ./ has no entry in ./index/checksum.tab extras/._extrinfo.txt found in ./ has no entry in ./index/checksum.tab extras/._mk found in ./ has no entry in ./index/checksum.tab extras/mk/._nh_v01.tm found in ./ has no entry in ./index/checksum.tab index/._indxinfo.txt found in ./ has no entry in ./index/checksum.tab software/._softinfo.txt found in ./ has no entry in ./index/checksum.tab ==================================================================== End of notes.