Skip to content
Open
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
200 changes: 200 additions & 0 deletions ingestion-data/staging/dataset-config/ct-ch4-monthgrid-v2025.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,200 @@
{
"collection": "ct-ch4-monthgrid-v2025",
"title": "CarbonTracker-CH₄ Isotopic Methane Inverse Fluxes v2025",
"description": "Surface methane (CH₄) emissions are derived from atmospheric measurements of methane and its ¹³C carbon isotope content. Different sources of methane contain different ratios of the two stable isotopologues, ¹²CH₄ and ¹³CH₄. This makes normally indistinguishable collocated sources of methane, say from agriculture and oil and gas exploration, distinguishable. The National Oceanic and Atmospheric Administration (NOAA) collects whole air samples from its global cooperative network of flasks (https://gml.noaa.gov/ccgg/about.html), which are then analyzed for methane and other trace gases. A subset of those flasks are also analyzed for ¹³C of methane in collaboration with the Institute of Arctic and Alpine Research at the University of Colorado Boulder. Scientists at the National Aeronautics and Space Administration (NASA) and NOAA used those measurements of methane and ¹³C of methane in conjunction with a model of atmospheric circulation to estimate emissions of methane separated by three source types: microbial, fossil and pyrogenic. This dataset presents monthly methane emissions in units of grams of methane per square meter per year (g CH₄/m²/year) from microbial, fossil and pyrogenic sources, along with a layer of total methane emissions from all three sources combined, at 1° resolution from 1998 to 2023. The source data can be found at https://doi.org/10.25925/hxks-v755",

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

https://doi.org/10.25925/hxks-v755

should this be in links?

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I don't think so 😯

@jjfrench jjfrench Aug 20, 2026

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Here we have a "cite-as" link with the doi listed: https://stac.maap-project.org/collections/glad-global-forest-change-1.11 - it's not required, just an example (not all browser extensions interpret links in descriptions vs links in "links")

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think it should be persisted in the description in case any downstream systems previously expected it there. We could consider repeating the info in links and adding the https://stac-extensions.github.io/scientific/v1.0.0/schema.json extension to use as an example for new collections

Comment thread
jjfrench marked this conversation as resolved.
"license": "CC0-1.0",
"stac_version": "1.0.0",
"dashboard:is_periodic": true,
"dashboard:time_density": "month",
"spatial_extent": {
"xmin": -180,
"ymin": -90,
"xmax": 180,
"ymax": 90
},
"temporal_extent": {
"startdate": "1998-01-01T00:00:00Z",
"enddate": "2023-12-31T00:00:00Z"
Comment thread
jjfrench marked this conversation as resolved.
Outdated
},
"discovery_items": [
{
"discovery": "s3",
"prefix": "ct-ch4-monthgrid-v2025/",
"bucket": "ghgc-data-store",
"filename_regex": ".*methane_emis_.*.tif$",
"id_regex": ".*_(.*).tif$",
"id_template": "ct-ch4-monthgrid-v2025-{}",
"use_multithreading": false,
"assets": {
"fossil": {
"description": "Emission of methane from all fossil sources, such as oil and gas activities and coal mining.",
"regex": ".*methane_emis_fossil.*.tif$",
"title": "Fossil CH₄ Emission"
},
"microbial": {
"description": "Emission of methane from all microbial sources, such as wetlands, agriculture and termites.",
Comment thread
jjfrench marked this conversation as resolved.
Outdated
"regex": ".*methane_emis_microbial.*.tif$",
"title": "Microbial CH₄ Emission"
},
"pyrogenic": {
"description": "Emission of methane from all sources of biomass burning, such as wildfires and crop residue burning.",
"regex": ".*methane_emis_pyrogenic.*.tif$",
"title": "Pyrogenic CH₄ Emission"
},
"total": {
"description": "Total methane emission from microbial, fossil and pyrogenic sources.",
"regex": ".*methane_emis_total.*.tif$",
"title": "Total CH₄ Emission"
}
}
}
],
"sample_files": [
""
],
"data_type": "cog",
"stac_extensions": [
"https://stac-extensions.github.io/render/v1.0.0/schema.json",
"https://stac-extensions.github.io/item-assets/v1.0.0/schema.json"
],
"renders": {
"dashboard": {
"assets": [
"total"
],
"colormap_name": "purd",
"rescale": [
[
0,
50
]
]
},
"fossil": {
"assets": [
"fossil"
],
"colormap_name": "purd",
"rescale": [
[
0,
50
]
]
},
"microbial": {
"assets": [
"microbial"
],
"colormap_name": "purd",
"rescale": [
[
0,
30
]
]
},
"pyrogenic": {
"assets": [
"pyrogenic"
],
"colormap_name": "purd",
"rescale": [
[
0,
8
]
]
},
"total": {
"assets": [
"total"
],
"colormap_name": "purd",
"rescale": [
[
0,
50
]
]
}
},
"providers": [],
Comment thread
jjfrench marked this conversation as resolved.
"eic:tenant": "ghgc",
"item_assets": {
"cog_default": {
"type": "image/tiff; application=geotiff; profile=cloud-optimized",
"roles": [
"data",
"layer"
],
"title": "Default COG Layer",
"description": "Cloud optimized default layer to display on map"
},
"fossil": {
"type": "image/tiff; application=geotiff; profile=cloud-optimized",
"roles": [
"data",
"layer"
],
"title": "Fossil CH₄ Emission",
"description": "Emission of methane from all fossil sources, such as oil and gas activities and coal mining."
},
"microbial": {
"type": "image/tiff; application=geotiff; profile=cloud-optimized",
"roles": [
"data",
"layer"
],
"title": "Microbial CH₄ Emission",
"description": "Emission of methane from all microbial sources, such as wetlands, agriculture and termites."

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

"Emission of methane from all microbial sources, such as wetlands, ruminants, agriculture, and termites."

Question: what's the difference between the "discovery items" and "item assets"? Or I guess what's the purpose of each?

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

discovery_items is the configuration used to launch the dataset creation pipeline in airflow

item_assets should be provided in STAC collection metadata to describe each asset that a user can expect to find in every item of the collection (title, type, etc). It looks like this collection does not produce a cog_default item asset and it may be included here to work around some legacy schema enforcement that mistakenly required all collections to have a cog_default asset.

@botanical botanical Aug 20, 2026

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Question: what's the difference between the "discovery items" and "item assets"? Or I guess what's the purpose of each?

Great question, @smk0033 !

The difference is that discover items assets are used to find and assign files during an ingestion, whereas item assets is a STAC collection level metadata (part of the Item Assets extension) that indicates what assets consumers can expect on items for the collection.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ah sorry I didn't realize @anayeaye already answered!

},
"pyrogenic": {
"type": "image/tiff; application=geotiff; profile=cloud-optimized",
"roles": [
"data",
"layer"
],
"title": "Pyrogenic CH₄ Emission",
"description": "Emission of methane from all sources of biomass burning, such as wildfires and crop burning."
},
"total": {
"type": "image/tiff; application=geotiff; profile=cloud-optimized",
"roles": [
"data",
"layer"
],
"title": "Total CH₄ Emission",
"description": "Total methane emission from microbial, fossil and pyrogenic sources"
}
},
"datetime_range": "day",
"extent": {
"spatial": {
"bbox": [
[
180,
-180,
90,
-90
]
]
Comment thread
jjfrench marked this conversation as resolved.
},
"temporal": {
"interval": [
[
"1998-01-01T00:00:00Z",
"2023-12-31T00:00:00Z"
Comment thread
jjfrench marked this conversation as resolved.
Outdated
]
]
}
},
Comment thread
jjfrench marked this conversation as resolved.
"is_periodic": true,
"summaries": {
"datetime": [

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

"1998-01-01T00:00:00Z",
"2023-12-01T23:59:59Z"

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

thank you @smk0033 !
6b7e13b

"2001-01-01T00:00:00Z",
"2024-12-31T00:00:00Z"
Comment thread
jjfrench marked this conversation as resolved.
Outdated
]
},
"type": "Collection"
}
Loading