科研 Skill

海洋碳酸盐化学

marine-biogeochemistry-carbonate

Computes seawater carbonate chemistry with PyCO2SYS: pH, pCO2, aragonite/calcite saturation, air-sea CO2 flux. Use for ocean carbon-cycle and acidification analysis.

发布者 Codar安全审核通过v0.1.0更新于 2026-11-18

SKILL.md

Marine Biogeochemistry and Carbonate Chemistry

Purpose

Covers seawater carbonate-system calculations: computing the full set of carbonate parameters (pH, pCO2, total alkalinity, dissolved inorganic carbon, saturation states) from any two measured inputs, assessing ocean-acidification status, and estimating air-sea CO2 flux. The existing ocean-data skill covers physical oceanography (SST, salinity, mixed-layer depth, currents) via Copernicus Marine Service and Argo floats, but not seawater chemistry — carbonate system calculations need a dedicated, chemically correct toolkit (PyCO2SYS) rather than ad hoc formulas, since the underlying equilibrium equations are stiff and easy to get wrong by hand.

Use when a task involves ocean acidification, carbonate saturation state for calcifying organisms (corals, shellfish), air-sea CO2 exchange, or converting between measured carbonate-system parameters (e.g., going from pH + alkalinity to pCO2 and aragonite saturation).

When to Use

  • Converting between carbonate-system parameters: given any two of {DIC, total alkalinity, pH, pCO2/fCO2}, computing the rest.
  • Assessing ocean acidification: tracking pH or aragonite/calcite saturation state (Omega) trends over time or across a cruise transect.
  • Estimating air-sea CO2 flux from surface pCO2 and wind speed.
  • Evaluating whether a given seawater sample or model grid cell is under- or super-saturated with respect to calcium carbonate (relevant for coral reef, shellfish, or pteropod habitat suitability).

Prerequisites

  • PyCO2SYS installed (pip install PyCO2SYS) — the Python port of the widely used CO2SYS program, the field-standard tool for these calculations; do not hand-roll the equilibrium chemistry, since small errors in carbonic-acid dissociation constants or pH scale conventions produce materially wrong saturation states.
  • Measured or modeled input values for at least two carbonate-system parameters, plus temperature, salinity, and (for subsurface samples) pressure/depth — the equilibrium constants are strongly temperature- and salinity-dependent.
  • For air-sea flux, co-located wind speed and atmospheric CO2 mole fraction data (e.g., from ERA5 via the cds-download/era5-climate skills, and NOAA/GLOBALVIEW atmospheric CO2 records).

Workflow

1. State the pH scale and input pair explicitly

Carbonate chemistry software requires the pH scale used for any pH input/output to be specified (Total, Seawater, Free, or NBS scale) — mixing scales is a classic source of errors of several hundredths of a pH unit, which is large relative to typical ocean-acidification signal sizes (~0.1 pH unit of change over decades is a major finding). Report the scale alongside every pH value.

2. Run a basic carbonate-system calculation

import PyCO2SYS as pyco2

result = pyco2.sys(
    par1=2300, par1_type=1,     # total alkalinity (umol/kg), type 1
    par2=8.1, par2_type=3,      # pH (type 3 = pH on chosen scale)
    salinity=35, temperature=20, pressure=0,
    opt_pH_scale=1,             # 1 = Total scale (recommended default)
    opt_k_carbonic=10,          # dissociation-constant set, e.g. Lueker et al. 2000
)

print(result["pCO2"], result["saturation_aragonite"], result["saturation_calcite"])
  • par1_type/par2_type codes follow the CO2SYS convention (1 = total alkalinity, 2 = DIC, 3 = pH, 4 = pCO2, 5 = fCO2, 6 = carbonate ion, 8 = bicarbonate); always confirm the input types match the actual measured quantities.
  • The choice of carbonic-acid dissociation-constant set (opt_k_carbonic) materially affects results, especially at low salinity or unusual temperature ranges; Lueker et al. (2000) or Mehrbach et al. (1973) refit by Dickson & Millero (1987) are common open-ocean defaults — state which set was used, since it is a standard methods-section disclosure in carbonate chemistry papers.

3. Compute saturation state and interpret it

  • saturation_aragonite (Omega_Ar) and saturation_calcite (Omega_Ca) above 1 indicate the water is supersaturated (favorable for calcification); below 1, undersaturated (corrosive to unprotected carbonate shells/skeletons). Aragonite is more soluble than calcite, so Omega_Ar crosses 1 before Omega_Ca as waters acidify — report both, but lead with aragonite for biological-impact framing since many vulnerable calcifiers (pteropods, coral) build aragonite skeletons.
  • Report saturation state alongside depth/pressure for subsurface samples — the saturation horizon (depth where Omega_Ar = 1) is itself a commonly reported oceanographic quantity, and is shoaling (moving closer to the surface) in many ocean basins due to acidification.

