CAT 7.3.1 Release Notes -- October 16, 2015 ================================================================= 1. Intro ================================================================= Download: Location: http://utopia.jhuapl.edu/flight/cat_archive/CAT7_3_1/ (CRISM Team only) http://pds-geosciences.wustl.edu/missions/mro/crism.htm (link for everyone) 6 files: cat731_release.txt This file. cat_setup.pdf setup guide CAT_v7_3_1.zip Full CAT distribution zip file. CAT_v7_3_1_codeonly.zip CAT software directories only (no aux_files) CAT_v7_3_1_aux.zip CAT aux_files directories only (no code) CAT73_history_symbols.txt CAT history string description (You need either CAT_v7_3_1.zip, or both CAT_v7_3_1_codeonly.zip and CAT_v7_3_1_aux.zip) zip file sizes: CAT_v7_3_1.zip 485 MB CAT_v7_3_1_codeonly.zip 9.5 MB CAT_v7_3_1_aux.zip 475 MB unzipped directory tree sizes (approx): CAT_ENVI, full set: 1.0 GB CAT_ENVI, code only: 16 MB aux_files: 1.0 GB ================================================================= 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) ================================================================= 4. Bug Fixes since 7.1.1 ================================================================= Fixed an infinite loop problem in patch_vs_artifact.pro Fixed "Expression must be a scalar..." error in CDR search Fixed undefined keyword in radiance-to-I/F conversion Fixed a crash in atmospheric correction scaling. Fixed a crash in PDS file search routine (typo - "reurn" instead of "return"). Fixed a crash with default tie points in continuum cube ================================================================= 5. New CDR/ADR ================================================================= None in 7.3.1 (modified VS lables) ================================================================= 6. New header parameters ================================================================= The following header parameters all specify whether various corrections are applied for MTRDR filtering. They are not relevant for standard unfiltered TRR3 data, just MTR and TER files: cat photometric correction flag cat atmospheric correction flag cat ratio shift correction flag cat empirical geometric normalization flag cat empirical smile correction flag cat sensor space transform flag ================================================================= 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.