grit-lab-public-soil-moisture-retrieval-repo
GRIT Lab Soil Moisture Retrieval Algorithms and Data for JGR Biogeosciences Publication 2023
https://github.com/grit-lab/grit-lab-public-soil-moisture-retrieval-repo
Science Score: 67.0%
This score indicates how likely this project is to be science-related based on various indicators:
-
✓CITATION.cff file
Found CITATION.cff file -
✓codemeta.json file
Found codemeta.json file -
✓.zenodo.json file
Found .zenodo.json file -
✓DOI references
Found 5 DOI reference(s) in README -
✓Academic publication links
Links to: zenodo.org -
○Academic email domains
-
○Institutional organization owner
-
○JOSS paper metadata
-
○Scientific vocabulary similarity
Low similarity (15.4%) to scientific vocabulary
Scientific Fields
Repository
GRIT Lab Soil Moisture Retrieval Algorithms and Data for JGR Biogeosciences Publication 2023
Basic Info
- Host: GitHub
- Owner: grit-lab
- License: mit
- Language: HTML
- Default Branch: main
- Size: 31 MB
Statistics
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
- Releases: 3
Metadata Files
README.md
grit-lab-public-soil-moisture-retrieval-repo
Public Release v1.0.3
Welcome to our repository. Here, you will find the Python scripts and the lab and UAS dataset that were used in the research article "Comparison of Soil Moisture Content Retrieval Models Utilizing Hyperspectral Goniometer Data and Hyperspectral Imagery from an Unmanned Aerial System" by Nayma Binte Nur and Charles M. Bachmann, which has been published in Journal of Geophysical Research - Biogeosciences and is accessible via this link: https://doi.org/10.1029/2023JG007381.
For the most recent updates, kindly visit our GitHub repository at grit-lab-public-soil-moisture-retrieval-repo.
Repository Structure
The repository comprises Python implementations of three soil moisture content retrieval models:
- MARMIT
- Original (SWAP)-Hapke
- Modified (SWAP)-Hapke
These models are implemented for two types of datasets: Lab data and UAS data. Each model directory contains its API documentation in the docs folder to help you understand the Python modules better. The input folder holds the datasets used in this study. Please note that in our Python scripts, K, psi, and alpha correspond to A, B, and ψ of the article respectively.
This code has been developed with Python version 3.8. For a list of required packages, please refer to requirements.txt.
Usage Instructions
Working with Lab Data
To use the Lab data, execute the following program:
python3 run_project.py
On launching the program, you will be prompted with the following message:
Choose the lab dataset to process (alg/nev/hogp/hogb):
Here, you should select the lab dataset to be processed (e.g., 'alg') and hit Enter. This will kick-start the program to retrieve SMC using the corresponding model for the selected dataset. All outputs from the program will be stored in the outputs folder.
After processing all four lab datasets, you can execute the following program to plot the retrieved SMC vs. estimated SMC for all four lab datasets:
python3 plot_smc_mes_est.py
Working with UAS Data
To use the UAS data, execute the following program:
python3 run_project.py
This will start the program to retrieve SMC using the corresponding model for the UAS dataset.
Please note that the retrieval of SMC from the UAS dataset is performed through a bootstrapping process. The data is randomly split 80/20 into training and testing datasets. This random splitting is repeated 1000 times, so due to the random nature of assigning the testing & training data, the final output may slightly vary each time you run the program. All outputs from the program will be stored in theoutputs folder.
Citing this Repository
If you find the data set or Python scripts in this repository useful for your work, we kindly request that you cite it. The DOI badge below corresponds to the latest version of our software available on Zenodo.
Click on the badge to access the citation details. Thank you for supporting open science!
Owner
- Login: grit-lab
- Kind: user
- Repositories: 1
- Profile: https://github.com/grit-lab
Citation (CITATION.cff)
cff-version: 1.0.3
message: "If the provided data or code is incorporated into your work, please cite as suggested and also reference the original article published in the Journal of Geophysical Research - Biogeosciences:
'Comparison of Soil Moisture Content Retrieval Models Utilizing Hyperspectral Goniometer Data and Hyperspectral Imagery from an Unmanned Aerial System' by Nayma Binte Nur and Charles M. Bachmann, which is accessible via this link: https://doi.org/10.1029/2023JG007381."
authors:
- family-names: Nur
given-names: Nayma Binte
orcid: https://orcid.org/0000-0002-0039-9598
- family-names: Bachmann
given-names: Charles M.
orcid: https://orcid.org/0000-0002-3466-0483
title: "Associated Data and Code for 'Comparison of Soil Moisture Content Retrieval Models Utilizing Hyperspectral Goniometer Data and Hyperspectral Imagery from an Unmanned Aerial System' "
version: 1.0.3
doi: 10.5281/zenodo.8021935
date-released: 2022-06-09
related_identifiers:
- type: "isSupplementTo"
identifier: "https://doi.org/10.1029/2023JG007381"
GitHub Events
Total
- Push event: 1
Last Year
- Push event: 1
Dependencies
- lmfit ==1.0.2
- matplotlib ==3.5.1
- multiprocess ==0.70.12.2
- numpy ==1.22.3
- pandas ==1.4.0
- prettytable ==2.4.0
- scikit-learn ==1.0.2
- scipy ==1.7.3
- spectral ==0.22.4