Add VULCAN notebooks and files

paridhi-parajuli commented 3 weeks ago

VULCAN v4 is ingested in dev STAC.

[x] Prepare and add VULCAN verification report to ghgc-docs
[ ] Prepare and add collection json and discovery items for VULCAN to ghgc-data
[x] Add transformation notebook to ghgc-docs

paridhi-parajuli commented 3 weeks ago

Verification Report : https://docs.google.com/document/d/1fr6a2L3x19OqRGLvFGQj42EjsaxQzcNQ/edit

paridhi-parajuli commented 3 weeks ago

discovery-items json file :

{
    "collection": "vulcan-co2-yeargrid-v4",
    "bucket": "ghgc-data-store-develop",
    "prefix": "transformed_cogs/vulcan-co2-yeargrid-v4/",
    "filename_regex": ".*_CO2_USA_mosaic_grid_1km_mn_.*.tif$",
    "datetime_range": "year",
    "assets": {
        "total-co2":  {
            "title": "Total of all sectors CO₂ Emissions",
            "description": "Annual estimates of carbon dioxide (CO2) emissions from the combustion of fossil fuels (FF) and CO2 emissions from all sectors for the conterminous United States and the State.",
            "regex": ".*TOT_CO2_USA_mosaic_grid_1km_mn_.*.tif$"
        },
        "air-co2": {
            "title": "Total Airport CO₂ Emissions",
            "description": "Annual estimates of carbon dioxide (CO2) emissions from the combustion of fossil fuels (FF) and CO2 emissions from airport for the conterminous United States and the State",
            "regex": ".*AIR_CO2_USA_mosaic_grid_1km_mn_.*.tif$"
        },
        "cmt-co2": {
            "title": "Total Cement CO₂ Emissions",
            "description": "Annual estimates of carbon dioxide (CO2) emissions from the combustion of fossil fuels (FF) and CO2 emissions from cement production for the conterminous United States and the State",
            "regex": ".*CMT_CO2_USA_mosaic_grid_1km_mn_.*.tif$"
        },
        "cmv-co2": {
            "title": "Total Commercial Marine Vessels CO₂ Emissions",
            "description": "Annual estimates of carbon dioxide (CO2) emissions from the combustion of fossil fuels (FF) and CO2 emissions from commercial marine vessels for the conterminous United States and the State",
            "regex": ".*CMV_CO2_USA_mosaic_grid_1km_mn_.*.tif$"
        },
        "com-co2": {
            "title": "Total Commercial CO₂ Emissions",
            "description": "Annual estimates of carbon dioxide (CO2) emissions from the combustion of fossil fuels (FF) and CO2 emissions from commercial for the conterminous United States and the State",
            "regex": ".*COM_CO2_USA_mosaic_grid_1km_mn_.*.tif$"
        },
        "elc-co2": {
            "title": "Total Powerplants CO₂ Emissions",
            "description": "Annual estimates of carbon dioxide (CO2) emissions from the combustion of fossil fuels (FF) and CO2 emissions from powerplants for the conterminous United States and the State",
            "regex": ".*ELC_CO2_USA_mosaic_grid_1km_mn_.*.tif$"
        },
        "ind-co2": {
            "title": "Total Industrial CO₂ Emissions",
            "description": "Annual estimates of carbon dioxide (CO2) emissions from the combustion of fossil fuels (FF) and CO2 emissions from industrial for the conterminous United States and the State",
            "regex": ".*IND_CO2_USA_mosaic_grid_1km_mn_.*.tif$"
        },
        "nrd-co2": {
            "title": "Total Nonroad CO₂ Emissions",
            "description": "Annual estimates of carbon dioxide (CO2) emissions from the combustion of fossil fuels (FF) and CO2 emissions from nonroad for the conterminous United States and the State",
            "regex": ".*NRD_CO2_USA_mosaic_grid_1km_mn_.*.tif$"
        },
        "onr-co2": {
            "title": "Total Onroad CO₂ Emissions",
            "description": "Annual estimates of carbon dioxide (CO2) emissions from the combustion of fossil fuels (FF) and CO2 emissions from onroad for the conterminous United States and the State",
            "regex": ".*ONR_CO2_USA_mosaic_grid_1km_mn_.*.tif$"
        },
        "res-co2": {
            "title": "Total Residential CO₂ Emissions",
            "description": "Annual estimates of carbon dioxide (CO2) emissions from the combustion of fossil fuels (FF) and CO2 emissions from resedential for the conterminous United States and the State",
            "regex": ".*RES_CO2_USA_mosaic_grid_1km_mn_.*.tif$"
        },
        "rrd-co2": {
            "title": "Total Railroad CO₂ Emissions",
            "description": "Annual estimates of carbon dioxide (CO2) emissions from the combustion of fossil fuels (FF) and CO2 emissions from railroad for the conterminous United States and the State",
            "regex": ".*RRD_CO2_USA_mosaic_grid_1km_mn_.*.tif$"
        }
    },
    "id_regex": ".*_(.*).tif$",
    "id_template": "vulcan-co2-yeargrid-v4-{}"
}

