Initial commit

CU-ESIIL · May 20, 2024 · 9a4a58b · 9a4a58b
commit 9a4a58b
Show file tree

Hide file tree

Showing 95 changed files with 22,424 additions and 0 deletions.
diff --git a/.github/workflows/gh-pages.yml b/.github/workflows/gh-pages.yml
@@ -0,0 +1,21 @@
+ name: Publish docs via GitHub
+ on:
+   push:
+     branches:
+       - main
+
+ jobs:
+   build:
+     name: Deploy docs
+     runs-on: ubuntu-latest
+     steps:
+       - uses: actions/checkout@v3
+       - uses: actions/setup-python@v4
+         with:
+           python-version: 3.9
+       - name: run requirements file
+         run:  pip install -r requirements.txt 
+       - name: Deploy docs
+         run: mkdocs gh-deploy --force
+         env:
+           GITHUB_TOKEN: ${{ secrets.GH_TOKEN }}
diff --git a/.gitignore b/.gitignore
@@ -0,0 +1,20 @@
+# Editors
+.vscode/
+.idea/
+
+# Vagrant
+.vagrant/
+
+# Mac/OSX
+.DS_Store
+
+# Windows
+Thumbs.db
+
+# Jupyter
+.ipynb_checkpoints
+
+# Workshop data that should not be saved in git
+data/emit
+
+# NOTE: will need to add more as we develop the code
diff --git a/.gitmodules b/.gitmodules
@@ -0,0 +1,3 @@
+[submodule "tools/emit"]
+	path = tools/emit
+	url = https://github.com/nasa/EMIT-Data-Resources.git
diff --git a/LICENSE b/LICENSE
@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Environmental Data Science Innovation and Inclusion Lab (ESIIL)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
diff --git a/README.md b/README.md
@@ -0,0 +1,19 @@
+[![DOI](https://zenodo.org/badge/747801950.svg)](https://zenodo.org/doi/10.5281/zenodo.11166886)
+
+# HYR-SENSE: Hyperspectral and Thermal Remote Sensing for Environmental Justice
+![HYR-SENSE (3)](https://github.com/CU-ESIIL/HYR-SENSE/blob/main/docs/assets/esiil_content/Hyrsense.jpeg)
+
+
+
+NASA-SBG and NSF-ESIIL "HYR-SENSE: Hyperspectral and Thermal Remote Sensing for Environmental Justice" program. This training is funded by the NASA award #8ONSSC24KO328, and is subject to the NSF’s terms and conditions.
+
+## Training details
+Join [NASA Surface Biology and Geology](https://sbg.jpl.nasa.gov/) (SBG) and [ESIIL](https://esiil.org/) in Boulder, Colorado this summer for HYR-SENSE: Hyperspectral and Thermal Remote Sensing for Environmental Justice. Participants will gain hands-on experience with hyperspectral and thermal imaging remote sensing technology and its applications for environmental justice issues. 
+
+- Who should apply?: Undergraduate and graduate students, faculty, and early career scientists currently attending or affiliated with a Tribal College or University or affiliates of Native American Tribes. Invited participants will have experience and interests in relevant disciplines, which may include ecology, environmental science, Geographic Information Systems (GIS), remote sensing, natural resource management, or similar.
+- When: June 10th-13th, 2024 with additional pre-training sessions
+- Where: University of Colorado, Boulder
+- Cost: This training is funded by NASA and ESIIL at no cost to the participant. Participants' travel costs, lodging, and meals will be fully covered.
+- This program will be tailored to the interests and needs of the participants while being led by experts in the field from NASA and ESIIL.
+
+Click [here](https://esiil.org/hyr-sense) for more details
diff --git a/data/.keep b/data/.keep
@@ -0,0 +1 @@
+
diff --git a/data/readme.md b/data/readme.md
@@ -0,0 +1 @@
+### A folder to store datasets downloaded or used during the HYR-SENSE workshop. This is used as scratch space or local storage and should not be committed to the repo
diff --git a/docker/Dockerfile b/docker/Dockerfile
@@ -0,0 +1,113 @@
+FROM quay.io/jupyter/minimal-notebook:latest 
+
+USER root
+
+# Set up package manager
+RUN apt-get install -y apt-transport-https && \
+    apt-get clean && apt-get update && apt-get install -y software-properties-common && \
+    add-apt-repository multiverse && \
+    apt-get clean && rm -rf /var/lib/apt/lists/*
+
+# Install some base software
+RUN apt-get update --yes && \
+    apt-get install --yes \
+    fonts-dejavu \
+    unixodbc \
+    unixodbc-dev && \
+    apt-get clean && rm -rf /var/lib/apt/lists/*
+
+# Add sudo to jovyan user
+RUN apt update && \
+    apt install -y sudo && \
+    apt clean && \
+    rm -rf /var/lib/apt/lists/*
+
+# This is where we can control which root permissions the jovyan user will have
+ARG PRIV_CMDS='/bin/ch*,/bin/cat,/bin/gunzip,/bin/tar,/bin/mkdir,/bin/ps,/bin/mv,/bin/cp,/usr/bin/apt*,/usr/bin/pip*,/bin/yum,/opt,/opt/conda/bin/*,/usr/bin/*'
+
+RUN usermod -aG sudo jovyan && \
+    echo "$LOCAL_USER ALL=NOPASSWD: $PRIV_CMDS" >> /etc/sudoers
+RUN addgroup jovyan
+RUN usermod -aG jovyan jovyan
+
+# Install Geospatial libraries
+RUN apt-get update && \
+    apt install -y \
+    gdal-bin \
+    lbzip2 \
+    libfftw3-dev \
+    libgdal-dev \
+    libgeos-dev \
+    libgsl0-dev \
+    libgl1-mesa-dev \
+    libglu1-mesa-dev \
+    libhdf4-alt-dev \
+    libhdf5-dev \
+    libjq-dev \
+    libpq-dev \
+    libproj-dev \
+    libprotobuf-dev \
+    libnetcdf-dev \
+    libsqlite3-dev \
+    libudunits2-dev \
+    lsb-release \
+    netcdf-bin \
+    postgis \
+    protobuf-compiler \
+    sqlite3 \
+    tk-dev \
+    libfmt-dev \
+    unixodbc-dev && \
+    apt-get clean && rm -rf /var/lib/apt/lists/*
+
+# Update permissions for /opt/conda
+RUN chown -R jovyan:users /opt/conda/share /usr/local/share /usr/local/bin/start-notebook.d 
+
+USER jovyan
+
+# Install jupyterlab and rstudio dependencies
+RUN conda install -c conda-forge \ 
+    jupyter_client \ 
+    jupyter_core \ 
+    jupyterlab_server \ 
+    jupyter_server \
+    r-rgl \
+    r-htmlwidgets \
+    r-htmltools && \ 
+    jupyter lab clean
+
+# Install Jupyter Lab Proxy extensions (cards in Launcher)
+RUN pip install jupyter-server-proxy jupyterlab-git 
+
+# Install Mamba Gator package manager
+RUN rm -f ~/.jupyter/lab/workspaces/default* && \
+    mamba install -y -c conda-forge mamba_gator
+
+# Install and configure jupyter lab 
+COPY jupyter_notebook_config.json /opt/conda/etc/jupyter/jupyter_notebook_config.json
+
+# Rebuild the Jupyter Lab with new tools
+RUN jupyter lab build
+
+# Build Conda environment
+RUN conda update -y conda && \
+    conda config --remove channels conda-forge && \
+    conda config --add channels conda-forge
+WORKDIR /home/jovyan
+COPY environment.yml /home/jovyan/ 
+RUN mamba env create -f /home/jovyan/environment.yml
+
+#RUN jupyter kernelspec remove python3
+
+RUN . /opt/conda/etc/profile.d/conda.sh \
+    && conda deactivate \
+    && conda activate hyr-sense \
+    && python -m ipykernel install --name hyr-sense \
+    && python -m ipykernel install --name hyr-sense --display-name "hyr-sense" \
+    && python -m ipykernel install --name hyr-sense --user \
+    && python -m ipykernel install --name hyr-sense --user --display-name "hyr-sense"
+
+RUN jupyter kernelspec remove -f python3
+
+RUN pip install jupyter_contrib_nbextensions
+
diff --git a/docker/environment.yml b/docker/environment.yml
@@ -0,0 +1,49 @@
+name: hyr-sense
+channels:
+  - conda-forge
+dependencies:
+  - python=3.10
+  - xarray=2024.1.0
+  - dask
+  - dask-gateway
+  - graphviz
+  - distributed
+  - h5py>= 3.9
+  - matplotlib-base
+  - matplotlib
+  - seaborn
+  - hvplot
+  - pyproj
+  - bqplot
+  - zarr
+  - cartopy
+  - pynco
+  - joblib
+  - pystac-client
+  - pydap
+  - ipyleaflet
+  - dask-labextension
+  - pooch
+  - numpy
+  - gdal
+  - rioxarray
+  - geoviews
+  - geopandas
+  - pandas
+  - pyproj
+  - earthaccess>=0.8.2
+  - scikit-image
+  - shapely
+  - holoviews
+  - pqdm
+  - s3fs
+  - nbgitpuller
+  - panel
+  - h5netcdf
+  - pip:
+    - ray
+    - spectral
+    - rasterio
+    - fsspec
+    - branca
+    - hvplot
diff --git a/docker/jupyter_notebook_config.json b/docker/jupyter_notebook_config.json
@@ -0,0 +1,14 @@
+{
+    "NotebookApp": {
+      "allow_origin" : "*",
+        "token":"",
+        "password":"",
+      "nbserver_extensions": {
+        "jupyterlab": true,
+        "mamba_gator": true
+      }
+    },
+    "KernelSpecManager": {
+    	"ensure_native_kernel": false
+    }
+  }  
diff --git a/docs/assets/cyverse_basics/app_launch.png b/docs/assets/cyverse_basics/app_launch.png
diff --git a/docs/assets/cyverse_basics/app_settings.png b/docs/assets/cyverse_basics/app_settings.png
diff --git a/docs/assets/cyverse_basics/apps.png b/docs/assets/cyverse_basics/apps.png
diff --git a/docs/assets/cyverse_basics/click_cyverse_utils.png b/docs/assets/cyverse_basics/click_cyverse_utils.png
diff --git a/docs/assets/cyverse_basics/clone.png b/docs/assets/cyverse_basics/clone.png
diff --git a/docs/assets/cyverse_basics/cyverse-utils.png b/docs/assets/cyverse_basics/cyverse-utils.png
diff --git a/docs/assets/cyverse_basics/email.png b/docs/assets/cyverse_basics/email.png
diff --git a/docs/assets/cyverse_basics/final.png b/docs/assets/cyverse_basics/final.png
diff --git a/docs/assets/cyverse_basics/go_to_analysis.png b/docs/assets/cyverse_basics/go_to_analysis.png
diff --git a/docs/assets/cyverse_basics/jupyterlab.png b/docs/assets/cyverse_basics/jupyterlab.png
diff --git a/docs/assets/cyverse_basics/key.png b/docs/assets/cyverse_basics/key.png
diff --git a/docs/assets/cyverse_basics/launch.png b/docs/assets/cyverse_basics/launch.png
diff --git a/docs/assets/cyverse_basics/new_key.png b/docs/assets/cyverse_basics/new_key.png
diff --git a/docs/assets/cyverse_basics/open_cyverse_utils.png b/docs/assets/cyverse_basics/open_cyverse_utils.png
diff --git a/docs/assets/cyverse_basics/paste_key.png b/docs/assets/cyverse_basics/paste_key.png
diff --git a/docs/assets/cyverse_basics/script_1.png b/docs/assets/cyverse_basics/script_1.png
diff --git a/docs/assets/cyverse_basics/settings.png b/docs/assets/cyverse_basics/settings.png
diff --git a/docs/assets/cyverse_basics/ssh.png b/docs/assets/cyverse_basics/ssh.png
diff --git a/docs/assets/cyverse_basics/use_this_app.png b/docs/assets/cyverse_basics/use_this_app.png
diff --git a/docs/assets/cyverse_basics/username.png b/docs/assets/cyverse_basics/username.png
diff --git a/docs/assets/esiil_content/ESIIL_logo.png b/docs/assets/esiil_content/ESIIL_logo.png
diff --git a/docs/assets/esiil_content/HYR_SENSE_logo.png b/docs/assets/esiil_content/HYR_SENSE_logo.png
diff --git a/docs/assets/esiil_content/Hyrsense.jpeg b/docs/assets/esiil_content/Hyrsense.jpeg
diff --git a/docs/assets/esiil_content/favicon.ico b/docs/assets/esiil_content/favicon.ico
diff --git a/docs/assets/esiil_content/stac_mount_save/Ansel_Adams_datacube.png b/docs/assets/esiil_content/stac_mount_save/Ansel_Adams_datacube.png
diff --git a/docs/assets/esiil_content/stac_mount_save/Ansel_adams_Jackson_hole.png b/docs/assets/esiil_content/stac_mount_save/Ansel_adams_Jackson_hole.png
diff --git a/...e/David-Yarrow-sorrel-sky-gallery-Photographic-Print-Cindys-Shotgun-Wedding.png b/...e/David-Yarrow-sorrel-sky-gallery-Photographic-Print-Cindys-Shotgun-Wedding.png
diff --git a/docs/assets/esiil_content/stac_mount_save/View_Ansel-Adams_Camera.png b/docs/assets/esiil_content/stac_mount_save/View_Ansel-Adams_Camera.png
diff --git a/docs/assets/esiil_content/stac_mount_save/anim.gif b/docs/assets/esiil_content/stac_mount_save/anim.gif
diff --git a/docs/assets/esiil_content/stac_mount_save/antelopeinpython.png b/docs/assets/esiil_content/stac_mount_save/antelopeinpython.png
diff --git a/docs/assets/esiil_content/stac_mount_save/bison.png b/docs/assets/esiil_content/stac_mount_save/bison.png
diff --git a/docs/assets/esiil_content/stac_mount_save/drink-firehose.png b/docs/assets/esiil_content/stac_mount_save/drink-firehose.png
diff --git a/docs/assets/esiil_content/stac_mount_save/mouseinsnake.png b/docs/assets/esiil_content/stac_mount_save/mouseinsnake.png
diff --git a/docs/assets/hyrsense_facilitators/Aaron_Friesz.png b/docs/assets/hyrsense_facilitators/Aaron_Friesz.png
diff --git a/docs/assets/hyrsense_facilitators/Ayia_Lindquist.png b/docs/assets/hyrsense_facilitators/Ayia_Lindquist.png
diff --git a/docs/assets/hyrsense_facilitators/Ben_Poulter.png b/docs/assets/hyrsense_facilitators/Ben_Poulter.png
diff --git a/docs/assets/hyrsense_facilitators/Bridget_Hass.png b/docs/assets/hyrsense_facilitators/Bridget_Hass.png
diff --git a/docs/assets/hyrsense_facilitators/Casey_Jenson.png b/docs/assets/hyrsense_facilitators/Casey_Jenson.png
diff --git a/docs/assets/hyrsense_facilitators/Cibele_Amaral.png b/docs/assets/hyrsense_facilitators/Cibele_Amaral.png
diff --git a/docs/assets/hyrsense_facilitators/Erick_Verleye.png b/docs/assets/hyrsense_facilitators/Erick_Verleye.png
diff --git a/docs/assets/hyrsense_facilitators/Jesse_Barber.png b/docs/assets/hyrsense_facilitators/Jesse_Barber.png
diff --git a/docs/assets/hyrsense_facilitators/Jim_Sanovia.png b/docs/assets/hyrsense_facilitators/Jim_Sanovia.png
diff --git a/docs/assets/hyrsense_facilitators/Katya_Jay.png b/docs/assets/hyrsense_facilitators/Katya_Jay.png
diff --git a/docs/assets/hyrsense_facilitators/Kelly_Luis.png b/docs/assets/hyrsense_facilitators/Kelly_Luis.png
diff --git a/docs/assets/hyrsense_facilitators/Mahsa_Jami.png b/docs/assets/hyrsense_facilitators/Mahsa_Jami.png
diff --git a/docs/assets/hyrsense_facilitators/Nate_Quarderer.png b/docs/assets/hyrsense_facilitators/Nate_Quarderer.png
diff --git a/docs/assets/hyrsense_facilitators/Nayani_Ilangakoon.png b/docs/assets/hyrsense_facilitators/Nayani_Ilangakoon.png
diff --git a/docs/assets/hyrsense_facilitators/Rachel_Lieber.png b/docs/assets/hyrsense_facilitators/Rachel_Lieber.png
diff --git a/docs/assets/hyrsense_facilitators/Shawn_Serbin.png b/docs/assets/hyrsense_facilitators/Shawn_Serbin.png
diff --git a/docs/assets/hyrsense_facilitators/Ty_Tuff.png b/docs/assets/hyrsense_facilitators/Ty_Tuff.png
diff --git a/docs/index.md b/docs/index.md
@@ -0,0 +1,17 @@
+# HYR-SENSE: Hyperspectral and Thermal Remote Sensing for Environmental Justice
+![](./assets/esiil_content/Hyrsense.jpeg)
+
+
+
+NASA-SBG and NSF-ESIIL "HYR-SENSE: Hyperspectral and Thermal Remote Sensing for Environmental Justice" program. This training is funded by the NASA award #8ONSSC24KO328, and is subject to the NSF’s terms and conditions.
+
+## Training details
+Join [NASA Surface Biology and Geology](https://sbg.jpl.nasa.gov/) (SBG) and [ESIIL](https://esiil.org/) in Boulder, Colorado this summer for HYR-SENSE: Hyperspectral and Thermal Remote Sensing for Environmental Justice. Participants will gain hands-on experience with hyperspectral and thermal imaging remote sensing technology and its applications for environmental justice issues. 
+
+- Who should apply?: Undergraduate and graduate students, faculty, and early career scientists currently attending or affiliated with a Tribal College or University or affiliates of Native American Tribes. Invited participants will have experience and interests in relevant disciplines, which may include ecology, environmental science, Geographic Information Systems (GIS), remote sensing, natural resource management, or similar.
+- When: June 10th-13th, 2024 with additional pre-training sessions
+- Where: University of Colorado, Boulder
+- Cost: This training is funded by NASA and ESIIL at no cost to the participant. Participants' travel costs, lodging, and meals will be fully covered.
+- This program will be tailored to the interests and needs of the participants while being led by experts in the field from NASA and ESIIL.
+
+Click [here](https://esiil.org/hyr-sense) for more details