A collection of notebooks and methods made unifying the process of loading two-dimensional oceanic current vector fields from models and observations, simulating trajectory models, and analyzing and visualizing particle trajectories.
The core library used in this project is OceanParcels, which is used for particle advection math.
It is highly recommended to use Miniconda to set up the Python environment.
The easiest way to install the dependencies is with the environment.yml
file.
conda env create -f environment.yml
This will create a Conda environment named py3-parcels
.
To make the Conda environment useable in Jupyter, run these two commands
conda activate py3-parcels
python -m ipykernel install --user --name py3-parcels --display-name "py3-parcels"
More information about how to format the data can be found in data/README.md
.
- Set up config files in
configs/
.- (More information on creating config files can be found in the config README)
- Choose config files in the
simulation_runner.ipynb
notebook for the OceanParcels simulation. This notebook outputs a new netcdf file with particle simulation data and creates a sequence of snapshots of particle movement stitch together into a gif.
Use the download_data.ipynb
notebook to save a specified region from some online source.
Use gapfilling.ipynb
to gapfill a netcdf file. Instructions are in the notebook.