git clone --recursive --remote-submodules https://github.com/STREAM-RS/STREAM-RS
Tutorials for using MDNs with in situ measurements and satellite imagery
Requirements:
-Conda or pip to create a virtual environment | https://github.com/conda-forge/miniforge or https://docs.anaconda.com/miniconda/
-(if not using Conda) Python V3.12
-git | https://github.com/git-guides/install-git
-git-lfs | https://docs.github.com/en/repositories/working-with-files/managing-large-files/installing-git-large-file-storage
Installation steps to be run in in Terminal (or Command Prompt for Windows):
- Create directory to hold tutorials and environment:
mkdir Aquaverse - Navigate to directory:
cd Aquaverse - Clone tutorials repo:
git clone https://github.com/ryan-edward-oshea/MDN_tutorials.git - Skip if using conda: Install Python 3.12
- Create a virtual environment:
python3.12 -m venv AQV_env_11_19_25
or with conda: conda create -n AQV_env_11_19_25 python=3.12 - Activate the environment:
Mac/Linux:source AQV_env_11_19_25/bin/activate
Windows:AQV_env_11_19_25\Scripts\activate
or with conda: conda activate AQV_env_11_19_25 - Update pip:
python -m pip install --upgrade pip - Install the MDN into the python environment and update dependencies:
pip install git+https://github.com/STREAM-RS/MDN-STREAM.git@development - Start JupyterHub notebook in command line with:
jupyter-notebook - Open the tutorials:
./MDN_tutorials/SC_1_....
Common issues:
- Unable to install Latex --> add "mpl.rcParams['text.usetex']=False" before generating plots.
- Do not install MDN wihin Box/Onedrive folder.