ICOS carbon and greenhouse-gas observations
ICOS atmosphere, ocean and ecosystem greenhouse-gas observations, with citation and DOI per answer
¿Debería usar esto?
Calidad y seguridad
A
Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.
Costo de contexto
~6,809Tokens (definiciones de herramientas)
~8.9 KBTamaño de respuesta típico
Impacto significativo en la atención (5.32% del contexto de 128k)
Este es el número aproximado de tokens que se consumen cada vez que las herramientas del servidor se cargan en el contexto de un modelo. Los recuentos más altos reducen la atención disponible para otras tareas.
Instalar
Instalación con un clic
Agrega esto a tu archivo `claude_desktop_config.json`:
{
"mcpServers": {
"icos": {
"url": "https://mcp.icos-cp.eu/mcp"
}
}
}Puntos de conexión remotos
https://mcp.icos-cp.eu/mcpstreamable-httpQué puede hacer
Inventario de herramientas
Herramientas (8)
🟢 Solo lectura🟡 Escritura🔴 Eliminación⚪ Desconocido
🟢list_datasets
List the ICOS datasets: one per data store, with domain (atmosphere, ocean, ecosystem), time and space coverage, licence and DOI.
Esquema de entrada
{
"type": "object",
"properties": {},
"title": "list_datasetsArguments"
}Esquema de salida
{
"type": "object",
"properties": {
"datasets": {
"items": {
"$ref": "#/$defs/Dataset"
},
"title": "Datasets",
"type": "array"
}
},
"required": [
"datasets"
],
"$defs": {
"Dataset": {
"properties": {
"store": {
"title": "Store",
"type": "string"
},
"title": {
"title": "Title",
"type": "string"
},
"domain": {
"title": "Domain",
"type": "string"
},
"summary": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Summary"
},
"time_coverage_start": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Time Coverage Start"
},
"time_coverage_end": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Time Coverage End"
},
"lat_min": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Lat Min"
},
"lat_max": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Lat Max"
},
"lon_min": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Lon Min"
},
"lon_max": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Lon Max"
},
"license": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "License"
},
"doi": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Doi"
},
"n_variables": {
"description": "variables queryable through estimate and get_data; 0 means the store is read with xarray only (see its agent guide)",
"title": "N Variables",
"type": "integer"
},
"agent_guide_url": {
"title": "Agent Guide Url",
"type": "string"
},
"croissant_url": {
"title": "Croissant Url",
"type": "string"
}
},
"required": [
"store",
"title",
"domain",
"n_variables",
"agent_guide_url",
"croissant_url"
],
"title": "Dataset",
"type": "object"
}
},
"title": "Datasets"
}🟢search_variables(text, domain, store, limit)
Find variable ids in the ICOS catalogue by name, quantity or unit. The ids are what estimate and get_data take. Primary measurements come before their companions (standard deviation, value counts, flags).
Esquema de entrada
{
"type": "object",
"properties": {
"text": {
"description": "what to look for: a gas, a quantity or a name, e.g. 'co2', 'methane', 'net ecosystem exchange', 'fCO2'",
"title": "Text",
"type": "string"
},
"domain": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "atmosphere, ocean or ecosystem",
"title": "Domain"
},
"store": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "limit to one store, e.g. icos-obspack.zarr",
"title": "Store"
},
"limit": {
"default": 15,
"maximum": 50,
"minimum": 1,
"title": "Limit",
"type": "integer"
}
},
"required": [
"text"
],
"title": "search_variablesArguments"
}Esquema de salida
{
"type": "object",
"properties": {
"variables": {
"items": {
"$ref": "#/$defs/Variable"
},
"title": "Variables",
"type": "array"
},
"n_matches": {
"title": "N Matches",
"type": "integer"
}
},
"required": [
"variables",
"n_matches"
],
"$defs": {
"Variable": {
"properties": {
"id": {
"title": "Id",
"type": "string"
},
"name": {
"title": "Name",
"type": "string"
},
"long_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Long Name"
},
"unit": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Unit"
},
"domain": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Domain"
},
"store": {
"title": "Store",
"type": "string"
},
"query_kind": {
"description": "station_time (series at stations), obs_table (ship/cruise observations) or grid (gridded product)",
"title": "Query Kind",
"type": "string"
},
"quality_flag": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Quality Flag"
},
"vocabulary_uri": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Vocabulary Uri"
},
"access": {
"default": "query",
"description": "query: estimate/get_data/aggregate serve it; zarr: a multi-dimensional variable (e.g. the ONEFlux NEE cube) read with xarray -- see zarr_recipe, and `prescribed` for its /query slice",
"enum": [
"query",
"zarr"
],
"title": "Access",
"type": "string"
},
"axes": {
"anyOf": [
{
"additionalProperties": {
"items": {
"type": "string"
},
"type": "array"
},
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"description": "zarr variables: each extra axis and its labels",
"title": "Axes"
},
"prescribed": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "zarr variables: the id of the preferred slice /query serves",
"title": "Prescribed"
},
"zarr_recipe": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Zarr Recipe"
}
},
"required": [
"id",
"name",
"store",
"query_kind"
],
"title": "Variable",
"type": "object"
}
},
"title": "Variables"
}🟢describe_variable(id)
One variable in full: names, unit, which dataset, its coverage, how its quality flag is read, licence and DOI. For a multi-dimensional variable read through zarr (access 'zarr'), its axes with their labels, the slice /query serves (prescribed) and an xarray line for any other slice.
Esquema de entrada
{
"type": "object",
"properties": {
"id": {
"description": "a variable id from search_variables",
"title": "Id",
"type": "string"
}
},
"required": [
"id"
],
"title": "describe_variableArguments"
}Esquema de salida
{
"type": "object",
"properties": {
"id": {
"title": "Id",
"type": "string"
},
"name": {
"title": "Name",
"type": "string"
},
"long_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Long Name"
},
"unit": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Unit"
},
"domain": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Domain"
},
"store": {
"title": "Store",
"type": "string"
},
"query_kind": {
"description": "station_time (series at stations), obs_table (ship/cruise observations) or grid (gridded product)",
"title": "Query Kind",
"type": "string"
},
"quality_flag": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Quality Flag"
},
"vocabulary_uri": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Vocabulary Uri"
},
"access": {
"default": "query",
"description": "query: estimate/get_data/aggregate serve it; zarr: a multi-dimensional variable (e.g. the ONEFlux NEE cube) read with xarray -- see zarr_recipe, and `prescribed` for its /query slice",
"enum": [
"query",
"zarr"
],
"title": "Access",
"type": "string"
},
"axes": {
"anyOf": [
{
"additionalProperties": {
"items": {
"type": "string"
},
"type": "array"
},
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"description": "zarr variables: each extra axis and its labels",
"title": "Axes"
},
"prescribed": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "zarr variables: the id of the preferred slice /query serves",
"title": "Prescribed"
},
"zarr_recipe": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Zarr Recipe"
},
"dataset_title": {
"title": "Dataset Title",
"type": "string"
},
"time_coverage_start": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Time Coverage Start"
},
"time_coverage_end": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Time Coverage End"
},
"quality_control": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "how the store's QC flag is read; apply_qc=true applies the recommended rule",
"title": "Quality Control"
},
"license": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "License"
},
"doi": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Doi"
},
"variants": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "the multi-dimensional variables this one is the PRESCRIBED slice of; their other slices are read through zarr (describe_variable on one gives the recipe)",
"title": "Variants"
}
},
"required": [
"id",
"name",
"store",
"query_kind",
"dataset_title"
],
"title": "VariableDetail"
}🟢estimate(id, lat_min, lat_max, lon_min, lon_max, ...)
How big a selection is -- rows, stations, time span -- without fetching it. Call this before get_data.
Esquema de entrada
{
"type": "object",
"properties": {
"id": {
"description": "a variable id from search_variables",
"title": "Id",
"type": "string"
},
"lat_min": {
"anyOf": [
{
"maximum": 90,
"minimum": -90,
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Lat Min"
},
"lat_max": {
"anyOf": [
{
"maximum": 90,
"minimum": -90,
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Lat Max"
},
"lon_min": {
"anyOf": [
{
"maximum": 180,
"minimum": -180,
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Lon Min"
},
"lon_max": {
"anyOf": [
{
"maximum": 180,
"minimum": -180,
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Lon Max"
},
"start": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "ISO date or datetime, inclusive (2025-01-01)",
"title": "Start"
},
"end": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "ISO date or datetime, EXCLUSIVE",
"title": "End"
},
"station": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "station ids -- a list, or one id (or several, comma-separated) as a string; CASE-SENSITIVE: HTM150 (trigram + sampling height) for atmosphere, SE-Htm for FLUXNET sites",
"title": "Station"
},
"cruise": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "cruise expocodes, a list or a string; ocean observation tables only",
"title": "Cruise"
},
"height_min": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Height Min"
},
"height_max": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Height Max"
},
"apply_qc": {
"default": true,
"description": "DEFAULT TRUE: drop the observations the store's recommended quality control rejects; false keeps every observation, flagged ones included",
"title": "Apply Qc",
"type": "boolean"
}
},
"required": [
"id"
],
"title": "estimateArguments"
}Esquema de salida
{
"type": "object",
"properties": {
"id": {
"title": "Id",
"type": "string"
},
"rows": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "rows the selection holds; None when only an upper bound is known",
"title": "Rows"
},
"rows_at_most": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Rows At Most"
},
"exact": {
"title": "Exact",
"type": "boolean"
},
"n_stations": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "N Stations"
},
"est_bytes": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Est Bytes"
},
"time_min": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Time Min"
},
"time_max": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Time Max"
},
"note": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Note"
}
},
"required": [
"id",
"rows",
"exact"
],
"title": "Estimate"
}🟢get_data(id, lat_min, lat_max, lon_min, lon_max, ...)
Observations for one variable, filtered by box, time, station, cruise, height and quality control. Returns at most max_rows rows as a table, the total, a download URL for the whole selection, and the citation the user must be given with any use of the data.
Esquema de entrada
{
"type": "object",
"properties": {
"id": {
"description": "a variable id from search_variables",
"title": "Id",
"type": "string"
},
"lat_min": {
"anyOf": [
{
"maximum": 90,
"minimum": -90,
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Lat Min"
},
"lat_max": {
"anyOf": [
{
"maximum": 90,
"minimum": -90,
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Lat Max"
},
"lon_min": {
"anyOf": [
{
"maximum": 180,
"minimum": -180,
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Lon Min"
},
"lon_max": {
"anyOf": [
{
"maximum": 180,
"minimum": -180,
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Lon Max"
},
"start": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "ISO date or datetime, inclusive (2025-01-01)",
"title": "Start"
},
"end": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "ISO date or datetime, EXCLUSIVE",
"title": "End"
},
"station": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "station ids -- a list, or one id (or several, comma-separated) as a string; CASE-SENSITIVE: HTM150 (trigram + sampling height) for atmosphere, SE-Htm for FLUXNET sites",
"title": "Station"
},
"cruise": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "cruise expocodes, a list or a string; ocean observation tables only",
"title": "Cruise"
},
"height_min": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Height Min"
},
"height_max": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Height Max"
},
"apply_qc": {
"default": true,
"description": "DEFAULT TRUE: drop the observations the store's recommended quality control rejects; false keeps every observation, flagged ones included",
"title": "Apply Qc",
"type": "boolean"
},
"max_rows": {
"default": 100,
"description": "rows to return; the whole selection is at download_url",
"maximum": 2000,
"minimum": 1,
"title": "Max Rows",
"type": "integer"
}
},
"required": [
"id"
],
"title": "get_dataArguments"
}Esquema de salida
{
"type": "object",
"properties": {
"id": {
"title": "Id",
"type": "string"
},
"columns": {
"items": {
"type": "string"
},
"title": "Columns",
"type": "array"
},
"rows": {
"items": {
"items": {},
"type": "array"
},
"title": "Rows",
"type": "array"
},
"rows_returned": {
"title": "Rows Returned",
"type": "integer"
},
"rows_total": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "rows in the whole selection, when known",
"title": "Rows Total"
},
"truncated": {
"title": "Truncated",
"type": "boolean"
},
"download_url": {
"description": "the selection as CSV when it fits one download; when it does not, the FIRST of download_urls",
"title": "Download Url",
"type": "string"
},
"download_urls": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "when the selection is larger than one download (the proxy caps an answer at 500,000 rows): one CSV link per time window, together the WHOLE selection -- give the user all of them",
"title": "Download Urls"
},
"download_complete": {
"default": true,
"description": "false when no set of links could be planned to cover the whole selection; the note says what is missing",
"title": "Download Complete",
"type": "boolean"
},
"note": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Note"
},
"citation": {
"$ref": "#/$defs/Citation"
}
},
"required": [
"id",
"columns",
"rows",
"rows_returned",
"rows_total",
"truncated",
"download_url",
"citation"
],
"$defs": {
"Citation": {
"description": "In data answers the author list is shortened (first author et al.);\nget_citation gives the full citation.",
"properties": {
"citation": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Citation"
},
"license": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "License"
},
"license_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "License Url"
},
"doi": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Doi"
},
"selection_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "stable id of this exact selection over this exact store version",
"title": "Selection Id"
},
"store_version": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Store Version"
},
"n_sources": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "how many data objects the selection came from; in a data answer their citations are listed only when there are three or fewer -- get_citation (with the same stations) lists them all",
"title": "N Sources"
},
"sources": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "the citation of each data object the selection came from -- what to cite when there is no collection citation (near-real-time data)",
"title": "Sources"
}
},
"title": "Citation",
"type": "object"
}
},
"title": "Data"
}🟢get_citation(id, station, start, end, lat_min, ...)
How to cite a variable's data: the citation text, licence and DOI from its data passport, and -- for a selection (stations, a time window, a box) -- every data object it came from, in full. Data answers carry a short citation and only the COUNT of their sources; this lists them.
Esquema de entrada
{
"type": "object",
"properties": {
"id": {
"description": "a variable id from search_variables",
"title": "Id",
"type": "string"
},
"station": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "station ids -- a list, or one id (or several, comma-separated) as a string; CASE-SENSITIVE: HTM150 (trigram + sampling height) for atmosphere, SE-Htm for FLUXNET sites",
"title": "Station"
},
"start": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "ISO date or datetime, inclusive (2025-01-01)",
"title": "Start"
},
"end": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "ISO date or datetime, EXCLUSIVE",
"title": "End"
},
"lat_min": {
"anyOf": [
{
"maximum": 90,
"minimum": -90,
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Lat Min"
},
"lat_max": {
"anyOf": [
{
"maximum": 90,
"minimum": -90,
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Lat Max"
},
"lon_min": {
"anyOf": [
{
"maximum": 180,
"minimum": -180,
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Lon Min"
},
"lon_max": {
"anyOf": [
{
"maximum": 180,
"minimum": -180,
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Lon Max"
}
},
"required": [
"id"
],
"title": "get_citationArguments"
}Esquema de salida
{
"type": "object",
"properties": {
"citation": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Citation"
},
"license": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "License"
},
"license_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "License Url"
},
"doi": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Doi"
},
"selection_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "stable id of this exact selection over this exact store version",
"title": "Selection Id"
},
"store_version": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Store Version"
},
"n_sources": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "how many data objects the selection came from; in a data answer their citations are listed only when there are three or fewer -- get_citation (with the same stations) lists them all",
"title": "N Sources"
},
"sources": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "the citation of each data object the selection came from -- what to cite when there is no collection citation (near-real-time data)",
"title": "Sources"
}
},
"description": "In data answers the author list is shortened (first author et al.);\nget_citation gives the full citation.",
"title": "Citation"
}🟢aggregate(id, by, lat_min, lat_max, lon_min, ...)
Statistics over a WHOLE selection, computed on the server: count, mean, min, max, sum and standard deviation of one variable, overall or per station, year, month or day. Use this for any average, total, range or trend instead of reading rows. Any size: a selection over 500,000 rows is split by time on the server and merged exactly. `std` is the POPULATION standard deviation (ddof 0). `sum` adds the values as stored, which is a total only for values that are themselves totals per row: summing a RATE (umol m-2 s-1 per half-hour, gC m-2 d-1 per day) or a concentration gives no physical quantity -- for a flux total multiply the mean by the period.
Esquema de entrada
{
"type": "object",
"properties": {
"id": {
"description": "a variable id from search_variables",
"title": "Id",
"type": "string"
},
"by": {
"default": "none",
"description": "the groups: none (one result), station, a period, or both",
"enum": [
"none",
"station",
"year",
"month",
"day",
"station_year",
"station_month"
],
"title": "By",
"type": "string"
},
"lat_min": {
"anyOf": [
{
"maximum": 90,
"minimum": -90,
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Lat Min"
},
"lat_max": {
"anyOf": [
{
"maximum": 90,
"minimum": -90,
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Lat Max"
},
"lon_min": {
"anyOf": [
{
"maximum": 180,
"minimum": -180,
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Lon Min"
},
"lon_max": {
"anyOf": [
{
"maximum": 180,
"minimum": -180,
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Lon Max"
},
"start": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "ISO date or datetime, inclusive (2025-01-01)",
"title": "Start"
},
"end": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "ISO date or datetime, EXCLUSIVE",
"title": "End"
},
"station": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "station ids -- a list, or one id (or several, comma-separated) as a string; CASE-SENSITIVE: HTM150 (trigram + sampling height) for atmosphere, SE-Htm for FLUXNET sites",
"title": "Station"
},
"cruise": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "cruise expocodes, a list or a string; ocean observation tables only",
"title": "Cruise"
},
"height_min": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Height Min"
},
"height_max": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Height Max"
},
"apply_qc": {
"default": true,
"description": "DEFAULT TRUE: drop the observations the store's recommended quality control rejects; false keeps every observation, flagged ones included",
"title": "Apply Qc",
"type": "boolean"
}
},
"required": [
"id"
],
"title": "aggregateArguments"
}Esquema de salida
{
"type": "object",
"properties": {
"id": {
"title": "Id",
"type": "string"
},
"variable": {
"title": "Variable",
"type": "string"
},
"unit": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Unit"
},
"by": {
"title": "By",
"type": "string"
},
"groups": {
"description": "one entry per group: its keys (station, period), n (finite values), and mean, min, max, sum, std over them (null when n is 0)",
"items": {
"additionalProperties": true,
"type": "object"
},
"title": "Groups",
"type": "array"
},
"n_groups": {
"title": "N Groups",
"type": "integer"
},
"rows_used": {
"title": "Rows Used",
"type": "integer"
},
"note": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Note"
},
"download_url": {
"title": "Download Url",
"type": "string"
},
"download_urls": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"title": "Download Urls"
},
"download_complete": {
"default": true,
"title": "Download Complete",
"type": "boolean"
},
"citation": {
"$ref": "#/$defs/Citation"
}
},
"required": [
"id",
"variable",
"by",
"groups",
"n_groups",
"rows_used",
"download_url",
"citation"
],
"$defs": {
"Citation": {
"description": "In data answers the author list is shortened (first author et al.);\nget_citation gives the full citation.",
"properties": {
"citation": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Citation"
},
"license": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "License"
},
"license_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "License Url"
},
"doi": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Doi"
},
"selection_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "stable id of this exact selection over this exact store version",
"title": "Selection Id"
},
"store_version": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Store Version"
},
"n_sources": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "how many data objects the selection came from; in a data answer their citations are listed only when there are three or fewer -- get_citation (with the same stations) lists them all",
"title": "N Sources"
},
"sources": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "the citation of each data object the selection came from -- what to cite when there is no collection citation (near-real-time data)",
"title": "Sources"
}
},
"title": "Citation",
"type": "object"
}
},
"title": "Aggregate"
}🟢find_stations(id, near_lat, near_lon, radius_km, lat_min, ...)
The stations that carry a variable: id, name, position, sampling height, country, ecosystem -- near a point (sorted by distance), in a box, by name or by country. The ids are what estimate and get_data take as station=.
Esquema de entrada
{
"type": "object",
"properties": {
"id": {
"description": "a station-based variable id from search_variables",
"title": "Id",
"type": "string"
},
"near_lat": {
"anyOf": [
{
"maximum": 90,
"minimum": -90,
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"description": "search around this point, with near_lon and radius_km",
"title": "Near Lat"
},
"near_lon": {
"anyOf": [
{
"maximum": 180,
"minimum": -180,
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Near Lon"
},
"radius_km": {
"default": 300,
"exclusiveMinimum": 0,
"maximum": 20000,
"title": "Radius Km",
"type": "number"
},
"lat_min": {
"anyOf": [
{
"maximum": 90,
"minimum": -90,
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Lat Min"
},
"lat_max": {
"anyOf": [
{
"maximum": 90,
"minimum": -90,
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Lat Max"
},
"lon_min": {
"anyOf": [
{
"maximum": 180,
"minimum": -180,
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Lon Min"
},
"lon_max": {
"anyOf": [
{
"maximum": 180,
"minimum": -180,
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Lon Max"
},
"text": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "part of a station's id or name, e.g. 'Hyltemossa', 'HTM', 'Hyy'",
"title": "Text"
},
"country": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "two-letter code, e.g. SE",
"title": "Country"
},
"limit": {
"default": 50,
"maximum": 200,
"minimum": 1,
"title": "Limit",
"type": "integer"
}
},
"required": [
"id"
],
"title": "find_stationsArguments"
}Esquema de salida
{
"type": "object",
"properties": {
"variable": {
"title": "Variable",
"type": "string"
},
"stations": {
"items": {
"$ref": "#/$defs/Station"
},
"title": "Stations",
"type": "array"
},
"n_matches": {
"title": "N Matches",
"type": "integer"
}
},
"required": [
"variable",
"stations",
"n_matches"
],
"$defs": {
"Station": {
"properties": {
"id": {
"description": "the id station= takes, case-sensitive",
"title": "Id",
"type": "string"
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Name"
},
"latitude": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Latitude"
},
"longitude": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Longitude"
},
"elevation": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Elevation"
},
"sampling_height": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"description": "intake height above ground, m (atmosphere)",
"title": "Sampling Height"
},
"country": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Country"
},
"ecosystem": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Ecosystem"
},
"url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Url"
},
"distance_km": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Distance Km"
}
},
"required": [
"id"
],
"title": "Station",
"type": "object"
}
},
"title": "StationList"
}Comunidad
Evidencia
Observaciones recientes
verificadoversión no registrada8 herramientas