Kd_NN_Distribution


An implementation of the neural network algorithm created originally by Cedric Jamet and co-workers for estimating the Kd values at any wavelength. This version of the Kd_NN model can produce Kd at any wavelength (but currently recommended for the visible spectral range because no validation was carried out outside this range), using input Rrs at five light wavelengths (443 nm, 488 nm, 531 nm, 547 nm, 667 nm) corresponding to spectral bands available on ocean color sensor MODIS. The complete development and validation of the original Kd_NN model is described in Jamet et al., 2012 and updated in Loisel et al., 2018 and Jorge et al., 2021. The presented version of the Kd_NN model source code is in MATLAB file format. In this version of the Kd_NN code we introduced some changes with the primary purpose to streamline the structure of the code and facilitate its application by users. The Kd_NN software can be used in conjunction with the inverse reflectance LS2 model to enable estmation of the inherent optical properties of seawater (see the separate LS2_Distribution repository).

This README document provides information about the files within the Kd_NN_Distribution repository.


Kd_NN_MODIS.m:

Neural network model to compute the Kd values at a single preselected output light wavelength for a given set of input values of spectral Rrs(λ) and solar zenith angle, where λ is at MODIS wavelengths. Returns Kd(λ). See supporting documentation for further details.

Kd_NN_LUT_MODIS.mat:

Look-up tables (LUTs) necessary to run Kd_NN_MODIS.m. The structure contains three fields, each of which is necessary to run the neural network. See Kd_NN_MODIS.m function documentation for further details about the .mat file.

Kd_NN_test_run_MODIS.m:

Script which tests Kd_NN_MODIS.m on 100 sample inputs of spectral Rrs(λ) defined at MODIS bands, each accompanied with input solar zenith angle. The code calculates Kd at output light wavelengths within the input domain. Note that the output light wavelength can be the same or can differ between the sample inputs, where a single sample input is defined by a set of five spectral values of Rrs(λ) at MODIS wavelengths and solar zenith angle.

Kd_NN_test_run_MODIS.xls:

Spreadsheet containing the input and resulting output data obtained from the application of the Kd_NN_MODIS function on 100 sample inputs to determine Kd at various output wavelengths within the input domain. The file is the original output file generated by Kd_NN_test_run_MODIS.m.


Contributors: Matthew Kehrli, Aster Taylor, Rick A. Reynolds, and Dariusz Stramski
Contacts: Matthew Kehrli1 (mdkehrli@ucsd.edu | mdkehrli@gmail.com), Rick Reynolds1 (rreynolds@ucsd.edu), Dariusz Stramski1 (dstramski@ucsd.edu), Cédric Jamet2 (cedric.jamet@univ-littoral.fr)
1 Ocean Optics Research Laboratory, Scripps Institution of Oceanography, University of California San Diego
2 Laboratoire d’Oceanologie et de Geosciences, Universite du Littoral Cote d’Opale, Universite Lille, CNRS, Wimereux, France