MSL12 Code Package Change Log (updated Jun 30, 2020)

Changes-to-make List:

1. Improve strayligh/cloudshadow flagging using NIR cloudmask info
2. New sensor capabilities: MSI/Sentinel-2

v1.8 (May.15, 2023) Major Updates:

1. Implement band-dependent geometry capability (solar/sensor angles)
2. Fix a major bug in NIR-SWIR blending scheme (arg float/int issue with windex)
3. Add a small program to copy L2 flags for use in second output file.

v1.7 (Oct.19, 2022) Major Updates:

1. Implemented SGLI/GCOM-C1 processing capability
2. SGLI 672nm and 867nm low/high-gain switch based on glint coefficient

v1.6 (Oct.26, 2021) Major Updates:

1. Implemented OLCI/Sentinel-3B processing capability
2. Fixed Rayleigh out-of-band correction for VIIRS sensors (changed a0, a1 in getrayleigh.f)
3. Add coefficients for GOCI, MODISA and J2 to derive SNPP-consistent products

v1.5 (Jun.23, 2021) Major Updates:

1. Implemented J2 processing capability
   1. Verification of J2 Ocean Color Data Processing Using MSL12
   2. Prepared LUTs for VIIRS JPSS-2 including sensor file, aerosol tables, default par file and filter file, etc.
   3. Revised MSL12 codes to add J2 sensor and temporarily use same parameters as NOAA-20
   4. Investigated and found that the official simulated J2 sample granules cannot be used for the testing purpose (other than the data format verification)
   5. Used the same NOAA-20 test case delivered to CoastWatch, duplicated the M1 file and modified its metadata to make MSL12 recognizable for the file as a J2 granule
   6. Generated/simulated a sample J2 granule using NOAA-20 SDR data with changing the metadata for J2
   7. Processed the "J2 granule" using the MSL12 ocean color data processing with J2 data processing implemented
   8. We tested with vicarious gains of 1.0 and also using the NOAA-20 vicarious gain set

v1.4 (Oct.30, 2020) Major Updates:

1. Multiple NetCDF L2 files output capability
2. Improved Landmask with 250m resolution
3. Add new evaluationproducts: Suspended Particulate Matter (SPM) and Water Class (by-product of QA score) (Wei et al., 2021)
4. Use band ratio info at open ocean only to derive products across various sensors for consistent results (Wang et al., 2020)
5. Updated QAA method to use NIR band when calculating IOPs in turbid waters (Shi & Wang, 2019)
6. Updated blue-band correction method using spectra information, which can also deal with negative Rayleigh-corrected reflectance (Wang & Jiang, 2018)
7. Updated spectra database for QA score calculation
8. Adjust f/Q effect to apply only to open oceans
9. Updated sensor files to use RSR-weighted water properties
10. Improve straylight flagging for VIIRS-NOAA20 using band relationship with SNPP nLw(551) climatology at open oceans only
11. Add NIR QAA and NEGLRC, LOWLWCORFR flags
12. Fix VIIRS sensor subregion bug due to different aggregation zones

v1.3 (Dec.21, 2018) Major Updates:

1. VIIRS-J1 sensor capability
2. BRDF options for f/Q effect
3. New "start_orbit_number" atttribute in file metadata
4. The "processing_version" attrbiute in metadata now uses software version defined in code and gets rest from parameter file
5. QA score updated to five common bands across different sensors

v1.22 (Nov.13, 2017) Major Updates:

1. New improved aerosol products: averaged flat angstrom "angstrom_ave" and aerosol optical thickness at any wavelength (aot_xxx)

v1.21 (Apr.26, 2017) Major Updates:

1. Update analytical multi-scattering Epsilon method during strong absorbing aerosol case
2. Update fill values and high-resolution dimension variables

v1.20 (Mar.22, 2017) Major Updates:

1. I-band high/low resolution processing capability for VIIRS-SNPP (Wang & Jiang, 2018)
2. New sensor capabilities: GOCI/COMS, OLCI/Sentinel-3, and OLI/Landsat8
3. New atmspheric processing scheme: NIR+SWIR BMW (OLCI)
4. NIR/SWIR atmospheric correction band specification through parameter file
5. OCI chlorophyll merging algorithm update
6. New quality product: QA Score
7. Analytical multi-scattering Epsilon for specified nLw minimum
8. Rayleigh optical thickness variation with latitude-dependent gravity
9. Sensor-independent LUTs for diffusive transmittance, Rayleigh reflectance and aerosol phase function
10. Sensor file updates for RSR-weighted Rayleigh optical thickness, water absorption and backscattering
11. Major bug fixes: correct rotation angle for polorization correciton and add NO2 absorption

v1.10 (Apr.19, 2016) Major Updates:

1. Wavelength change for VIIRS-SNPP nLw
2. NetCDF metadata finalization
3. New prodcuts: GIOP implementation
4. OCI chlorophyll algorithm coefficients change
5. L2 flag change
6. Improved straylight flagging with 4km nLw551 climatology and bilinear interpolation
7. New NIR atmospheric correction scheme: no NIR correction
8. High resolution 250m landmask in NetCDF format (data from MOD44W)
9. Implement aerosol dual-model for vicarious calibration purpose
10. Iterative scheme in vicarious calibration
11. Sun-glint iteration for SWIR processing
12. Miscellaneous bug fixes: aerosol single and multi-scattering conversion, taua calculation, mside reading, linear abcde coefficient delcaration, SWIR filtering

v1.02 (Jun.05, 2015) Major Updates:

1. Enabled Rrs and rhos outputs
2. Redefined ATMWARN flag to not be triggered by negative nLws
3. OCI chlorophyll calculation bug fix
4. Scale factor and intercept changes for some products
5. Valid range changes for Kd products

v1.01 (May.11, 2015) Major Updates:

1. Product name change for Kd(490) and Kd(PAR)
2. Changed min valid value from zero to a small positive for chlorophyll and Kd prodcuts

v1.00 (Apr.24, 2015) Initial Features:

1. NetCDF4 output format and metadata convention compliance
2. Product destriping and straylight/cloudshadow flagging as post-processes
3. Improved NIR atmospheric correction (BMW) and NIR-SWIR blending scheme
4. On-the-fly F-factor ratio application for products of science quality
5. Sensor-independent 280-band Rayleigh LUT
6. Correct polarization correction for VIIRS-SNPP
7. New products QAA IOPs, Kd(PAR) and OCI-based chlorophyll
8. Optimized and standardized source code