4. Estimate air-sea CO2 flux

# Flux (positive = ocean uptake) via a standard bulk formula:
# F = k * K0 * (pCO2_atm - pCO2_sw)
# where k = gas transfer velocity (wind-speed dependent, e.g. Wanninkhof 2014),
#       K0 = CO2 solubility (temperature/salinity dependent, from PyCO2SYS or
#            a solubility parameterization)
import numpy as np

def gas_transfer_velocity_w14(wind_speed_10m, schmidt_number):
    # Wanninkhof (2014) quadratic parameterization, cm/hr -> convert as needed
    return 0.251 * wind_speed_10m**2 * (schmidt_number / 660) ** -0.5
  • Use a published gas-transfer-velocity parameterization (Wanninkhof 2014 is a common current choice) rather than an arbitrary constant; state which parameterization and wind-speed product (satellite scatterometer, reanalysis) were used, since flux estimates are sensitive to this choice.
  • Report flux sign convention explicitly (positive = into the ocean, or positive = out of the ocean) — conventions differ across papers and this is a frequent source of confusion when comparing results.

5. Propagate and report uncertainty

  • PyCO2SYS can propagate input uncertainties (measurement precision of alkalinity/DIC/pH, plus uncertainty in dissociation constants) into output uncertainty via its uncertainty_into / uncertainty_from arguments — use this rather than reporting a bare point estimate for saturation state or pCO2 in a publication-quality analysis.
  • State measurement precision for the two input parameters used (typical shipboard precision: total alkalinity ~±2 umol/kg by titration, pH ~±0.002-0.02 depending on method) since this bounds how precisely derived quantities like Omega can be known.

Limitations

  • Requires PyCO2SYS (or equivalent CO2SYS implementations in MATLAB/R); this skill does not reimplement the underlying equilibrium chemistry and should not be used to hand-derive carbonate parameters from first principles for a real dataset.
  • Dissociation-constant choice and pH-scale handling are consequential and sometimes the biggest source of disagreement between studies; always report both explicitly rather than relying on software defaults silently.
  • Air-sea flux estimates depend strongly on the chosen gas-transfer velocity parameterization and the spatial/temporal resolution of wind data; basin-scale or global flux budgets typically need dedicated, validated products (e.g., SOCAT-based pCO2 climatologies) rather than ad hoc single-parameterization estimates.
  • Does not cover biological carbon-cycle modeling (primary production, export flux, biogeochemical ecosystem models) — this skill is limited to the inorganic carbonate system.

Quality Checklist

  • pH scale stated for every pH input/output.
  • Dissociation-constant set (opt_k_carbonic) and input parameter types documented.
  • Saturation state reported with depth/pressure context; aragonite and calcite both reported when relevant to the question.
  • Air-sea flux sign convention and gas-transfer-velocity parameterization stated explicitly.
  • Output uncertainty propagated from input measurement precision where the analysis is reported quantitatively (not just a point estimate).

示例提示词

帮我用PyCO2SYS算这份海水样品的pH、pCO2和文石饱和度。

所属插件

地球与环境科学面向地学、大气、海洋与生态研究:ERA5/CDS 气象数据、气候趋势、遥感与 GIS、水文、地震、空气质量、生物多样性与海洋绘图。

安装该插件会一并获得同领域的 18 个 Skill / MCP。

同插件的其他科研 Skill

常见问题

海洋碳酸盐化学能做什么?

Computes seawater carbonate chemistry with PyCO2SYS: pH, pCO2, aragonite/calcite saturation, air-sea CO2 flux. Use for ocean carbon-cycle and acidification analysis。

如何安装海洋碳酸盐化学?

在科搭 Codar 左侧点击「插件」,在「组件」页签搜索「海洋碳酸盐化学」并安装;在 Claude Code 或 Codex 中可以发送本页的安装提示词,或下载 Skill 包后解压到 ~/.claude/skills 或 ~/.codex/skills。

海洋碳酸盐化学需要哪些权限?

该科研 Skill没有声明额外权限;执行具体操作时仍由 Agent 按自身规则请求确认。

海洋碳酸盐化学经过官方审核吗?

是。SpeedSkills 收录的每个版本都会记录内容摘要与权限声明,当前版本已通过安全审核。