@siddharth0248

paridhi-parajuli commented 3 weeks ago

collection JSON:

{
    "id": "vulcan-co2-yeargrid-v4",
    "type": "Collection",
    "links": [],
    "title": "Vulcan High-Resolution Annual Fossil Fuel CO2 Emissions in USA, 2010-2015, Version 4",
    "extent": {
        "spatial": {
            "bbox": [
                [
                    -128.22655,
                    47.89015278,
                    -65.30824167,
                    22.85824167
                ]
            ]
        },
        "temporal": {
            "interval": [
                [
                    "2011-01-01T00:00:00Z",
                    "2021-12-31T00:00:00Z"
                ]
            ]
        }
    },
    "license": "CC-BY-4.0",
    "providers": [
        {
            "url": "https://vulcan.rc.nau.edu/",
            "name": "North American Carbon Program",
            "roles": [
                "producer",
                "licensor"
            ]
        }
    ],
    "description": "Vulcan v4.0 is the first bottom-up inventory to report FFCO2 plus cement production CO2 fluxes at 1-km resolution for all major carbon-emitting sectors across the entire United States landscape. Vulcan v3.0 is constructed from numerous public datasets that generate the magnitude, spatial representation, and temporal representation of FFCO2 emissions.. The source dataset can be found at https://doi.org/10.3334/ORNLDAAC/1741",
    "item_assets": {
        "total-co2": {
            "type": "image/tiff; application=geotiff; profile=cloud-optimized",
            "roles": [
                "data",
                "layer"
            ],
            "title": "Total of all sectors CO₂ Emissions",
            "description": "Annual estimates of carbon dioxide (CO2) emissions from the combustion of fossil fuels (FF) and CO2 emissions from all sectors for the conterminous United States and the State"
        },
        "air-co2": {
            "type": "image/tiff; application=geotiff; profile=cloud-optimized",
            "roles": [
                "data",
                "layer"
            ],
            "title": "Total Airport CO₂ Emissions",
            "description": "Annual estimates of carbon dioxide (CO2) emissions from the combustion of fossil fuels (FF) and CO2 emissions from airport for the conterminous United States and the State"
        },
        "cmt-co2": {
            "type": "image/tiff; application=geotiff; profile=cloud-optimized",
            "roles": [
                "data",
                "layer"
            ],
            "title": "Total Cement CO₂ Emissions",
            "description": "Annual estimates of carbon dioxide (CO2) emissions from the combustion of fossil fuels (FF) and CO2 emissions from cement production for the conterminous United States and the State"
        },
        "cmv-co2": {
            "type": "image/tiff; application=geotiff; profile=cloud-optimized",
            "roles": [
                "data",
                "layer"
            ],
            "title": "Total Commercial Marine Vessels CO₂ Emissions",
            "description": "Annual estimates of carbon dioxide (CO2) emissions from the combustion of fossil fuels (FF) and CO2 emissions from commercial marine vessels for the conterminous United States and the State"
        },
        "com-co2": {
            "type": "image/tiff; application=geotiff; profile=cloud-optimized",
            "roles": [
                "data",
                "layer"
            ],
            "title": "Total Commercial CO₂ Emissions",
            "description": "Annual estimates of carbon dioxide (CO2) emissions from the combustion of fossil fuels (FF) and CO2 emissions from commercial for the conterminous United States and the State"
        },
        "elc-co2": {
            "type": "image/tiff; application=geotiff; profile=cloud-optimized",
            "roles": [
                "data",
                "layer"
            ],
            "title": "Total Powerplants CO₂ Emissions",
            "description": "Annual estimates of carbon dioxide (CO2) emissions from the combustion of fossil fuels (FF) and CO2 emissions from powerplants for the conterminous United States and the State"
        },
        "ind-co2": {
            "type": "image/tiff; application=geotiff; profile=cloud-optimized",
            "roles": [
                "data",
                "layer"
            ],
            "title": "Total Industrial CO₂ Emissions",
            "description": "Annual estimates of carbon dioxide (CO2) emissions from the combustion of fossil fuels (FF) and CO2 emissions from industrial for the conterminous United States and the State"
        },
        "nrd-co2": {
            "type": "image/tiff; application=geotiff; profile=cloud-optimized",
            "roles": [
                "data",
                "layer"
            ],
            "title": "Total Nonroad CO₂ Emissions",
            "description": "Annual estimates of carbon dioxide (CO2) emissions from the combustion of fossil fuels (FF) and CO2 emissions from nonroad for the conterminous United States and the State"
        },
        "onr-co2": {
            "type": "image/tiff; application=geotiff; profile=cloud-optimized",
            "roles": [
                "data",
                "layer"
            ],
            "title": "Total Onroad CO₂ Emissions",
            "description": "Annual estimates of carbon dioxide (CO2) emissions from the combustion of fossil fuels (FF) and CO2 emissions from onroad for the conterminous United States and the State"
        },
        "res-co2": {
            "type": "image/tiff; application=geotiff; profile=cloud-optimized",
            "roles": [
                "data",
                "layer"
            ],
            "title": "Total Residential CO₂ Emissions",
            "description": "Annual estimates of carbon dioxide (CO2) emissions from the combustion of fossil fuels (FF) and CO2 emissions from resedential for the conterminous United States and the State"
        },
        "rrd-co2": {
            "type": "image/tiff; application=geotiff; profile=cloud-optimized",
            "roles": [
                "data",
                "layer"
            ],
            "title": "Total Railroad CO₂ Emissions",
            "description": "Annual estimates of carbon dioxide (CO2) emissions from the combustion of fossil fuels (FF) and CO2 emissions from railroad for the conterminous United States and the State"
        }
    },
    "stac_version": "1.0.0",
    "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"
    ],
    "dashboard:is_periodic": true,
    "dashboard:time_density": "year",
    "renders": {
        "dashboard": {
            "assets": [
                "total-co2"
            ],
            "colormap_name": "magma",
            "rescale": [
                [
                    0,
                    1200
                ]
            ]
        },
        "total-co2": {
            "assets": [
                "total-co2"
            ],
            "colormap_name": "magma",
            "rescale": [
                [
                    0,
                    1200
                ]
            ]
        },
        "air-co2": {
            "assets": [
                "air-co2"
            ],
            "colormap_name": "magma",
            "rescale": [
                [
                    0,
                    1200
                ]
            ]
        },
        "cmt-co2": {
            "assets": [
                "cmt-co2"
            ],
            "colormap_name": "magma",
            "rescale": [
                [
                    0,
                    1200
                ]
            ]
        },
        "cmv-co2": {
            "assets": [
                "cmv-co2"
            ],
            "colormap_name": "magma",
            "rescale": [
                [
                    0,
                    1200
                ]
            ]
        },
        "com-co2": {
            "assets": [
                "com-co2"
            ],
            "colormap_name": "magma",
            "rescale": [
                [
                    0,
                    1200
                ]
            ]
        },
        "elc-co2": {
            "assets": [
                "elc-co2"
            ],
            "colormap_name": "magma",
            "rescale": [
                [
                    0,
                    1200
                ]
            ]
        },
        "ind-co2": {
            "assets": [
                "ind-co2"
            ],
            "colormap_name": "magma",
            "rescale": [
                [
                    0,
                    1200
                ]
            ]
        },
        "nrd-co2": {
            "assets": [
                "nrd-co2"
            ],
            "colormap_name": "magma",
            "rescale": [
                [
                    0,
                    1200
                ]
            ]
        },
        "onr-co2": {
            "assets": [
                "onr-co2"
            ],
            "colormap_name": "magma",
            "rescale": [
                [
                    0,
                    1200
                ]
            ]
        },
        "res-co2": {
            "assets": [
                "res-co2"
            ],
            "colormap_name": "magma",
            "rescale": [
                [
                    0,
                    1200
                ]
            ]
        },
        "rrd-co2": {
            "assets": [
                "rrd-co2"
            ],
            "colormap_name": "magma",
            "rescale": [
                [
                    0,
                    1200
                ]
            ]
        }
    }
}

@siddharth0248

slesaad commented 1 week ago

Pull request here: https://github.com/US-GHG-Center/ghgc-docs/pull/115

siddharth0248 commented 1 week ago

@fb0023 can you review the data usage notebook of VULCAN?

paridhi-parajuli commented 1 week ago

https://github.com/US-GHG-Center/ghgc-docs/pull/115 https://github.com/US-GHG-Center/ghgc-data/pull/47

US-GHG-Center / ghgc-docs

Add VULCAN notebooks and files #112