southern_ocean_eddy_subduction
Code used in Chen and Schofield (2024): "Spatial and Seasonal Controls on Eddy Subduction in the Southern Ocean"
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 1 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 (11.8%) to scientific vocabulary
Repository
Code used in Chen and Schofield (2024): "Spatial and Seasonal Controls on Eddy Subduction in the Southern Ocean"
Basic Info
Statistics
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
- Releases: 4
Metadata Files
README.md
Southern Ocean Eddy Subduction
Code used in Chen and Schofield (2024): "Spatial and Seasonal Controls on Eddy Subduction in the Southern Ocean"
- Data sources include:
- SOCCOM BGC-Argo floats
- Altimetry-derived Finite-size Lyapunov Exponents from AVISO+

Contents
Notebooks
- detection.ipynb
- figures.ipynb
#### Data
Minimal data files are included that allow you to generate figures
- SOCCOMGO-BGCLoResQCLIAR28Aug2023_netcdf
- fsles
#### Notebook outputs - outputs
a. ESP_anomalies.pkl
b. profile_summaries.pkl
c. ts_allprofiles.pkl - figures
a. Figures 1-4
b. Figures S1-S5
c. Example FSLE field used in Figure 1 - fsle_gif: still frames used to generate the GIF of FSLE fields shown here
Dependencies and data
- environment.yml
- orsi_park-durand_so_fronts_.nc
Description and usage
The figures.ipynb notebook can be run as-is with the minimal data contained in this repository. It can also be run in a no-install cloud environment on Binder. For more in-depth analysis and to recreate the primary analyses in the detections.ipynb notebook, you will need to clone this repo and download additional data.
Additional requirements
- Before running the detections.ipynb notebook, download the SOCCOM BGC-Argo float data from https://library.ucsd.edu/dc/collection/bb0488375t
- Download the 2023-08-28 Data snapshot. Format: LIAR carbon algorithm, netCDF, low resolution
- This download should be stored in the root directory in a folder named "SOCCOMGO-BGCLoResQCLIAR28Aug2023_netcdf"
detection.ipynb
This notebook contains the primary analyses of the raw float data, generating derived data products stored in outputs/
Derived variables include physical variables calculated using the Gibbs Seawater package (GSW)
For each float profile, it computes summary statistics, such as mixed layer depth, maximum buoyancy frequency, as well as scalar summaries of biogeochemical variables in that profile, such as integrated and depth-averaged quantities (ex: POC) within the mixed layer and beneath the mixed layer.
- These summary statistics for each profile are stored in a pandas dataframe: profile_summaries.pkl
- Additional analyses conducted on each profile and stored in this dataframe include:
- Spike analyses to detect the frequency of large particles sinking beneath the mixed layer. This is summarized in the dataframe for Navis floats only, which provide high-enough vertical resolution to conduct this analysis
- FSLE matchups: described further below. The mean and the strongest (most negative, or "minimum") altimetry-derived FSLEs within a 1°x1° area of the float profile
It stores all observed T/S quantities (for every observation in every float profile) in a pandas dataframe: ts_allprofiles.pkl
- This is used to generate TS diagrams later
This notebook contains the algorithm to detect eddy subduction anomalies in float profiles. Methods are described in Chen and Schofield (2024). Briefly, it identifies co-occuring anomalies in spice and apparent oxygen utilization (AOU) beneath the mixed layer.
- These anomalies, representing 4.4% of profiles, are stored in a pandas dataframe: ESP_anomalies.pkl
- This dataframe contains summary statistics for each subsurface eddy subduction pump (ESP) anomaly; including integrated quantities within the vertical extent of the anomaly, both total integrated quantities and with ambient integrated quantities subtracted (leaving only the integrated quantity attributable to subduction)
Additionally, the notebook runs an API through AVISO+ to download satellite altimetry-derived Finite-sive Lyapunov Exponent (FSLE) data
- It downloads a satellite matchup to each float profile, downloading a same-day FSLE field within a 1°x1° area
- This portion of the code takes about a day to run, as it submits individual queries for each float profile (~9000)
- It will store downloaded FSLE data (NetCDF) in a subdirectory: fsles/
- This downloaded data is then summarized and appended to the profile_summaries.pkl dataframe, providing an FSLE summary for each float profile
figures.ipynb
- This notebook runs secondary analyses on the outputs derived from detection.ipynb and stored in outputs/
- It additionally requires raw float data stored in SOCCOMGO-BGCLoResQCLIAR28Aug2023_netcdf/
- The maps require the ACC front locations stored in orsi_park-durand_so_fronts_.nc
Owner
- Name: Michael Chen
- Login: mchen96
- Kind: user
- Location: New Brunswick, NJ
- Company: Rutgers University
- Repositories: 1
- Profile: https://github.com/mchen96
Oceanographer at Rutgers University. Submesoscale physics and carbon export in the Southern Ocean.
Citation (CITATION.cff)
# This CITATION.cff file was generated with cffinit.
# Visit https://bit.ly/cffinit to generate yours today!
cff-version: 1.2.0
title: Southern Ocean Eddy Subduction
message: >-
If you use this software, please cite it using the
metadata from this file.
type: software
authors:
- given-names: Michael
family-names: Chen
email: mchen62442@gmail.com
affiliation: Rutgers University
orcid: 'https://orcid.org/0000-0002-3865-8436'
identifiers:
- type: doi
value: 10.5281/zenodo.10999662
description: Zenodo
repository-code: 'https://github.com/mchen96/southern_ocean_eddy_subduction'
abstract: >-
Code used in Chen and Schofield (2024): "Spatial and
Seasonal Controls on Eddy Subduction in the Southern
Ocean"
license: MIT
CodeMeta (codemeta.json)
{
"@context": "https://doi.org/10.5063/schema/codemeta-2.0",
"type": "SoftwareSourceCode",
"applicationCategory": "Oceanography",
"author": [
{
"id": "https://orcid.org/0000-0002-3865-8436",
"type": "Person",
"affiliation": {
"type": "Organization",
"name": "Department of Marine and Coastal Sciences, Rutgers University"
},
"email": "mchen62442@gmail.com",
"familyName": "Chen",
"givenName": "Michael"
}
],
"codeRepository": "https://github.com/mchen96/southern_ocean_eddy_subduction",
"dateCreated": "2024-04-22",
"dateModified": "2024-04-19",
"description": "Code used in Chen and Schofield (2024): \"Spatial and Seasonal Controls on Eddy Subduction in the Southern Ocean\"",
"funder": {
"type": "Organization",
"name": "NASA"
},
"keywords": [
"Carbon export",
"submesoscale dynamics",
"BGC-Argo",
"Finite-sive Lyapunov Exponents",
"Southern Ocean"
],
"license": "https://spdx.org/licenses/MIT",
"name": "Southern Ocean Eddy Subduction",
"operatingSystem": "macOS",
"programmingLanguage": "Python 3.8.17",
"version": "1.0.0",
"funding": "80NSSC22K1451"
}
GitHub Events
Total
Last Year
Dependencies
- cartopy 0.21.1.*
- gsw 3.6.17.*
- jupyterlab 3.6.3.*
- matplotlib 3.7.1.*
- motuclient 3.0.0.*
- numpy 1.24.3.*
- pandas 1.5.3.*
- python 3.8.17.*
- scikit-learn 1.2.2.*
- scipy 1.9.3.*
- seaborn 0.12.2.*
- tqdm 4.65.0.*
- xarray 2022.11.0.*