southern_ocean_eddy_subduction

Code used in Chen and Schofield (2024): "Spatial and Seasonal Controls on Eddy Subduction in the Southern Ocean"

https://github.com/mchen96/southern_ocean_eddy_subduction

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
Last synced: 6 months ago · JSON representation ·

Repository

Code used in Chen and Schofield (2024): "Spatial and Seasonal Controls on Eddy Subduction in the Southern Ocean"

Basic Info
  • Host: GitHub
  • Owner: mchen96
  • License: mit
  • Language: Jupyter Notebook
  • Default Branch: main
  • Homepage:
  • Size: 64.6 MB
Statistics
  • Stars: 1
  • Watchers: 1
  • Forks: 0
  • Open Issues: 0
  • Releases: 4
Created almost 2 years ago · Last pushed over 1 year ago
Metadata Files
Readme License Citation Codemeta

README.md

Southern Ocean Eddy Subduction

DOI

Binder

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

  1. detection.ipynb
  2. figures.ipynb #### Data Minimal data files are included that allow you to generate figures
  3. SOCCOMGO-BGCLoResQCLIAR28Aug2023_netcdf
  4. fsles
    #### Notebook outputs
  5. outputs
    a. ESP_anomalies.pkl
    b. profile_summaries.pkl
    c. ts_allprofiles.pkl
  6. figures
    a. Figures 1-4
    b. Figures S1-S5
    c. Example FSLE field used in Figure 1
  7. fsle_gif: still frames used to generate the GIF of FSLE fields shown here

Dependencies and data

  1. environment.yml
  2. 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

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

environment.yml conda
  • 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.*