科研 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.
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
PyCO2SYSinstalled (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-climateskills, 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_typecodes 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) andsaturation_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, soOmega_Arcrosses 1 beforeOmega_Caas 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_fromarguments — 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和文石饱和度。
所属插件
安装该插件会一并获得同领域的 18 个 Skill / MCP。
同插件的其他科研 Skill
- OpenAQ空气质量分析Accesses OpenAQ air quality data (PM2.5, O3, NO2), runs spatial interpolation, health exposure indices, city comparisons. Use for air pollution monitoring and exposure analysis.
- Copernicus气候数据下载Downloads climate/weather data from the Copernicus Climate Data Store (ERA5, seasonal forecasts) via cdsapi, covering API setup and request splitting. Use for any CDS/ECMWF download.
- 气候趋势检验分析Runs climate trend analysis: Mann-Kendall test, Sen’s slope, extreme indices (RX1day, R10mm), percentile thresholds, IPCC-style figures. Use to detect and visualize climate trends.
- 生态多样性群落分析Computes community-ecology diversity metrics and ordination: Shannon/Simpson indices, rarefaction, NMDS/PCoA, PERMANOVA. Use when analyzing species-by-site community composition data.
- ERA5再分析气候数据Downloads and analyzes ERA5 reanalysis data via the Copernicus CDS API: anomalies, trends, publication-quality climate maps. Use for ERA5-specific climate analysis end to end.
- GBIF物种分布建模Queries GBIF occurrence records, applies spatial thinning, and fits species distribution models (MaxEnt, BRT) with pygbif/geopandas/elapid. Use for occurrence and habitat-suitability analysis.
- 综合地理空间科学分析Covers broad geospatial workflows: satellite imagery, vector/raster GIS, spatial ML, point clouds, cloud-native formats (STAC, COG). Use as a general entry point for remote sensing or GIS tasks.
- GeoPandas矢量GIS分析Performs vector GIS analysis with GeoPandas: spatial joins, overlays, buffer/dissolve, choropleth maps, rasterio integration. Use for vector spatial analysis and raster-vector workflows.
- DEM水文地貌分析Runs DEM-based hydrological analysis with pysheds: watershed delineation, flow direction/accumulation, stream networks, runoff estimation. Use for terrain-driven hydrology modeling.
- MetPy大气探空分析Performs atmospheric analysis with MetPy/Siphon: downloads NWP data, plots skew-T log-P diagrams, computes CAPE/CIN, builds synoptic composites. Use for weather-sounding meteorology analysis.
- 地震波形数据处理Analyzes seismological data with ObsPy: waveform download, filtering, P/S phase picking, moment magnitude, spectral analysis. Use for earthquake and seismic-waveform analysis.
- 海洋再分析数据分析Downloads and analyzes oceanographic data from Copernicus Marine Service and Argo floats with gsw/xarray: mixed layer depth, eddy kinetic energy, T-S diagrams. Use for physical oceanography.
- 物理海洋学论文绘图绘制物理海洋学论文图:区域/全球/极地地图、多面板、垂向剖面、Hovmöller图、cmocean配色与期刊版式。投稿级海洋学图件排版和配色时使用。
- 种群动态建模Models population dynamics with logistic/exponential growth, Lotka-Volterra, matrix population models, mark-recapture abundance estimation. Use for quantitative population ecology.
- QGIS自动化地理处理Drives QGIS (PyQGIS, processing, GDAL) for GIS/remote sensing tasks: raster/vector ops, spectral indices, reprojection, zonal statistics, map layouts. Use for any QGIS-based geospatial task.
- 多光谱遥感影像处理Reads, reprojects, and analyzes multispectral GeoTIFF imagery with rioxarray/rasterio: NDVI/EVI, cloud masking, mosaicking, Cloud-Optimized GeoTIFF export. Use for raster remote-sensing processing.
- Google Earth Engine卫星分析Runs Google Earth Engine satellite analysis with geemap/ee: NDVI time series, land-cover classification, change detection, GeoTIFF export. Use for cloud-based large-scale satellite analysis.
常见问题
海洋碳酸盐化学能做什么?
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 收录的每个版本都会记录内容摘要与权限声明,当前版本已通过安全审核。