Please use the repository Issues page for code issues or if items in this README need to be updated. All other correspondence can be directed toward Ian Black (blackia@oregonstate.edu).
This project was built around the OOI JupyterHub. You can sign up for a free account here.
Steps
- First navigate to your user directory (/home/jovyan).
cd ~
- Clone this repository to your user directory.
git clone https://github.com/IanTBlack/oregon-shelf-mhw.git
- Create a new virtual environment.
cd ~
conda create -n ormhw python=3.12
conda activate ormhw
python -m ipykernel install --user --name ormhw --display-name "Python (ormhw)"
- Install ooijh. ooijh is a Python package specifically built for the OOI JupyterHub that streamlines data access and analysis of OOI datasets.
cd ~
conda activate ormhw
git clone https://github.com/IanTBlack/ooijh.git
cd ooijh
pip install -r requirements.txt
pip install .
- Install required packages.
cd ~
cd oregon-shelf-mhw
pip install -r requirements.txt
Notebooks in the main project repository are ordered. It is expected that you run these notebooks in order if you are running this project for the first time. Many notebooks rely on data that was previously downloaded or curated by another notebook.
By default, curating NASA data is done iteratively for each year, which can take about 24 hours. It is beneficial to run multiple notebooks at once. Simply copy the notebook and reassign a new year. This will reduce processing time considerably.
- NOAA OISSTV2: 1983-2023
- NASA MODIS-Aqua L2 Ocean Color: 2015-2023
- GEBCO 2023: 2023
- CUTI and BEUTI: 2015-2023
OOI datasets are identified by a site, node, instrument, method, and stream. These describe the spatial location (site), the logger (node, which can also be loosely used to identify the vertical location), the sensor, the data delivery method, and the data stream (most sensors have one data stream, but some datasets are split into scientific/engineering, which is where the stream id comes in).
Example:
- site: CE01ISSM
- node: RID16
- instrument: 03-CTDBPC000
- method: recovered_host
- stream: ctdbp_cdef_dcl_instrument_recovered
Below are THREDDS catalog links to the recovered_host
datasets that were used in this study. Note that the ooijh package (under development) will automatically merge datasets that were delivered by different methods in order to achieve the most complete time-series.
- OOI CE01ISSM 7M CTD
- OOI CE02SHSM 7M CTD
- OOI CE04OSSM 7M CTD
- OOI CE01ISSM 7M Fluorometer
- OOI CE02SHSM 7M Fluorometer
- OOI CE04OSSM 7M Fluorometer
- All OOI Datasets
Additional information about each platform can be found in the list below.
The provided notebooks will automatically download files, with two exceptions.
- The CUTI/BEUTI dataset must be manually downloaded and then reuploaded to the OOI JupyterHub.
- The NASA data requests require login information input into a
.netrc
file within the user directory.
machine urs.earthdata.nasa.gov
login your-login-here
password your-password-here