/NW-CLP-RS

Generalized repository for Northern and Cache La Poudre lakes and reservoir remote sensing pulls and collation.

Primary LanguageRMIT LicenseMIT

NW-CLP-RS

Generalized repository for Northern and Cache La Poudre lakes and reservoir remote sensing pulls and collation.

Primary repository contact: B Steele

This repository is covered by the MIT use license. We request that all downstream uses of this work be available to the public when possible.

Important notes:

This repository uses a symlink data folder to the NASA-NW OneDrive data folder. Contact B for the link to this if needed.

This workflow incorporates environment settings within an .Renviron document. You will need to create a .Renviron document in the root directory containing the following information, but with proper punctuation:

google_email = "the ROSS yndicate at gmail dot com"

nw_clp_pull_version_date = "2023-12-07"

regional_pull_version_date = "2023-08-17"

collation_date = "2023-12-08"


{targets} architecture overview

This targets workflow is broken down into groups of target lists that perform functional chunks of the workflow.

a_locs_poly_setup:

This group sets up the locations and polygon files for RS retrieval. The group of functions collates a few different polygon and point files into a single file of each type as needed for the RS workflow.

b_RS_data_acquisition:

This group of targets acquires the Landsat record for our focus lakes as part of the Northern Water project, our internal Cache La Poudre lakes, as well as all lakes greater than 1 hectare in the CLP HUC12.

c_historical_RS_data_collation:

This group of functions downloads and processes GEE output from historical pulls completed in the b group.

d_calculate_handoff_coefficients:

This group of functions calculates the inter-mission handoff coefficients from the regional pull data. Landsat 4-7 and 8-9 surface reflectance data go through two different atmospheric corrections (LEDAPS and LaSRC). Additionally, each band wavelength can vary between missions. This script uses an adapted version of the methods in Topp, et al. 2021 to correct for each satellite handoff, correction to LS 7 values. Additionally, a handoff for Landsat 7 and 9 is calculated to harmonize to LS 8 values for workflows that do not require the entire LS record. The LS 9 to LS 8 handoffs include calculations for the Aerosol band, which may be useful for workflows that only use LS 8 & 9.

e_apply_handoff_coefficients:

This group of functions applies the handoff coefficients to dataset(s), flags for band values outside of the handoff inputs that created the correction coefficients, and saves the analysis-ready file(s). Additionally, figures are created to compare the raw, LS7-corrected, and LS8-corrected figures.

f_separate_NW_CLP_data:

This group of functions splits the data for individual research programs and stores them in the ROSS Google Drive.