CAT 7.4 Release Notes -- December 28, 2018 ================================================================= 1. Intro ================================================================= Download: Location: http://utopia.jhuapl.edu/flight/cat_archive/CAT7_4/ (CRISM Team only) http://pds-geosciences.wustl.edu/missions/mro/crism.htm (link for everyone) 6 files: cat74_release.txt This file. cat_setup.pdf setup guide CAT_v7_4.zip Full CAT distribution zip file. CAT_v7_4_codeonly.zip CAT software directories only (no aux_files) CAT_v7_4_aux.zip CAT aux_files directories only (no code) CAT74_history_symbols.txt CAT history string description (You need either CAT_v7_4.zip, or both CAT_v7_4_codeonly.zip and CAT_v7_4_aux.zip) zip file sizes: CAT_v7_4.zip 524 MB CAT_v7_4_codeonly.zip 9.6 MB CAT_v7_4_aux.zip 514 MB ================================================================= 2. Installation notes ================================================================= Installation is described in cat_setup.pdf. You HAVE to have aux_files somewhere, and CAT needds to know where it is. ================================================================= 3. Summary of Main Changes Since 7.0 ================================================================= Version 7.0: Added support for MTRDR data; added atmospheric transmission CDR's from new volcano scans, and added artifact patch data to the CDRs. Version 7.1: Added volcano scan artifact correction. Added a volcano scan selection method: "Best match to bench temperature-derived spectral shift." Finds the volcano scan with spectral shift (calculated from optical bench temperature) that's closest to the shift of the observation being corrected. (In contrast, "Pre-selected volcano scan optimum for thermal period" uses the volcano scan that's the best overall match to all the observations in a thermal period, not necessarily the specific observation of interest.) Version 7.2: Added a volcano scan selection method: "Empirically optimized for this observation" Extract an 11-line subset from near the center of an observation. Apply all the available volcano scans to those lines. Evaluate the shift artifact at all lines and all sweetspot samples. Select the volcano scan that produces the smallest artifacts. (This is done offline and selected volcano scans are read from the AT observation info file; for observations where the volcano scan is not found there [e.g. observations newer than the info file], the comparison is performed on the fly by CAT.) Version 7.2.1: Bug fixes in non-tile atmospheric correction, PDS file searches. Version 7.3.1: Viviano-Beck et al 2014 summary parameters Version 8 VS ADR labels updated to comply with PDS. Works with MTRDR updates; fixed issues noted during PDS review Spectral stats: ignore CRISM NAN 65535 Updated obs info file (to Feb 2015) CRISM Z-profile now works with projected cubes EXPERIMENTAL: "CRISM Active z-profile" (updates spectrum as you move around, old CRISM z-profile was static) Version 7.4: Version 9 volcano scan ADR adds 5 new volcano scans Map projection matches MTRDR Remove options for bench temperature VS ADR selection Correct bugs in volcano scan artifact patch and 3 summary parameters ================================================================= 4. Bug Fixes since 7.3 ================================================================= Fixed a bug in the convergence test in volcano scan artifact patch scaling Testing suggests the bug rarely results in a difference greater than ~1% of continuum and usually that threshold is exceeded only for observations with problematic data or very strong ice bands. Fixed typs in three summary parameters: crism_summary_bd3400, crism_summary_bd3400_2, crism_summary_icer2_2 ================================================================= 5. New CDR/ADR ================================================================= Version 9 VS ADR (5 new volcano scans: 27233 2815C 28395 28D04 32AFC) ================================================================= 6. New header parameters ================================================================= None ================================================================= 7. New CAT config file parameters ================================================================= None ================================================================= 8. Known Bugs ================================================================= ***** TRR2 Atmospheric Correction May Fail ***** CAT will fail to correct TRR2 data if one of the new volcano scans (11d87, 1b815, 12B2C, 103D6, 11739) is selected. These may be selected by either of the automated selection algorithms, or by the user. The new volcano scans have not been processed with TRR2 data. Since the volcano scan source data must match the calibration version of the scene being corrected, CAT fails to apply the correction if the requested volcano scan is not available in the required version. WORKAROUND: Try a different automated method, a different volcano scan may be emloyed; or use user selection to use one og the old volcano scans: 61c4, 8608, a93e are the clean ones. Mac vs. Windows differences Testing has uncovered certain CAT outputs where numerical results differ between Mac and Windows versions. These are: - Summary parameters BDI1000IR and BDI2000 - CIRRUS destripe - CIRRUS despike In all cases tested, there are only a few pixels where differences are of a significant magnitude. Results are identical or differ by floating point roundoff-like amounts at nearly all pixels. These differences probably result from algorithmic sensitivity to machine-dependent floating point processing differences at a few anomalous pixels, and probably does NOT indicate any overall unreliability of these outputs. However, the exact source of these differences is not yet determined. Other Mac vs. Windows CAT outputs are exactly identical. Thermal Model AlgK thermal model partially implemented.