diff --git a/.nojekyll b/.nojekyll index 0bb5747..2bfa3dc 100644 --- a/.nojekyll +++ b/.nojekyll @@ -1 +1 @@ -ef86faec \ No newline at end of file +0d1db883 \ No newline at end of file diff --git a/search.json b/search.json index 1bf2880..aa4ff5a 100644 --- a/search.json +++ b/search.json @@ -853,7 +853,7 @@ "href": "sections/us-ghg-center-and-veda/catalog-interaction.html", "title": "Accessing and using the US GHG Center Data Catalog", "section": "", - "text": "The US GHG Center uses a Spatio-Temporal Asset Catalog (STAC) to catalog it listing of datasets. This tutorial teaches the basics of searching and accessing datasets using the US GHG Center STAC catalog.\n\n\n\nUse the pystac_client library to connect to the data catalog\nList all the collections from the catalog\nLook at the items in one of the collections\nAccess an asset in the item\nUse the US GHG Center TiTiler API to visualize the asset\n\n\n\n\n\n\nFrom the PySTAC Client Documentation:\n\nThe STAC Python Client (pystac_client) is a Python package for working with STAC Catalogs and APIs that conform to the STAC and STAC API specs in a seamless way.\nPySTAC Client builds upon PySTAC through higher-level functionality and ability to leverage STAC API search endpoints.\n\nWe will use it to interact with the data catalog.\n\n\n\nRequests (requests) is a simple HTTP library. Requests allows you to send HTTP requests extremely easily.\nWe will use it to make API requests.\nHere we import all the required libraries and modules.\n\nimport requests\n\nfrom pystac_client import Client\n\n# For displaying image in a jupyter notebook\nfrom IPython.display import Image, display\n\nLet’s define the data catalog (STAC catalog) API URL\n\n# STAC API root URL\nURL = 'https://ghg.center/api/stac'\n\nUse the pystac_client.Client module to connect to the catalog\n\ncatalog = Client.open(URL)\ncatalog\n\n\n\n\n\n \n \n \n \n \n \n type\n \"Catalog\"\n \n \n \n \n \n \n \n id\n \"stac-fastapi\"\n \n \n \n \n \n \n \n stac_version\n \"1.0.0\"\n \n \n \n \n \n \n \n description\n \"veda-stac\"\n \n \n \n \n \n \n \n links\n [] 23 items\n \n \n \n \n \n \n \n 0\n \n \n \n \n \n rel\n \"self\"\n \n \n \n \n \n \n \n href\n \"https://ghg.center/api/stac\"\n \n \n \n \n \n \n \n type\n \"application/json\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 1\n \n \n \n \n \n rel\n \"root\"\n \n \n \n \n \n \n \n href\n \"https://ghg.center/api/stac/\"\n \n \n \n \n \n \n \n type\n \"application/json\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 2\n \n \n \n \n \n rel\n \"data\"\n \n \n \n \n \n \n \n href\n \"https://ghg.center/api/stac/collections\"\n \n \n \n \n \n \n \n type\n \"application/json\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 3\n \n \n \n \n \n rel\n \"conformance\"\n \n \n \n \n \n \n \n href\n \"https://ghg.center/api/stac/conformance\"\n \n \n \n \n \n \n \n type\n \"application/json\"\n \n \n \n \n \n \n \n title\n \"STAC/WFS3 conformance classes implemented by this server\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 4\n \n \n \n \n \n rel\n \"search\"\n \n \n \n \n \n \n \n href\n \"https://ghg.center/api/stac/search\"\n \n \n \n \n \n \n \n type\n \"application/geo+json\"\n \n \n \n \n \n \n \n title\n \"STAC search\"\n \n \n \n \n \n \n \n method\n \"GET\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 5\n \n \n \n \n \n rel\n \"search\"\n \n \n \n \n \n \n \n href\n \"https://ghg.center/api/stac/search\"\n \n \n \n \n \n \n \n type\n \"application/geo+json\"\n \n \n \n \n \n \n \n title\n \"STAC search\"\n \n \n \n \n \n \n \n method\n \"POST\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 6\n \n \n \n \n \n rel\n \"child\"\n \n \n \n \n \n \n \n href\n \"https://ghg.center/api/stac/collections/epa-ch4emission-yeargrid-v2express-new\"\n \n \n \n \n \n \n \n type\n \"application/json\"\n \n \n \n \n \n \n \n title\n \"Gridded annual U.S. anthropogenic methane emissions 2012-2020\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 7\n \n \n \n \n \n rel\n \"child\"\n \n \n \n \n \n \n \n href\n \"https://ghg.center/api/stac/collections/lpjwsl-wetlandch4-monthgrid-v1\"\n \n \n \n \n \n \n \n type\n \"application/json\"\n \n \n \n \n \n \n \n title\n \"Wetland Methane Emissions, LPJ-wsl Model (Monthly)\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 8\n \n \n \n \n \n rel\n \"child\"\n \n \n \n \n \n \n \n href\n \"https://ghg.center/api/stac/collections/tm54dvar-ch4flux-monthgrid-v1\"\n \n \n \n \n \n \n \n type\n \"application/json\"\n \n \n \n \n \n \n \n title\n \"TM5-4DVar Isotopic CH4 Inverse Fluxes\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 9\n \n \n \n \n \n rel\n \"child\"\n \n \n \n \n \n \n \n href\n \"https://ghg.center/api/stac/collections/gosat-based-ch4budget-yeargrid-v1\"\n \n \n \n \n \n \n \n type\n \"application/json\"\n \n \n \n \n \n \n \n title\n \"GOSAT-based Top-down Methane Budgets.\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 10\n \n \n \n \n \n rel\n \"child\"\n \n \n \n \n \n \n \n href\n \"https://ghg.center/api/stac/collections/sedac-popdensity-yeargrid5yr-v4.11\"\n \n \n \n \n \n \n \n type\n \"application/json\"\n \n \n \n \n \n \n \n title\n \"SEDAC Gridded World Population Data\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 11\n \n \n \n \n \n rel\n \"child\"\n \n \n \n \n \n \n \n href\n \"https://ghg.center/api/stac/collections/tm54dvar-ch4flux-mask-monthgrid-v1\"\n \n \n \n \n \n \n \n type\n \"application/json\"\n \n \n \n \n \n \n \n title\n \"TM5-4DVar Isotopic CH4 Inverse Fluxes\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 12\n \n \n \n \n \n rel\n \"child\"\n \n \n \n \n \n \n \n href\n \"https://ghg.center/api/stac/collections/casagfed-carbonflux-monthgrid-v3\"\n \n \n \n \n \n \n \n type\n \"application/json\"\n \n \n \n \n \n \n \n title\n \"CASA GFED3 Land Carbon Flux\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 13\n \n \n \n \n \n rel\n \"child\"\n \n \n \n \n \n \n \n href\n \"https://ghg.center/api/stac/collections/oco2geos-co2-daygrid-v10r\"\n \n \n \n \n \n \n \n type\n \"application/json\"\n \n \n \n \n \n \n \n title\n \"OCO-2 GEOS Assimilated CO2 Concentrations\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 14\n \n \n \n \n \n rel\n \"child\"\n \n \n \n \n \n \n \n href\n \"https://ghg.center/api/stac/collections/lpjwsl-wetlandch4-daygrid-v1\"\n \n \n \n \n \n \n \n type\n \"application/json\"\n \n \n \n \n \n \n \n title\n \"Wetland Methane Emissions, LPJ-wsl Model (Daily)\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 15\n \n \n \n \n \n rel\n \"child\"\n \n \n \n \n \n \n \n href\n \"https://ghg.center/api/stac/collections/epa-ch4emission-yeargrid-v2express\"\n \n \n \n \n \n \n \n type\n \"application/json\"\n \n \n \n \n \n \n \n title\n \"Gridded annual U.S. anthropogenic methane emissions 2012-2020\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 16\n \n \n \n \n \n rel\n \"child\"\n \n \n \n \n \n \n \n href\n \"https://ghg.center/api/stac/collections/emit-ch4plume-v1\"\n \n \n \n \n \n \n \n type\n \"application/json\"\n \n \n \n \n \n \n \n title\n \"Methane Point Source Plume Complexes\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 17\n \n \n \n \n \n rel\n \"child\"\n \n \n \n \n \n \n \n href\n \"https://ghg.center/api/stac/collections/oco2-mip-meanco2budget-yeargrid-v1\"\n \n \n \n \n \n \n \n type\n \"application/json\"\n \n \n \n \n \n \n \n title\n \"Pilot top-down CO2 Budget constrained by the v10 OCO-2 MIP Version 1 mean for all the years\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 18\n \n \n \n \n \n rel\n \"child\"\n \n \n \n \n \n \n \n href\n \"https://ghg.center/api/stac/collections/oco2-mip-co2budget-yeargrid-v1\"\n \n \n \n \n \n \n \n type\n \"application/json\"\n \n \n \n \n \n \n \n title\n \"Pilot top-down CO2 Budget constrained by the v10 OCO-2 MIP Version 1\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 19\n \n \n \n \n \n rel\n \"child\"\n \n \n \n \n \n \n \n href\n \"https://ghg.center/api/stac/collections/eccodarwin-co2flux-monthgrid-v5\"\n \n \n \n \n \n \n \n type\n \"application/json\"\n \n \n \n \n \n \n \n title\n \"Air-Sea CO2 Flux, ECCO-Darwin Model v5\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 20\n \n \n \n \n \n rel\n \"child\"\n \n \n \n \n \n \n \n href\n \"https://ghg.center/api/stac/collections/odiac-ffco2-monthgrid-v2022\"\n \n \n \n \n \n \n \n type\n \"application/json\"\n \n \n \n \n \n \n \n title\n \"ODIAC Fossil Fuel CO₂ Emissions\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 21\n \n \n \n \n \n rel\n \"service-desc\"\n \n \n \n \n \n \n \n href\n \"https://ghg.center/api/stac/openapi.json\"\n \n \n \n \n \n \n \n type\n \"application/vnd.oai.openapi+json;version=3.0\"\n \n \n \n \n \n \n \n title\n \"OpenAPI service description\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 22\n \n \n \n \n \n rel\n \"service-doc\"\n \n \n \n \n \n \n \n href\n \"https://ghg.center/api/stac/docs\"\n \n \n \n \n \n \n \n type\n \"text/html\"\n \n \n \n \n \n \n \n title\n \"OpenAPI service documentation\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n conformsTo\n [] 16 items\n \n \n \n \n \n \n \n 0\n \"https://api.stacspec.org/v1.0.0/item-search\"\n \n \n \n \n \n \n \n \n \n \n \n 1\n \"http://www.opengis.net/spec/ogcapi-features-1/1.0/conf/core\"\n \n \n \n \n \n \n \n \n \n \n \n 2\n \"http://www.opengis.net/spec/cql2/1.0/conf/cql2-text\"\n \n \n \n \n \n \n \n \n \n \n \n 3\n \"https://api.stacspec.org/v1.0.0-rc.2/item-search#sort\"\n \n \n \n \n \n \n \n \n \n \n \n 4\n \"https://api.stacspec.org/v1.0.0/collections\"\n \n \n \n \n \n \n \n \n \n \n \n 5\n \"http://www.opengis.net/spec/ogcapi-features-1/1.0/conf/geojson\"\n \n \n \n \n \n \n \n \n \n \n \n 6\n \"http://www.opengis.net/spec/ogcapi-features-1/1.0/conf/oas30\"\n \n \n \n \n \n \n \n \n \n \n \n 7\n \"http://www.opengis.net/spec/ogcapi-features-3/1.0/conf/features-filter\"\n \n \n \n \n \n \n \n \n \n \n \n 8\n \"https://api.stacspec.org/v1.0.0/ogcapi-features\"\n \n \n \n \n \n \n \n \n \n \n \n 9\n \"https://api.stacspec.org/v1.0.0/core\"\n \n \n \n \n \n \n \n \n \n \n \n 10\n \"http://www.opengis.net/spec/ogcapi-features-3/1.0/conf/filter\"\n \n \n \n \n \n \n \n \n \n \n \n 11\n \"https://api.stacspec.org/v1.0.0-rc.2/item-search#filter\"\n \n \n \n \n \n \n \n \n \n \n \n 12\n \"https://api.stacspec.org/v1.0.0-rc.2/item-search#query\"\n \n \n \n \n \n \n \n \n \n \n \n 13\n \"https://api.stacspec.org/v1.0.0-rc.3/item-search#fields\"\n \n \n \n \n \n \n \n \n \n \n \n 14\n \"https://api.stacspec.org/v1.0.0-rc.2/item-search#context\"\n \n \n \n \n \n \n \n \n \n \n \n 15\n \"http://www.opengis.net/spec/cql2/1.0/conf/basic-cql2\"\n \n \n \n \n \n \n \n \n \n \n \n \n title\n \"veda-stac\"\n \n \n \n \n \n \n\n\n\nList all the datasets (collections) in the catalog\n\ncollections = catalog.get_collections()\ncollections = list(collections)\n\n\nfor collection in collections:\n # print(f\">> {collection.id}: \\n- {collection.description}\\n\")\n \n print(\">> \" + collection.id)\n print(\"- \" + collection.description + \"\\n\")\n\n>> epa-ch4emission-yeargrid-v2express-new\n- This gridded dataset represents an update to the original version 1 of the gridded GHGI from Maasakkers, et al., (2016). The annual files contain one year of emissions per source category but include a time dimension to make them suitable (COARDS-compliant) for atmospheric models. This main dataset also includes monthly source-specific methane emission scaling factors for those select sources with strong interannual variability.\n\n>> lpjwsl-wetlandch4-monthgrid-v1\n- Wetland methane emissions produced by the Lund–Potsdam–Jena Dynamic Global Vegetation Model (LPJ-DGVM) Wald Schnee und Landscaft version (LPJ-wsl). LPJ-wsl is a prognostic model used to simulate future changes in wetland emissions and independently verified with remote sensing data products. The LPJ-wsl model is regularly used in conjunction with NASA’s GEOS model to simulate the impact of wetlands and other methane sources on atmospheric methane concentrations.\n\n>> tm54dvar-ch4flux-monthgrid-v1\n- Global, monthly 1 degree resolution methane emission estimates from microbial, fossil and pyrogenic sources derived using inverse modeling, version 1.\n\n>> gosat-based-ch4budget-yeargrid-v1\n- Annual methane emissions gridded globally at 1° resolution for 2019, version.\n\n>> sedac-popdensity-yeargrid5yr-v4.11\n- The Gridded Population of the World, Version 4 (GPWv4): Population Density, Revision 11 consists of estimates of human population density (number of persons per square kilometer) based on counts consistent with national censuses and population registers, for the years 2000, 2005, 2010, 2015, and 2020. \n\n>> tm54dvar-ch4flux-mask-monthgrid-v1\n- Global, monthly 1 degree resolution methane emission estimates from microbial, fossil and pyrogenic sources derived using inverse modeling, version 1.\n\n>> casagfed-carbonflux-monthgrid-v3\n- This product provides Monthly average Net Primary Production (NPP), heterotrophic respiration (Rh), wildfire emissions (FIRE), and fuel wood burning emissions (FUEL) derived from the Carnegie-Ames-Stanford-Approach – Global Fire Emissions Database version 3 (CASA-GFED3) model.\n\n>> oco2geos-co2-daygrid-v10r\n- Daily, global 0.5 x 0.625 degree assimilated CO2 concentrations derived from OCO-2 satellite data, version 10r\n\n>> lpjwsl-wetlandch4-daygrid-v1\n- Wetland methane emissions produced by the Lund–Potsdam–Jena Dynamic Global Vegetation Model (LPJ-DGVM) Wald Schnee und Landscaft version (LPJ-wsl). LPJ-wsl is a prognostic model used to simulate future changes in wetland emissions and independently verified with remote sensing data products. The LPJ-wsl model is regularly used in conjunction with NASA’s GEOS model to simulate the impact of wetlands and other methane sources on atmospheric methane concentrations.\n\n>> epa-ch4emission-yeargrid-v2express\n- This gridded dataset represents an update to the original version 1 of the gridded GHGI from Maasakkers, et al., (2016). The annual files contain one year of emissions per source category but include a time dimension to make them suitable (COARDS-compliant) for atmospheric models. This main dataset also includes monthly source-specific methane emission scaling factors for those select sources with strong interannual variability.\n\n>> emit-ch4plume-v1\n- Methane plume complexes from point source emitters\n\n>> oco2-mip-meanco2budget-yeargrid-v1\n- National CO2 Budgets (2015-2020) inferred from atmospheric CO2 observations in support of the Global Stocktake\n\n>> oco2-mip-co2budget-yeargrid-v1\n- National CO2 Budgets (2015-2020) inferred from atmospheric CO2 observations in support of the Global Stocktake\n\n>> eccodarwin-co2flux-monthgrid-v5\n- Global, monthly average air-sea CO2 flux at ~1/3° resolution from 2020 to 2022\n\n>> odiac-ffco2-monthgrid-v2022\n- The Open-Data Inventory for Anthropogenic Carbon dioxide (ODIAC) is a high-spatial resolution global emission data product of CO₂ emissions from fossil fuel combustion (Oda and Maksyutov, 2011). ODIAC pioneered the combined use of space-based nighttime light data and individual power plant emission/location profiles to estimate the global spatial extent of fossil fuel CO₂ emissions. With the innovative emission modeling approach, ODIAC achieved the fine picture of global fossil fuel CO₂ emissions at a 1x1km.\n\n\n\nPick a collection to interact with. Let’s pick eccodarwin-co2flux-monthgrid-v5. This dataset represents the Air-Sea CO₂ flux, estimated using the ECCO (Estimating the Circulation and Climate of the Ocean) Darwin model.\nRead more about the dataset in the GHG Center Web Portal: https://earth.gov/ghgcenter/data-catalog/eccodarwin-co2flux-monthgrid-v5\n\ncollection = catalog.get_collection(\"eccodarwin-co2flux-monthgrid-v5\")\ncollection\n\n\n\n\n\n \n \n \n \n \n \n type\n \"Collection\"\n \n \n \n \n \n \n \n id\n \"eccodarwin-co2flux-monthgrid-v5\"\n \n \n \n \n \n \n \n stac_version\n \"1.0.0\"\n \n \n \n \n \n \n \n description\n \"Global, monthly average air-sea CO2 flux at ~1/3° resolution from 2020 to 2022\"\n \n \n \n \n \n \n \n links\n [] 4 items\n \n \n \n \n \n \n \n 0\n \n \n \n \n \n rel\n \"items\"\n \n \n \n \n \n \n \n href\n \"https://ghg.center/api/stac/collections/eccodarwin-co2flux-monthgrid-v5/items\"\n \n \n \n \n \n \n \n type\n \"application/geo+json\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 1\n \n \n \n \n \n rel\n \"parent\"\n \n \n \n \n \n \n \n href\n \"https://ghg.center/api/stac/\"\n \n \n \n \n \n \n \n type\n \"application/json\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 2\n \n \n \n \n \n rel\n \"root\"\n \n \n \n \n \n \n \n href\n \"https://ghg.center/api/stac\"\n \n \n \n \n \n \n \n type\n \"application/json\"\n \n \n \n \n \n \n \n title\n \"veda-stac\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 3\n \n \n \n \n \n rel\n \"self\"\n \n \n \n \n \n \n \n href\n \"https://ghg.center/api/stac/collections/eccodarwin-co2flux-monthgrid-v5\"\n \n \n \n \n \n \n \n type\n \"application/json\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n item_assets\n \n \n \n \n \n co2\n \n \n \n \n \n type\n \"image/tiff; application=geotiff; profile=cloud-optimized\"\n \n \n \n \n \n \n \n roles\n [] 2 items\n \n \n \n \n \n \n \n 0\n \"data\"\n \n \n \n \n \n \n \n \n \n \n \n 1\n \"layer\"\n \n \n \n \n \n \n \n \n \n \n \n \n title\n \"Air-Sea CO2 Flux\"\n \n \n \n \n \n \n \n description\n \"Monthly mean air-sea CO2 Flux (negative into ocean)\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n dashboard:is_periodic\n True\n \n \n \n \n \n \n \n dashboard:time_density\n \"month\"\n \n \n \n \n \n \n \n title\n \"Air-Sea CO2 Flux, ECCO-Darwin Model v5\"\n \n \n \n \n \n \n \n extent\n \n \n \n \n \n spatial\n \n \n \n \n \n bbox\n [] 1 items\n \n \n \n \n \n \n \n 0\n [] 4 items\n \n \n \n \n \n \n \n 0\n -180.125\n \n \n \n \n \n \n \n \n \n \n \n 1\n -90.12483215332031\n \n \n \n \n \n \n \n \n \n \n \n 2\n 179.875\n \n \n \n \n \n \n \n \n \n \n \n 3\n 89.87517547607422\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n temporal\n \n \n \n \n \n interval\n [] 1 items\n \n \n \n \n \n \n \n 0\n [] 2 items\n \n \n \n \n \n \n \n 0\n \"2020-01-01T00:00:00Z\"\n \n \n \n \n \n \n \n \n \n \n \n 1\n \"2022-12-31T00:00:00Z\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n license\n \"CC-BY-4.0\"\n \n \n \n \n \n \n \n summaries\n \n \n \n \n \n datetime\n [] 2 items\n \n \n \n \n \n \n \n 0\n \"2020-01-01T00:00:00Z\"\n \n \n \n \n \n \n \n \n \n \n \n 1\n \"2022-12-31T00:00:00Z\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n\n\n\nLet’s look at the items within the collection, using the CollectionClient.get_items method\n\n# get_items\nitems = list(collection.get_items())\n\n\nfor item in items[:10]:\n print(item)\n\n<Item id=eccodarwin-co2flux-monthgrid-v5-202212>\n<Item id=eccodarwin-co2flux-monthgrid-v5-202211>\n<Item id=eccodarwin-co2flux-monthgrid-v5-202210>\n<Item id=eccodarwin-co2flux-monthgrid-v5-202209>\n<Item id=eccodarwin-co2flux-monthgrid-v5-202208>\n<Item id=eccodarwin-co2flux-monthgrid-v5-202207>\n<Item id=eccodarwin-co2flux-monthgrid-v5-202206>\n<Item id=eccodarwin-co2flux-monthgrid-v5-202205>\n<Item id=eccodarwin-co2flux-monthgrid-v5-202204>\n<Item id=eccodarwin-co2flux-monthgrid-v5-202203>\n\n\n\nitem = collection.get_item(items[0].id) # item = collection.get_item(\"eccodarwin-co2flux-monthgrid-v5-202212\")\nitem\n\n\n\n\n\n \n \n \n \n \n \n type\n \"Feature\"\n \n \n \n \n \n \n \n stac_version\n \"1.0.0\"\n \n \n \n \n \n \n \n id\n \"eccodarwin-co2flux-monthgrid-v5-202212\"\n \n \n \n \n \n \n \n properties\n \n \n \n \n \n end_datetime\n \"2022-12-31T00:00:00+00:00\"\n \n \n \n \n \n \n \n start_datetime\n \"2022-12-01T00:00:00+00:00\"\n \n \n \n \n \n \n \n datetime\n None\n \n \n \n \n \n \n \n \n \n \n \n \n geometry\n \n \n \n \n \n type\n \"Polygon\"\n \n \n \n \n \n \n \n coordinates\n [] 1 items\n \n \n \n \n \n \n \n 0\n [] 5 items\n \n \n \n \n \n \n \n 0\n [] 2 items\n \n \n \n \n \n \n \n 0\n -180.125\n \n \n \n \n \n \n \n \n \n \n \n 1\n -90.124826629681\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 1\n [] 2 items\n \n \n \n \n \n \n \n 0\n 179.875\n \n \n \n \n \n \n \n \n \n \n \n 1\n -90.124826629681\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 2\n [] 2 items\n \n \n \n \n \n \n \n 0\n 179.875\n \n \n \n \n \n \n \n \n \n \n \n 1\n 89.875173370319\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 3\n [] 2 items\n \n \n \n \n \n \n \n 0\n -180.125\n \n \n \n \n \n \n \n \n \n \n \n 1\n 89.875173370319\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 4\n [] 2 items\n \n \n \n \n \n \n \n 0\n -180.125\n \n \n \n \n \n \n \n \n \n \n \n 1\n -90.124826629681\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n links\n [] 4 items\n \n \n \n \n \n \n \n 0\n \n \n \n \n \n rel\n \"self\"\n \n \n \n \n \n \n \n href\n \"https://ghg.center/api/stac/collections/eccodarwin-co2flux-monthgrid-v5/items/eccodarwin-co2flux-monthgrid-v5-202212\"\n \n \n \n \n \n \n \n type\n \"application/json\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 1\n \n \n \n \n \n rel\n \"collection\"\n \n \n \n \n \n \n \n href\n \"https://ghg.center/api/stac/collections/eccodarwin-co2flux-monthgrid-v5\"\n \n \n \n \n \n \n \n type\n \"application/json\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 2\n \n \n \n \n \n rel\n \"parent\"\n \n \n \n \n \n \n \n href\n \"https://ghg.center/api/stac/collections/eccodarwin-co2flux-monthgrid-v5\"\n \n \n \n \n \n \n \n type\n \"application/json\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 3\n \n \n \n \n \n rel\n \"root\"\n \n \n \n \n \n \n \n href\n \"https://ghg.center/api/stac/collections/eccodarwin-co2flux-monthgrid-v5\"\n \n \n \n \n \n \n \n type\n \"application/json\"\n \n \n \n \n \n \n \n title\n \"Air-Sea CO2 Flux, ECCO-Darwin Model v5\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n assets\n \n \n \n \n \n co2\n \n \n \n \n \n href\n \"s3://ghgc-data-store/eccodarwin-co2flux-monthgrid-v5/ECCO-Darwin_CO2_flux_202212.tif\"\n \n \n \n \n \n \n \n type\n \"image/tiff; application=geotiff\"\n \n \n \n \n \n \n \n title\n \"Air-Sea CO2 Flux\"\n \n \n \n \n \n \n \n description\n \"Monthly mean air-sea CO2 Flux (negative into ocean)\"\n \n \n \n \n \n \n \n proj:bbox\n [] 4 items\n \n \n \n \n \n \n \n 0\n -180.125\n \n \n \n \n \n \n \n \n \n \n \n 1\n -90.124826629681\n \n \n \n \n \n \n \n \n \n \n \n 2\n 179.875\n \n \n \n \n \n \n \n \n \n \n \n 3\n 89.875173370319\n \n \n \n \n \n \n \n \n \n \n \n \n proj:epsg\n 4326.0\n \n \n \n \n \n \n \n proj:shape\n [] 2 items\n \n \n \n \n \n \n \n 0\n 721.0\n \n \n \n \n \n \n \n \n \n \n \n 1\n 1440.0\n \n \n \n \n \n \n \n \n \n \n \n \n raster:bands\n [] 1 items\n \n \n \n \n \n \n \n 0\n \n \n \n \n \n scale\n 1.0\n \n \n \n \n \n \n \n offset\n 0.0\n \n \n \n \n \n \n \n sampling\n \"area\"\n \n \n \n \n \n \n \n data_type\n \"float64\"\n \n \n \n \n \n \n \n histogram\n \n \n \n \n \n max\n 1e+20\n \n \n \n \n \n \n \n min\n -0.0560546528687938\n \n \n \n \n \n \n \n count\n 11.0\n \n \n \n \n \n \n \n buckets\n [] 10 items\n \n \n \n \n \n \n \n 0\n 338606.0\n \n \n \n \n \n \n \n \n \n \n \n 1\n 0.0\n \n \n \n \n \n \n \n \n \n \n \n 2\n 0.0\n \n \n \n \n \n \n \n \n \n \n \n 3\n 0.0\n \n \n \n \n \n \n \n \n \n \n \n 4\n 0.0\n \n \n \n \n \n \n \n \n \n \n \n 5\n 0.0\n \n \n \n \n \n \n \n \n \n \n \n 6\n 0.0\n \n \n \n \n \n \n \n \n \n \n \n 7\n 0.0\n \n \n \n \n \n \n \n \n \n \n \n 8\n 0.0\n \n \n \n \n \n \n \n \n \n \n \n 9\n 186706.0\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n statistics\n \n \n \n \n \n mean\n 3.554192556042885e+19\n \n \n \n \n \n \n \n stddev\n 4.786401658343999e+19\n \n \n \n \n \n \n \n maximum\n 1e+20\n \n \n \n \n \n \n \n minimum\n -0.0560546528687938\n \n \n \n \n \n \n \n valid_percent\n 0.0001903630604288499\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n proj:geometry\n \n \n \n \n \n type\n \"Polygon\"\n \n \n \n \n \n \n \n coordinates\n [] 1 items\n \n \n \n \n \n \n \n 0\n [] 5 items\n \n \n \n \n \n \n \n 0\n [] 2 items\n \n \n \n \n \n \n \n 0\n -180.125\n \n \n \n \n \n \n \n \n \n \n \n 1\n -90.124826629681\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 1\n [] 2 items\n \n \n \n \n \n \n \n 0\n 179.875\n \n \n \n \n \n \n \n \n \n \n \n 1\n -90.124826629681\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 2\n [] 2 items\n \n \n \n \n \n \n \n 0\n 179.875\n \n \n \n \n \n \n \n \n \n \n \n 1\n 89.875173370319\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 3\n [] 2 items\n \n \n \n \n \n \n \n 0\n -180.125\n \n \n \n \n \n \n \n \n \n \n \n 1\n 89.875173370319\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 4\n [] 2 items\n \n \n \n \n \n \n \n 0\n -180.125\n \n \n \n \n \n \n \n \n \n \n \n 1\n -90.124826629681\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n proj:projjson\n \n \n \n \n \n id\n \n \n \n \n \n code\n 4326.0\n \n \n \n \n \n \n \n authority\n \"EPSG\"\n \n \n \n \n \n \n \n \n \n \n \n \n name\n \"WGS 84\"\n \n \n \n \n \n \n \n type\n \"GeographicCRS\"\n \n \n \n \n \n \n \n datum\n \n \n \n \n \n name\n \"World Geodetic System 1984\"\n \n \n \n \n \n \n \n type\n \"GeodeticReferenceFrame\"\n \n \n \n \n \n \n \n ellipsoid\n \n \n \n \n \n name\n \"WGS 84\"\n \n \n \n \n \n \n \n semi_major_axis\n 6378137.0\n \n \n \n \n \n \n \n inverse_flattening\n 298.257223563\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n $schema\n \"https://proj.org/schemas/v0.4/projjson.schema.json\"\n \n \n \n \n \n \n \n coordinate_system\n \n \n \n \n \n axis\n [] 2 items\n \n \n \n \n \n \n \n 0\n \n \n \n \n \n name\n \"Geodetic latitude\"\n \n \n \n \n \n \n \n unit\n \"degree\"\n \n \n \n \n \n \n \n direction\n \"north\"\n \n \n \n \n \n \n \n abbreviation\n \"Lat\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 1\n \n \n \n \n \n name\n \"Geodetic longitude\"\n \n \n \n \n \n \n \n unit\n \"degree\"\n \n \n \n \n \n \n \n direction\n \"east\"\n \n \n \n \n \n \n \n abbreviation\n \"Lon\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n subtype\n \"ellipsoidal\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n proj:transform\n [] 9 items\n \n \n \n \n \n \n \n 0\n 0.25\n \n \n \n \n \n \n \n \n \n \n \n 1\n 0.0\n \n \n \n \n \n \n \n \n \n \n \n 2\n -180.125\n \n \n \n \n \n \n \n \n \n \n \n 3\n 0.0\n \n \n \n \n \n \n \n \n \n \n \n 4\n -0.24965325936199723\n \n \n \n \n \n \n \n \n \n \n \n 5\n 89.875173370319\n \n \n \n \n \n \n \n \n \n \n \n 6\n 0.0\n \n \n \n \n \n \n \n \n \n \n \n 7\n 0.0\n \n \n \n \n \n \n \n \n \n \n \n 8\n 1.0\n \n \n \n \n \n \n \n \n \n \n \n \n roles\n [] 2 items\n \n \n \n \n \n \n \n 0\n \"data\"\n \n \n \n \n \n \n \n \n \n \n \n 1\n \"layer\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n bbox\n [] 4 items\n \n \n \n \n \n \n \n 0\n -180.125\n \n \n \n \n \n \n \n \n \n \n \n 1\n -90.124826629681\n \n \n \n \n \n \n \n \n \n \n \n 2\n 179.875\n \n \n \n \n \n \n \n \n \n \n \n 3\n 89.875173370319\n \n \n \n \n \n \n \n \n \n \n \n \n stac_extensions\n [] 2 items\n \n \n \n \n \n \n \n 0\n \"https://stac-extensions.github.io/raster/v1.1.0/schema.json\"\n \n \n \n \n \n \n \n \n \n \n \n 1\n \"https://stac-extensions.github.io/projection/v1.1.0/schema.json\"\n \n \n \n \n \n \n \n \n \n \n \n \n collection\n \"eccodarwin-co2flux-monthgrid-v5\"\n \n \n \n \n \n \n\n\n\n\nasset = item.assets[\"co2\"].href\nasset\n\n's3://ghgc-data-store/eccodarwin-co2flux-monthgrid-v5/ECCO-Darwin_CO2_flux_202212.tif'\n\n\nVisualize this asset using TiTiler\n\n# Define the TiTiler url\nTITILER_URL = \"https://ghg.center/api/raster\"\n\n\n# TiTiler preview endpoint\ncog_preview = f\"/cog/preview.png?url={asset}&rescale=-0.0007,0.0002&colormap_name=bwr\"\n\nUser requests.get to make a GET request for the preview\n\nresponse = requests.get(f\"{TITILER_URL}{cog_preview}\") #https://ghg.center/api/raster/cog/preview.png?url=s3://ghgc-data-store/eccodarwin-co2flux-monthgrid-v5/ECCO-Darwin_CO2_flux_202212.tif&rescale=-0.0007,0.0002&colormap_name=bwr\nresponse\n\n<Response [200]>\n\n\n\ndisplay(Image(response.content))\n\n\n\n\n\n\n\n\n\n\n\n# Rought AOI for Baltimore, MD area\nbaltimore_aoi = {\n \"type\": \"Polygon\",\n \"coordinates\": [\n [\n [\n -76.7413596126004,\n 39.37730408865011\n ],\n [\n -76.7413596126004,\n 39.20129583511198\n ],\n [\n -76.47249934044682,\n 39.20129583511198\n ],\n [\n -76.47249934044682,\n 39.37730408865011\n ],\n [\n -76.7413596126004,\n 39.37730408865011\n ]\n ]\n ],\n}\n\n\n# Search the catalog for the given collection, aoi and datetime\nsearch = catalog.search(\n max_items = 100,\n # limit = 5,\n collections = \"epa-ch4emission-yeargrid-v2express\",\n intersects = baltimore_aoi,\n datetime = \"2012-04-01/2015-12-31\",\n)\nitems = list(search.item_collection())\n\nlen(items)\n\n100\n\n\n\nitems[:5]\n\n[<Item id=oco2geos-co2-daygrid-v10r-20151231>,\n <Item id=lpjwsl-wetlandch4-daygrid-v1-20151231>,\n <Item id=oco2geos-co2-daygrid-v10r-20151230>,\n <Item id=lpjwsl-wetlandch4-daygrid-v1-20151230>,\n <Item id=oco2geos-co2-daygrid-v10r-20151229>]\n\n\n\n\n\n\n\nIn this notebook, we used the pystac_client library to interact with the US GHG Center Data Catalog. We learned how to list all the datasets, list all the items in a dataset, read the metadata for the dataset/items, access the data file, visualize it and finally search the catalog for specific area of interest and datetime.", + "text": "The US GHG Center uses a Spatio-Temporal Asset Catalog (STAC) to catalog it listing of datasets. This tutorial teaches the basics of searching and accessing datasets using the US GHG Center STAC catalog.", "crumbs": [ "Home", "Sections", @@ -865,8 +865,8 @@ "objectID": "sections/us-ghg-center-and-veda/catalog-interaction.html#approach", "href": "sections/us-ghg-center-and-veda/catalog-interaction.html#approach", "title": "Accessing and using the US GHG Center Data Catalog", - "section": "", - "text": "Use the pystac_client library to connect to the data catalog\nList all the collections from the catalog\nLook at the items in one of the collections\nAccess an asset in the item\nUse the US GHG Center TiTiler API to visualize the asset", + "section": "Approach", + "text": "Approach\n\nUse the pystac_client library to connect to the data catalog\nList all the collections from the catalog\nLook at the items in one of the collections\nAccess an asset in the item\nUse the US GHG Center TiTiler API to visualize the asset", "crumbs": [ "Home", "Sections", @@ -878,8 +878,8 @@ "objectID": "sections/us-ghg-center-and-veda/catalog-interaction.html#libraries-used", "href": "sections/us-ghg-center-and-veda/catalog-interaction.html#libraries-used", "title": "Accessing and using the US GHG Center Data Catalog", - "section": "", - "text": "From the PySTAC Client Documentation:\n\nThe STAC Python Client (pystac_client) is a Python package for working with STAC Catalogs and APIs that conform to the STAC and STAC API specs in a seamless way.\nPySTAC Client builds upon PySTAC through higher-level functionality and ability to leverage STAC API search endpoints.\n\nWe will use it to interact with the data catalog.\n\n\n\nRequests (requests) is a simple HTTP library. Requests allows you to send HTTP requests extremely easily.\nWe will use it to make API requests.\nHere we import all the required libraries and modules.\n\nimport requests\n\nfrom pystac_client import Client\n\n# For displaying image in a jupyter notebook\nfrom IPython.display import Image, display\n\nLet’s define the data catalog (STAC catalog) API URL\n\n# STAC API root URL\nURL = 'https://ghg.center/api/stac'\n\nUse the pystac_client.Client module to connect to the catalog\n\ncatalog = Client.open(URL)\ncatalog\n\n\n\n\n\n \n \n \n \n \n \n type\n \"Catalog\"\n \n \n \n \n \n \n \n id\n \"stac-fastapi\"\n \n \n \n \n \n \n \n stac_version\n \"1.0.0\"\n \n \n \n \n \n \n \n description\n \"veda-stac\"\n \n \n \n \n \n \n \n links\n [] 23 items\n \n \n \n \n \n \n \n 0\n \n \n \n \n \n rel\n \"self\"\n \n \n \n \n \n \n \n href\n \"https://ghg.center/api/stac\"\n \n \n \n \n \n \n \n type\n \"application/json\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 1\n \n \n \n \n \n rel\n \"root\"\n \n \n \n \n \n \n \n href\n \"https://ghg.center/api/stac/\"\n \n \n \n \n \n \n \n type\n \"application/json\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 2\n \n \n \n \n \n rel\n \"data\"\n \n \n \n \n \n \n \n href\n \"https://ghg.center/api/stac/collections\"\n \n \n \n \n \n \n \n type\n \"application/json\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 3\n \n \n \n \n \n rel\n \"conformance\"\n \n \n \n \n \n \n \n href\n \"https://ghg.center/api/stac/conformance\"\n \n \n \n \n \n \n \n type\n \"application/json\"\n \n \n \n \n \n \n \n title\n \"STAC/WFS3 conformance classes implemented by this server\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 4\n \n \n \n \n \n rel\n \"search\"\n \n \n \n \n \n \n \n href\n \"https://ghg.center/api/stac/search\"\n \n \n \n \n \n \n \n type\n \"application/geo+json\"\n \n \n \n \n \n \n \n title\n \"STAC search\"\n \n \n \n \n \n \n \n method\n \"GET\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 5\n \n \n \n \n \n rel\n \"search\"\n \n \n \n \n \n \n \n href\n \"https://ghg.center/api/stac/search\"\n \n \n \n \n \n \n \n type\n \"application/geo+json\"\n \n \n \n \n \n \n \n title\n \"STAC search\"\n \n \n \n \n \n \n \n method\n \"POST\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 6\n \n \n \n \n \n rel\n \"child\"\n \n \n \n \n \n \n \n href\n \"https://ghg.center/api/stac/collections/epa-ch4emission-yeargrid-v2express-new\"\n \n \n \n \n \n \n \n type\n \"application/json\"\n \n \n \n \n \n \n \n title\n \"Gridded annual U.S. anthropogenic methane emissions 2012-2020\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 7\n \n \n \n \n \n rel\n \"child\"\n \n \n \n \n \n \n \n href\n \"https://ghg.center/api/stac/collections/lpjwsl-wetlandch4-monthgrid-v1\"\n \n \n \n \n \n \n \n type\n \"application/json\"\n \n \n \n \n \n \n \n title\n \"Wetland Methane Emissions, LPJ-wsl Model (Monthly)\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 8\n \n \n \n \n \n rel\n \"child\"\n \n \n \n \n \n \n \n href\n \"https://ghg.center/api/stac/collections/tm54dvar-ch4flux-monthgrid-v1\"\n \n \n \n \n \n \n \n type\n \"application/json\"\n \n \n \n \n \n \n \n title\n \"TM5-4DVar Isotopic CH4 Inverse Fluxes\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 9\n \n \n \n \n \n rel\n \"child\"\n \n \n \n \n \n \n \n href\n \"https://ghg.center/api/stac/collections/gosat-based-ch4budget-yeargrid-v1\"\n \n \n \n \n \n \n \n type\n \"application/json\"\n \n \n \n \n \n \n \n title\n \"GOSAT-based Top-down Methane Budgets.\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 10\n \n \n \n \n \n rel\n \"child\"\n \n \n \n \n \n \n \n href\n \"https://ghg.center/api/stac/collections/sedac-popdensity-yeargrid5yr-v4.11\"\n \n \n \n \n \n \n \n type\n \"application/json\"\n \n \n \n \n \n \n \n title\n \"SEDAC Gridded World Population Data\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 11\n \n \n \n \n \n rel\n \"child\"\n \n \n \n \n \n \n \n href\n \"https://ghg.center/api/stac/collections/tm54dvar-ch4flux-mask-monthgrid-v1\"\n \n \n \n \n \n \n \n type\n \"application/json\"\n \n \n \n \n \n \n \n title\n \"TM5-4DVar Isotopic CH4 Inverse Fluxes\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 12\n \n \n \n \n \n rel\n \"child\"\n \n \n \n \n \n \n \n href\n \"https://ghg.center/api/stac/collections/casagfed-carbonflux-monthgrid-v3\"\n \n \n \n \n \n \n \n type\n \"application/json\"\n \n \n \n \n \n \n \n title\n \"CASA GFED3 Land Carbon Flux\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 13\n \n \n \n \n \n rel\n \"child\"\n \n \n \n \n \n \n \n href\n \"https://ghg.center/api/stac/collections/oco2geos-co2-daygrid-v10r\"\n \n \n \n \n \n \n \n type\n \"application/json\"\n \n \n \n \n \n \n \n title\n \"OCO-2 GEOS Assimilated CO2 Concentrations\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 14\n \n \n \n \n \n rel\n \"child\"\n \n \n \n \n \n \n \n href\n \"https://ghg.center/api/stac/collections/lpjwsl-wetlandch4-daygrid-v1\"\n \n \n \n \n \n \n \n type\n \"application/json\"\n \n \n \n \n \n \n \n title\n \"Wetland Methane Emissions, LPJ-wsl Model (Daily)\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 15\n \n \n \n \n \n rel\n \"child\"\n \n \n \n \n \n \n \n href\n \"https://ghg.center/api/stac/collections/epa-ch4emission-yeargrid-v2express\"\n \n \n \n \n \n \n \n type\n \"application/json\"\n \n \n \n \n \n \n \n title\n \"Gridded annual U.S. anthropogenic methane emissions 2012-2020\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 16\n \n \n \n \n \n rel\n \"child\"\n \n \n \n \n \n \n \n href\n \"https://ghg.center/api/stac/collections/emit-ch4plume-v1\"\n \n \n \n \n \n \n \n type\n \"application/json\"\n \n \n \n \n \n \n \n title\n \"Methane Point Source Plume Complexes\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 17\n \n \n \n \n \n rel\n \"child\"\n \n \n \n \n \n \n \n href\n \"https://ghg.center/api/stac/collections/oco2-mip-meanco2budget-yeargrid-v1\"\n \n \n \n \n \n \n \n type\n \"application/json\"\n \n \n \n \n \n \n \n title\n \"Pilot top-down CO2 Budget constrained by the v10 OCO-2 MIP Version 1 mean for all the years\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 18\n \n \n \n \n \n rel\n \"child\"\n \n \n \n \n \n \n \n href\n \"https://ghg.center/api/stac/collections/oco2-mip-co2budget-yeargrid-v1\"\n \n \n \n \n \n \n \n type\n \"application/json\"\n \n \n \n \n \n \n \n title\n \"Pilot top-down CO2 Budget constrained by the v10 OCO-2 MIP Version 1\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 19\n \n \n \n \n \n rel\n \"child\"\n \n \n \n \n \n \n \n href\n \"https://ghg.center/api/stac/collections/eccodarwin-co2flux-monthgrid-v5\"\n \n \n \n \n \n \n \n type\n \"application/json\"\n \n \n \n \n \n \n \n title\n \"Air-Sea CO2 Flux, ECCO-Darwin Model v5\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 20\n \n \n \n \n \n rel\n \"child\"\n \n \n \n \n \n \n \n href\n \"https://ghg.center/api/stac/collections/odiac-ffco2-monthgrid-v2022\"\n \n \n \n \n \n \n \n type\n \"application/json\"\n \n \n \n \n \n \n \n title\n \"ODIAC Fossil Fuel CO₂ Emissions\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 21\n \n \n \n \n \n rel\n \"service-desc\"\n \n \n \n \n \n \n \n href\n \"https://ghg.center/api/stac/openapi.json\"\n \n \n \n \n \n \n \n type\n \"application/vnd.oai.openapi+json;version=3.0\"\n \n \n \n \n \n \n \n title\n \"OpenAPI service description\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 22\n \n \n \n \n \n rel\n \"service-doc\"\n \n \n \n \n \n \n \n href\n \"https://ghg.center/api/stac/docs\"\n \n \n \n \n \n \n \n type\n \"text/html\"\n \n \n \n \n \n \n \n title\n \"OpenAPI service documentation\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n conformsTo\n [] 16 items\n \n \n \n \n \n \n \n 0\n \"https://api.stacspec.org/v1.0.0/item-search\"\n \n \n \n \n \n \n \n \n \n \n \n 1\n \"http://www.opengis.net/spec/ogcapi-features-1/1.0/conf/core\"\n \n \n \n \n \n \n \n \n \n \n \n 2\n \"http://www.opengis.net/spec/cql2/1.0/conf/cql2-text\"\n \n \n \n \n \n \n \n \n \n \n \n 3\n \"https://api.stacspec.org/v1.0.0-rc.2/item-search#sort\"\n \n \n \n \n \n \n \n \n \n \n \n 4\n \"https://api.stacspec.org/v1.0.0/collections\"\n \n \n \n \n \n \n \n \n \n \n \n 5\n \"http://www.opengis.net/spec/ogcapi-features-1/1.0/conf/geojson\"\n \n \n \n \n \n \n \n \n \n \n \n 6\n \"http://www.opengis.net/spec/ogcapi-features-1/1.0/conf/oas30\"\n \n \n \n \n \n \n \n \n \n \n \n 7\n \"http://www.opengis.net/spec/ogcapi-features-3/1.0/conf/features-filter\"\n \n \n \n \n \n \n \n \n \n \n \n 8\n \"https://api.stacspec.org/v1.0.0/ogcapi-features\"\n \n \n \n \n \n \n \n \n \n \n \n 9\n \"https://api.stacspec.org/v1.0.0/core\"\n \n \n \n \n \n \n \n \n \n \n \n 10\n \"http://www.opengis.net/spec/ogcapi-features-3/1.0/conf/filter\"\n \n \n \n \n \n \n \n \n \n \n \n 11\n \"https://api.stacspec.org/v1.0.0-rc.2/item-search#filter\"\n \n \n \n \n \n \n \n \n \n \n \n 12\n \"https://api.stacspec.org/v1.0.0-rc.2/item-search#query\"\n \n \n \n \n \n \n \n \n \n \n \n 13\n \"https://api.stacspec.org/v1.0.0-rc.3/item-search#fields\"\n \n \n \n \n \n \n \n \n \n \n \n 14\n \"https://api.stacspec.org/v1.0.0-rc.2/item-search#context\"\n \n \n \n \n \n \n \n \n \n \n \n 15\n \"http://www.opengis.net/spec/cql2/1.0/conf/basic-cql2\"\n \n \n \n \n \n \n \n \n \n \n \n \n title\n \"veda-stac\"\n \n \n \n \n \n \n\n\n\nList all the datasets (collections) in the catalog\n\ncollections = catalog.get_collections()\ncollections = list(collections)\n\n\nfor collection in collections:\n # print(f\">> {collection.id}: \\n- {collection.description}\\n\")\n \n print(\">> \" + collection.id)\n print(\"- \" + collection.description + \"\\n\")\n\n>> epa-ch4emission-yeargrid-v2express-new\n- This gridded dataset represents an update to the original version 1 of the gridded GHGI from Maasakkers, et al., (2016). The annual files contain one year of emissions per source category but include a time dimension to make them suitable (COARDS-compliant) for atmospheric models. This main dataset also includes monthly source-specific methane emission scaling factors for those select sources with strong interannual variability.\n\n>> lpjwsl-wetlandch4-monthgrid-v1\n- Wetland methane emissions produced by the Lund–Potsdam–Jena Dynamic Global Vegetation Model (LPJ-DGVM) Wald Schnee und Landscaft version (LPJ-wsl). LPJ-wsl is a prognostic model used to simulate future changes in wetland emissions and independently verified with remote sensing data products. The LPJ-wsl model is regularly used in conjunction with NASA’s GEOS model to simulate the impact of wetlands and other methane sources on atmospheric methane concentrations.\n\n>> tm54dvar-ch4flux-monthgrid-v1\n- Global, monthly 1 degree resolution methane emission estimates from microbial, fossil and pyrogenic sources derived using inverse modeling, version 1.\n\n>> gosat-based-ch4budget-yeargrid-v1\n- Annual methane emissions gridded globally at 1° resolution for 2019, version.\n\n>> sedac-popdensity-yeargrid5yr-v4.11\n- The Gridded Population of the World, Version 4 (GPWv4): Population Density, Revision 11 consists of estimates of human population density (number of persons per square kilometer) based on counts consistent with national censuses and population registers, for the years 2000, 2005, 2010, 2015, and 2020. \n\n>> tm54dvar-ch4flux-mask-monthgrid-v1\n- Global, monthly 1 degree resolution methane emission estimates from microbial, fossil and pyrogenic sources derived using inverse modeling, version 1.\n\n>> casagfed-carbonflux-monthgrid-v3\n- This product provides Monthly average Net Primary Production (NPP), heterotrophic respiration (Rh), wildfire emissions (FIRE), and fuel wood burning emissions (FUEL) derived from the Carnegie-Ames-Stanford-Approach – Global Fire Emissions Database version 3 (CASA-GFED3) model.\n\n>> oco2geos-co2-daygrid-v10r\n- Daily, global 0.5 x 0.625 degree assimilated CO2 concentrations derived from OCO-2 satellite data, version 10r\n\n>> lpjwsl-wetlandch4-daygrid-v1\n- Wetland methane emissions produced by the Lund–Potsdam–Jena Dynamic Global Vegetation Model (LPJ-DGVM) Wald Schnee und Landscaft version (LPJ-wsl). LPJ-wsl is a prognostic model used to simulate future changes in wetland emissions and independently verified with remote sensing data products. The LPJ-wsl model is regularly used in conjunction with NASA’s GEOS model to simulate the impact of wetlands and other methane sources on atmospheric methane concentrations.\n\n>> epa-ch4emission-yeargrid-v2express\n- This gridded dataset represents an update to the original version 1 of the gridded GHGI from Maasakkers, et al., (2016). The annual files contain one year of emissions per source category but include a time dimension to make them suitable (COARDS-compliant) for atmospheric models. This main dataset also includes monthly source-specific methane emission scaling factors for those select sources with strong interannual variability.\n\n>> emit-ch4plume-v1\n- Methane plume complexes from point source emitters\n\n>> oco2-mip-meanco2budget-yeargrid-v1\n- National CO2 Budgets (2015-2020) inferred from atmospheric CO2 observations in support of the Global Stocktake\n\n>> oco2-mip-co2budget-yeargrid-v1\n- National CO2 Budgets (2015-2020) inferred from atmospheric CO2 observations in support of the Global Stocktake\n\n>> eccodarwin-co2flux-monthgrid-v5\n- Global, monthly average air-sea CO2 flux at ~1/3° resolution from 2020 to 2022\n\n>> odiac-ffco2-monthgrid-v2022\n- The Open-Data Inventory for Anthropogenic Carbon dioxide (ODIAC) is a high-spatial resolution global emission data product of CO₂ emissions from fossil fuel combustion (Oda and Maksyutov, 2011). ODIAC pioneered the combined use of space-based nighttime light data and individual power plant emission/location profiles to estimate the global spatial extent of fossil fuel CO₂ emissions. With the innovative emission modeling approach, ODIAC achieved the fine picture of global fossil fuel CO₂ emissions at a 1x1km.\n\n\n\nPick a collection to interact with. Let’s pick eccodarwin-co2flux-monthgrid-v5. This dataset represents the Air-Sea CO₂ flux, estimated using the ECCO (Estimating the Circulation and Climate of the Ocean) Darwin model.\nRead more about the dataset in the GHG Center Web Portal: https://earth.gov/ghgcenter/data-catalog/eccodarwin-co2flux-monthgrid-v5\n\ncollection = catalog.get_collection(\"eccodarwin-co2flux-monthgrid-v5\")\ncollection\n\n\n\n\n\n \n \n \n \n \n \n type\n \"Collection\"\n \n \n \n \n \n \n \n id\n \"eccodarwin-co2flux-monthgrid-v5\"\n \n \n \n \n \n \n \n stac_version\n \"1.0.0\"\n \n \n \n \n \n \n \n description\n \"Global, monthly average air-sea CO2 flux at ~1/3° resolution from 2020 to 2022\"\n \n \n \n \n \n \n \n links\n [] 4 items\n \n \n \n \n \n \n \n 0\n \n \n \n \n \n rel\n \"items\"\n \n \n \n \n \n \n \n href\n \"https://ghg.center/api/stac/collections/eccodarwin-co2flux-monthgrid-v5/items\"\n \n \n \n \n \n \n \n type\n \"application/geo+json\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 1\n \n \n \n \n \n rel\n \"parent\"\n \n \n \n \n \n \n \n href\n \"https://ghg.center/api/stac/\"\n \n \n \n \n \n \n \n type\n \"application/json\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 2\n \n \n \n \n \n rel\n \"root\"\n \n \n \n \n \n \n \n href\n \"https://ghg.center/api/stac\"\n \n \n \n \n \n \n \n type\n \"application/json\"\n \n \n \n \n \n \n \n title\n \"veda-stac\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 3\n \n \n \n \n \n rel\n \"self\"\n \n \n \n \n \n \n \n href\n \"https://ghg.center/api/stac/collections/eccodarwin-co2flux-monthgrid-v5\"\n \n \n \n \n \n \n \n type\n \"application/json\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n item_assets\n \n \n \n \n \n co2\n \n \n \n \n \n type\n \"image/tiff; application=geotiff; profile=cloud-optimized\"\n \n \n \n \n \n \n \n roles\n [] 2 items\n \n \n \n \n \n \n \n 0\n \"data\"\n \n \n \n \n \n \n \n \n \n \n \n 1\n \"layer\"\n \n \n \n \n \n \n \n \n \n \n \n \n title\n \"Air-Sea CO2 Flux\"\n \n \n \n \n \n \n \n description\n \"Monthly mean air-sea CO2 Flux (negative into ocean)\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n dashboard:is_periodic\n True\n \n \n \n \n \n \n \n dashboard:time_density\n \"month\"\n \n \n \n \n \n \n \n title\n \"Air-Sea CO2 Flux, ECCO-Darwin Model v5\"\n \n \n \n \n \n \n \n extent\n \n \n \n \n \n spatial\n \n \n \n \n \n bbox\n [] 1 items\n \n \n \n \n \n \n \n 0\n [] 4 items\n \n \n \n \n \n \n \n 0\n -180.125\n \n \n \n \n \n \n \n \n \n \n \n 1\n -90.12483215332031\n \n \n \n \n \n \n \n \n \n \n \n 2\n 179.875\n \n \n \n \n \n \n \n \n \n \n \n 3\n 89.87517547607422\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n temporal\n \n \n \n \n \n interval\n [] 1 items\n \n \n \n \n \n \n \n 0\n [] 2 items\n \n \n \n \n \n \n \n 0\n \"2020-01-01T00:00:00Z\"\n \n \n \n \n \n \n \n \n \n \n \n 1\n \"2022-12-31T00:00:00Z\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n license\n \"CC-BY-4.0\"\n \n \n \n \n \n \n \n summaries\n \n \n \n \n \n datetime\n [] 2 items\n \n \n \n \n \n \n \n 0\n \"2020-01-01T00:00:00Z\"\n \n \n \n \n \n \n \n \n \n \n \n 1\n \"2022-12-31T00:00:00Z\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n\n\n\nLet’s look at the items within the collection, using the CollectionClient.get_items method\n\n# get_items\nitems = list(collection.get_items())\n\n\nfor item in items[:10]:\n print(item)\n\n<Item id=eccodarwin-co2flux-monthgrid-v5-202212>\n<Item id=eccodarwin-co2flux-monthgrid-v5-202211>\n<Item id=eccodarwin-co2flux-monthgrid-v5-202210>\n<Item id=eccodarwin-co2flux-monthgrid-v5-202209>\n<Item id=eccodarwin-co2flux-monthgrid-v5-202208>\n<Item id=eccodarwin-co2flux-monthgrid-v5-202207>\n<Item id=eccodarwin-co2flux-monthgrid-v5-202206>\n<Item id=eccodarwin-co2flux-monthgrid-v5-202205>\n<Item id=eccodarwin-co2flux-monthgrid-v5-202204>\n<Item id=eccodarwin-co2flux-monthgrid-v5-202203>\n\n\n\nitem = collection.get_item(items[0].id) # item = collection.get_item(\"eccodarwin-co2flux-monthgrid-v5-202212\")\nitem\n\n\n\n\n\n \n \n \n \n \n \n type\n \"Feature\"\n \n \n \n \n \n \n \n stac_version\n \"1.0.0\"\n \n \n \n \n \n \n \n id\n \"eccodarwin-co2flux-monthgrid-v5-202212\"\n \n \n \n \n \n \n \n properties\n \n \n \n \n \n end_datetime\n \"2022-12-31T00:00:00+00:00\"\n \n \n \n \n \n \n \n start_datetime\n \"2022-12-01T00:00:00+00:00\"\n \n \n \n \n \n \n \n datetime\n None\n \n \n \n \n \n \n \n \n \n \n \n \n geometry\n \n \n \n \n \n type\n \"Polygon\"\n \n \n \n \n \n \n \n coordinates\n [] 1 items\n \n \n \n \n \n \n \n 0\n [] 5 items\n \n \n \n \n \n \n \n 0\n [] 2 items\n \n \n \n \n \n \n \n 0\n -180.125\n \n \n \n \n \n \n \n \n \n \n \n 1\n -90.124826629681\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 1\n [] 2 items\n \n \n \n \n \n \n \n 0\n 179.875\n \n \n \n \n \n \n \n \n \n \n \n 1\n -90.124826629681\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 2\n [] 2 items\n \n \n \n \n \n \n \n 0\n 179.875\n \n \n \n \n \n \n \n \n \n \n \n 1\n 89.875173370319\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 3\n [] 2 items\n \n \n \n \n \n \n \n 0\n -180.125\n \n \n \n \n \n \n \n \n \n \n \n 1\n 89.875173370319\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 4\n [] 2 items\n \n \n \n \n \n \n \n 0\n -180.125\n \n \n \n \n \n \n \n \n \n \n \n 1\n -90.124826629681\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n links\n [] 4 items\n \n \n \n \n \n \n \n 0\n \n \n \n \n \n rel\n \"self\"\n \n \n \n \n \n \n \n href\n \"https://ghg.center/api/stac/collections/eccodarwin-co2flux-monthgrid-v5/items/eccodarwin-co2flux-monthgrid-v5-202212\"\n \n \n \n \n \n \n \n type\n \"application/json\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 1\n \n \n \n \n \n rel\n \"collection\"\n \n \n \n \n \n \n \n href\n \"https://ghg.center/api/stac/collections/eccodarwin-co2flux-monthgrid-v5\"\n \n \n \n \n \n \n \n type\n \"application/json\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 2\n \n \n \n \n \n rel\n \"parent\"\n \n \n \n \n \n \n \n href\n \"https://ghg.center/api/stac/collections/eccodarwin-co2flux-monthgrid-v5\"\n \n \n \n \n \n \n \n type\n \"application/json\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 3\n \n \n \n \n \n rel\n \"root\"\n \n \n \n \n \n \n \n href\n \"https://ghg.center/api/stac/collections/eccodarwin-co2flux-monthgrid-v5\"\n \n \n \n \n \n \n \n type\n \"application/json\"\n \n \n \n \n \n \n \n title\n \"Air-Sea CO2 Flux, ECCO-Darwin Model v5\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n assets\n \n \n \n \n \n co2\n \n \n \n \n \n href\n \"s3://ghgc-data-store/eccodarwin-co2flux-monthgrid-v5/ECCO-Darwin_CO2_flux_202212.tif\"\n \n \n \n \n \n \n \n type\n \"image/tiff; application=geotiff\"\n \n \n \n \n \n \n \n title\n \"Air-Sea CO2 Flux\"\n \n \n \n \n \n \n \n description\n \"Monthly mean air-sea CO2 Flux (negative into ocean)\"\n \n \n \n \n \n \n \n proj:bbox\n [] 4 items\n \n \n \n \n \n \n \n 0\n -180.125\n \n \n \n \n \n \n \n \n \n \n \n 1\n -90.124826629681\n \n \n \n \n \n \n \n \n \n \n \n 2\n 179.875\n \n \n \n \n \n \n \n \n \n \n \n 3\n 89.875173370319\n \n \n \n \n \n \n \n \n \n \n \n \n proj:epsg\n 4326.0\n \n \n \n \n \n \n \n proj:shape\n [] 2 items\n \n \n \n \n \n \n \n 0\n 721.0\n \n \n \n \n \n \n \n \n \n \n \n 1\n 1440.0\n \n \n \n \n \n \n \n \n \n \n \n \n raster:bands\n [] 1 items\n \n \n \n \n \n \n \n 0\n \n \n \n \n \n scale\n 1.0\n \n \n \n \n \n \n \n offset\n 0.0\n \n \n \n \n \n \n \n sampling\n \"area\"\n \n \n \n \n \n \n \n data_type\n \"float64\"\n \n \n \n \n \n \n \n histogram\n \n \n \n \n \n max\n 1e+20\n \n \n \n \n \n \n \n min\n -0.0560546528687938\n \n \n \n \n \n \n \n count\n 11.0\n \n \n \n \n \n \n \n buckets\n [] 10 items\n \n \n \n \n \n \n \n 0\n 338606.0\n \n \n \n \n \n \n \n \n \n \n \n 1\n 0.0\n \n \n \n \n \n \n \n \n \n \n \n 2\n 0.0\n \n \n \n \n \n \n \n \n \n \n \n 3\n 0.0\n \n \n \n \n \n \n \n \n \n \n \n 4\n 0.0\n \n \n \n \n \n \n \n \n \n \n \n 5\n 0.0\n \n \n \n \n \n \n \n \n \n \n \n 6\n 0.0\n \n \n \n \n \n \n \n \n \n \n \n 7\n 0.0\n \n \n \n \n \n \n \n \n \n \n \n 8\n 0.0\n \n \n \n \n \n \n \n \n \n \n \n 9\n 186706.0\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n statistics\n \n \n \n \n \n mean\n 3.554192556042885e+19\n \n \n \n \n \n \n \n stddev\n 4.786401658343999e+19\n \n \n \n \n \n \n \n maximum\n 1e+20\n \n \n \n \n \n \n \n minimum\n -0.0560546528687938\n \n \n \n \n \n \n \n valid_percent\n 0.0001903630604288499\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n proj:geometry\n \n \n \n \n \n type\n \"Polygon\"\n \n \n \n \n \n \n \n coordinates\n [] 1 items\n \n \n \n \n \n \n \n 0\n [] 5 items\n \n \n \n \n \n \n \n 0\n [] 2 items\n \n \n \n \n \n \n \n 0\n -180.125\n \n \n \n \n \n \n \n \n \n \n \n 1\n -90.124826629681\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 1\n [] 2 items\n \n \n \n \n \n \n \n 0\n 179.875\n \n \n \n \n \n \n \n \n \n \n \n 1\n -90.124826629681\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 2\n [] 2 items\n \n \n \n \n \n \n \n 0\n 179.875\n \n \n \n \n \n \n \n \n \n \n \n 1\n 89.875173370319\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 3\n [] 2 items\n \n \n \n \n \n \n \n 0\n -180.125\n \n \n \n \n \n \n \n \n \n \n \n 1\n 89.875173370319\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 4\n [] 2 items\n \n \n \n \n \n \n \n 0\n -180.125\n \n \n \n \n \n \n \n \n \n \n \n 1\n -90.124826629681\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n proj:projjson\n \n \n \n \n \n id\n \n \n \n \n \n code\n 4326.0\n \n \n \n \n \n \n \n authority\n \"EPSG\"\n \n \n \n \n \n \n \n \n \n \n \n \n name\n \"WGS 84\"\n \n \n \n \n \n \n \n type\n \"GeographicCRS\"\n \n \n \n \n \n \n \n datum\n \n \n \n \n \n name\n \"World Geodetic System 1984\"\n \n \n \n \n \n \n \n type\n \"GeodeticReferenceFrame\"\n \n \n \n \n \n \n \n ellipsoid\n \n \n \n \n \n name\n \"WGS 84\"\n \n \n \n \n \n \n \n semi_major_axis\n 6378137.0\n \n \n \n \n \n \n \n inverse_flattening\n 298.257223563\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n $schema\n \"https://proj.org/schemas/v0.4/projjson.schema.json\"\n \n \n \n \n \n \n \n coordinate_system\n \n \n \n \n \n axis\n [] 2 items\n \n \n \n \n \n \n \n 0\n \n \n \n \n \n name\n \"Geodetic latitude\"\n \n \n \n \n \n \n \n unit\n \"degree\"\n \n \n \n \n \n \n \n direction\n \"north\"\n \n \n \n \n \n \n \n abbreviation\n \"Lat\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 1\n \n \n \n \n \n name\n \"Geodetic longitude\"\n \n \n \n \n \n \n \n unit\n \"degree\"\n \n \n \n \n \n \n \n direction\n \"east\"\n \n \n \n \n \n \n \n abbreviation\n \"Lon\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n subtype\n \"ellipsoidal\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n proj:transform\n [] 9 items\n \n \n \n \n \n \n \n 0\n 0.25\n \n \n \n \n \n \n \n \n \n \n \n 1\n 0.0\n \n \n \n \n \n \n \n \n \n \n \n 2\n -180.125\n \n \n \n \n \n \n \n \n \n \n \n 3\n 0.0\n \n \n \n \n \n \n \n \n \n \n \n 4\n -0.24965325936199723\n \n \n \n \n \n \n \n \n \n \n \n 5\n 89.875173370319\n \n \n \n \n \n \n \n \n \n \n \n 6\n 0.0\n \n \n \n \n \n \n \n \n \n \n \n 7\n 0.0\n \n \n \n \n \n \n \n \n \n \n \n 8\n 1.0\n \n \n \n \n \n \n \n \n \n \n \n \n roles\n [] 2 items\n \n \n \n \n \n \n \n 0\n \"data\"\n \n \n \n \n \n \n \n \n \n \n \n 1\n \"layer\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n bbox\n [] 4 items\n \n \n \n \n \n \n \n 0\n -180.125\n \n \n \n \n \n \n \n \n \n \n \n 1\n -90.124826629681\n \n \n \n \n \n \n \n \n \n \n \n 2\n 179.875\n \n \n \n \n \n \n \n \n \n \n \n 3\n 89.875173370319\n \n \n \n \n \n \n \n \n \n \n \n \n stac_extensions\n [] 2 items\n \n \n \n \n \n \n \n 0\n \"https://stac-extensions.github.io/raster/v1.1.0/schema.json\"\n \n \n \n \n \n \n \n \n \n \n \n 1\n \"https://stac-extensions.github.io/projection/v1.1.0/schema.json\"\n \n \n \n \n \n \n \n \n \n \n \n \n collection\n \"eccodarwin-co2flux-monthgrid-v5\"\n \n \n \n \n \n \n\n\n\n\nasset = item.assets[\"co2\"].href\nasset\n\n's3://ghgc-data-store/eccodarwin-co2flux-monthgrid-v5/ECCO-Darwin_CO2_flux_202212.tif'\n\n\nVisualize this asset using TiTiler\n\n# Define the TiTiler url\nTITILER_URL = \"https://ghg.center/api/raster\"\n\n\n# TiTiler preview endpoint\ncog_preview = f\"/cog/preview.png?url={asset}&rescale=-0.0007,0.0002&colormap_name=bwr\"\n\nUser requests.get to make a GET request for the preview\n\nresponse = requests.get(f\"{TITILER_URL}{cog_preview}\") #https://ghg.center/api/raster/cog/preview.png?url=s3://ghgc-data-store/eccodarwin-co2flux-monthgrid-v5/ECCO-Darwin_CO2_flux_202212.tif&rescale=-0.0007,0.0002&colormap_name=bwr\nresponse\n\n<Response [200]>\n\n\n\ndisplay(Image(response.content))\n\n\n\n\n\n\n\n\n\n\n\n# Rought AOI for Baltimore, MD area\nbaltimore_aoi = {\n \"type\": \"Polygon\",\n \"coordinates\": [\n [\n [\n -76.7413596126004,\n 39.37730408865011\n ],\n [\n -76.7413596126004,\n 39.20129583511198\n ],\n [\n -76.47249934044682,\n 39.20129583511198\n ],\n [\n -76.47249934044682,\n 39.37730408865011\n ],\n [\n -76.7413596126004,\n 39.37730408865011\n ]\n ]\n ],\n}\n\n\n# Search the catalog for the given collection, aoi and datetime\nsearch = catalog.search(\n max_items = 100,\n # limit = 5,\n collections = \"epa-ch4emission-yeargrid-v2express\",\n intersects = baltimore_aoi,\n datetime = \"2012-04-01/2015-12-31\",\n)\nitems = list(search.item_collection())\n\nlen(items)\n\n100\n\n\n\nitems[:5]\n\n[<Item id=oco2geos-co2-daygrid-v10r-20151231>,\n <Item id=lpjwsl-wetlandch4-daygrid-v1-20151231>,\n <Item id=oco2geos-co2-daygrid-v10r-20151230>,\n <Item id=lpjwsl-wetlandch4-daygrid-v1-20151230>,\n <Item id=oco2geos-co2-daygrid-v10r-20151229>]", + "section": "Libraries Used", + "text": "Libraries Used\n\nPySTAC Client\nFrom the PySTAC Client Documentation:\n\nThe STAC Python Client (pystac_client) is a Python package for working with STAC Catalogs and APIs that conform to the STAC and STAC API specs in a seamless way.\nPySTAC Client builds upon PySTAC through higher-level functionality and ability to leverage STAC API search endpoints.\n\nWe will use it to interact with the data catalog.\n\n\nRequests\nRequests (requests) is a simple HTTP library. Requests allows you to send HTTP requests extremely easily.\nWe will use it to make API requests.\nHere we import all the required libraries and modules.\n\nimport requests\n\nfrom pystac_client import Client\n\n# For displaying image in a jupyter notebook\nfrom IPython.display import Image, display\n\nLet’s define the data catalog (STAC catalog) API URL\n\n# STAC API root URL\nURL = 'https://ghg.center/api/stac'\n\nUse the pystac_client.Client module to connect to the catalog\n\ncatalog = Client.open(URL)\ncatalog\n\n\n\n\n\n \n \n \n \n \n \n type\n \"Catalog\"\n \n \n \n \n \n \n \n id\n \"stac-fastapi\"\n \n \n \n \n \n \n \n stac_version\n \"1.0.0\"\n \n \n \n \n \n \n \n description\n \"veda-stac\"\n \n \n \n \n \n \n \n links\n [] 23 items\n \n \n \n \n \n \n \n 0\n \n \n \n \n \n rel\n \"self\"\n \n \n \n \n \n \n \n href\n \"https://ghg.center/api/stac\"\n \n \n \n \n \n \n \n type\n \"application/json\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 1\n \n \n \n \n \n rel\n \"root\"\n \n \n \n \n \n \n \n href\n \"https://ghg.center/api/stac/\"\n \n \n \n \n \n \n \n type\n \"application/json\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 2\n \n \n \n \n \n rel\n \"data\"\n \n \n \n \n \n \n \n href\n \"https://ghg.center/api/stac/collections\"\n \n \n \n \n \n \n \n type\n \"application/json\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 3\n \n \n \n \n \n rel\n \"conformance\"\n \n \n \n \n \n \n \n href\n \"https://ghg.center/api/stac/conformance\"\n \n \n \n \n \n \n \n type\n \"application/json\"\n \n \n \n \n \n \n \n title\n \"STAC/WFS3 conformance classes implemented by this server\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 4\n \n \n \n \n \n rel\n \"search\"\n \n \n \n \n \n \n \n href\n \"https://ghg.center/api/stac/search\"\n \n \n \n \n \n \n \n type\n \"application/geo+json\"\n \n \n \n \n \n \n \n title\n \"STAC search\"\n \n \n \n \n \n \n \n method\n \"GET\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 5\n \n \n \n \n \n rel\n \"search\"\n \n \n \n \n \n \n \n href\n \"https://ghg.center/api/stac/search\"\n \n \n \n \n \n \n \n type\n \"application/geo+json\"\n \n \n \n \n \n \n \n title\n \"STAC search\"\n \n \n \n \n \n \n \n method\n \"POST\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 6\n \n \n \n \n \n rel\n \"child\"\n \n \n \n \n \n \n \n href\n \"https://ghg.center/api/stac/collections/epa-ch4emission-yeargrid-v2express-new\"\n \n \n \n \n \n \n \n type\n \"application/json\"\n \n \n \n \n \n \n \n title\n \"Gridded annual U.S. anthropogenic methane emissions 2012-2020\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 7\n \n \n \n \n \n rel\n \"child\"\n \n \n \n \n \n \n \n href\n \"https://ghg.center/api/stac/collections/lpjwsl-wetlandch4-monthgrid-v1\"\n \n \n \n \n \n \n \n type\n \"application/json\"\n \n \n \n \n \n \n \n title\n \"Wetland Methane Emissions, LPJ-wsl Model (Monthly)\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 8\n \n \n \n \n \n rel\n \"child\"\n \n \n \n \n \n \n \n href\n \"https://ghg.center/api/stac/collections/tm54dvar-ch4flux-monthgrid-v1\"\n \n \n \n \n \n \n \n type\n \"application/json\"\n \n \n \n \n \n \n \n title\n \"TM5-4DVar Isotopic CH4 Inverse Fluxes\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 9\n \n \n \n \n \n rel\n \"child\"\n \n \n \n \n \n \n \n href\n \"https://ghg.center/api/stac/collections/gosat-based-ch4budget-yeargrid-v1\"\n \n \n \n \n \n \n \n type\n \"application/json\"\n \n \n \n \n \n \n \n title\n \"GOSAT-based Top-down Methane Budgets.\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 10\n \n \n \n \n \n rel\n \"child\"\n \n \n \n \n \n \n \n href\n \"https://ghg.center/api/stac/collections/sedac-popdensity-yeargrid5yr-v4.11\"\n \n \n \n \n \n \n \n type\n \"application/json\"\n \n \n \n \n \n \n \n title\n \"SEDAC Gridded World Population Data\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 11\n \n \n \n \n \n rel\n \"child\"\n \n \n \n \n \n \n \n href\n \"https://ghg.center/api/stac/collections/tm54dvar-ch4flux-mask-monthgrid-v1\"\n \n \n \n \n \n \n \n type\n \"application/json\"\n \n \n \n \n \n \n \n title\n \"TM5-4DVar Isotopic CH4 Inverse Fluxes\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 12\n \n \n \n \n \n rel\n \"child\"\n \n \n \n \n \n \n \n href\n \"https://ghg.center/api/stac/collections/casagfed-carbonflux-monthgrid-v3\"\n \n \n \n \n \n \n \n type\n \"application/json\"\n \n \n \n \n \n \n \n title\n \"CASA GFED3 Land Carbon Flux\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 13\n \n \n \n \n \n rel\n \"child\"\n \n \n \n \n \n \n \n href\n \"https://ghg.center/api/stac/collections/oco2geos-co2-daygrid-v10r\"\n \n \n \n \n \n \n \n type\n \"application/json\"\n \n \n \n \n \n \n \n title\n \"OCO-2 GEOS Assimilated CO2 Concentrations\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 14\n \n \n \n \n \n rel\n \"child\"\n \n \n \n \n \n \n \n href\n \"https://ghg.center/api/stac/collections/lpjwsl-wetlandch4-daygrid-v1\"\n \n \n \n \n \n \n \n type\n \"application/json\"\n \n \n \n \n \n \n \n title\n \"Wetland Methane Emissions, LPJ-wsl Model (Daily)\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 15\n \n \n \n \n \n rel\n \"child\"\n \n \n \n \n \n \n \n href\n \"https://ghg.center/api/stac/collections/epa-ch4emission-yeargrid-v2express\"\n \n \n \n \n \n \n \n type\n \"application/json\"\n \n \n \n \n \n \n \n title\n \"Gridded annual U.S. anthropogenic methane emissions 2012-2020\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 16\n \n \n \n \n \n rel\n \"child\"\n \n \n \n \n \n \n \n href\n \"https://ghg.center/api/stac/collections/emit-ch4plume-v1\"\n \n \n \n \n \n \n \n type\n \"application/json\"\n \n \n \n \n \n \n \n title\n \"Methane Point Source Plume Complexes\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 17\n \n \n \n \n \n rel\n \"child\"\n \n \n \n \n \n \n \n href\n \"https://ghg.center/api/stac/collections/oco2-mip-meanco2budget-yeargrid-v1\"\n \n \n \n \n \n \n \n type\n \"application/json\"\n \n \n \n \n \n \n \n title\n \"Pilot top-down CO2 Budget constrained by the v10 OCO-2 MIP Version 1 mean for all the years\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 18\n \n \n \n \n \n rel\n \"child\"\n \n \n \n \n \n \n \n href\n \"https://ghg.center/api/stac/collections/oco2-mip-co2budget-yeargrid-v1\"\n \n \n \n \n \n \n \n type\n \"application/json\"\n \n \n \n \n \n \n \n title\n \"Pilot top-down CO2 Budget constrained by the v10 OCO-2 MIP Version 1\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 19\n \n \n \n \n \n rel\n \"child\"\n \n \n \n \n \n \n \n href\n \"https://ghg.center/api/stac/collections/eccodarwin-co2flux-monthgrid-v5\"\n \n \n \n \n \n \n \n type\n \"application/json\"\n \n \n \n \n \n \n \n title\n \"Air-Sea CO2 Flux, ECCO-Darwin Model v5\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 20\n \n \n \n \n \n rel\n \"child\"\n \n \n \n \n \n \n \n href\n \"https://ghg.center/api/stac/collections/odiac-ffco2-monthgrid-v2022\"\n \n \n \n \n \n \n \n type\n \"application/json\"\n \n \n \n \n \n \n \n title\n \"ODIAC Fossil Fuel CO₂ Emissions\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 21\n \n \n \n \n \n rel\n \"service-desc\"\n \n \n \n \n \n \n \n href\n \"https://ghg.center/api/stac/openapi.json\"\n \n \n \n \n \n \n \n type\n \"application/vnd.oai.openapi+json;version=3.0\"\n \n \n \n \n \n \n \n title\n \"OpenAPI service description\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 22\n \n \n \n \n \n rel\n \"service-doc\"\n \n \n \n \n \n \n \n href\n \"https://ghg.center/api/stac/docs\"\n \n \n \n \n \n \n \n type\n \"text/html\"\n \n \n \n \n \n \n \n title\n \"OpenAPI service documentation\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n conformsTo\n [] 16 items\n \n \n \n \n \n \n \n 0\n \"https://api.stacspec.org/v1.0.0/item-search\"\n \n \n \n \n \n \n \n \n \n \n \n 1\n \"http://www.opengis.net/spec/ogcapi-features-1/1.0/conf/core\"\n \n \n \n \n \n \n \n \n \n \n \n 2\n \"http://www.opengis.net/spec/cql2/1.0/conf/cql2-text\"\n \n \n \n \n \n \n \n \n \n \n \n 3\n \"https://api.stacspec.org/v1.0.0-rc.2/item-search#sort\"\n \n \n \n \n \n \n \n \n \n \n \n 4\n \"https://api.stacspec.org/v1.0.0/collections\"\n \n \n \n \n \n \n \n \n \n \n \n 5\n \"http://www.opengis.net/spec/ogcapi-features-1/1.0/conf/geojson\"\n \n \n \n \n \n \n \n \n \n \n \n 6\n \"http://www.opengis.net/spec/ogcapi-features-1/1.0/conf/oas30\"\n \n \n \n \n \n \n \n \n \n \n \n 7\n \"http://www.opengis.net/spec/ogcapi-features-3/1.0/conf/features-filter\"\n \n \n \n \n \n \n \n \n \n \n \n 8\n \"https://api.stacspec.org/v1.0.0/ogcapi-features\"\n \n \n \n \n \n \n \n \n \n \n \n 9\n \"https://api.stacspec.org/v1.0.0/core\"\n \n \n \n \n \n \n \n \n \n \n \n 10\n \"http://www.opengis.net/spec/ogcapi-features-3/1.0/conf/filter\"\n \n \n \n \n \n \n \n \n \n \n \n 11\n \"https://api.stacspec.org/v1.0.0-rc.2/item-search#filter\"\n \n \n \n \n \n \n \n \n \n \n \n 12\n \"https://api.stacspec.org/v1.0.0-rc.2/item-search#query\"\n \n \n \n \n \n \n \n \n \n \n \n 13\n \"https://api.stacspec.org/v1.0.0-rc.3/item-search#fields\"\n \n \n \n \n \n \n \n \n \n \n \n 14\n \"https://api.stacspec.org/v1.0.0-rc.2/item-search#context\"\n \n \n \n \n \n \n \n \n \n \n \n 15\n \"http://www.opengis.net/spec/cql2/1.0/conf/basic-cql2\"\n \n \n \n \n \n \n \n \n \n \n \n \n title\n \"veda-stac\"\n \n \n \n \n \n \n\n\n\nList all the datasets (collections) in the catalog\n\ncollections = catalog.get_collections()\ncollections = list(collections)\n\n\nfor collection in collections:\n # print(f\">> {collection.id}: \\n- {collection.description}\\n\")\n \n print(\">> \" + collection.id)\n print(\"- \" + collection.description + \"\\n\")\n\n>> epa-ch4emission-yeargrid-v2express-new\n- This gridded dataset represents an update to the original version 1 of the gridded GHGI from Maasakkers, et al., (2016). The annual files contain one year of emissions per source category but include a time dimension to make them suitable (COARDS-compliant) for atmospheric models. This main dataset also includes monthly source-specific methane emission scaling factors for those select sources with strong interannual variability.\n\n>> lpjwsl-wetlandch4-monthgrid-v1\n- Wetland methane emissions produced by the Lund–Potsdam–Jena Dynamic Global Vegetation Model (LPJ-DGVM) Wald Schnee und Landscaft version (LPJ-wsl). LPJ-wsl is a prognostic model used to simulate future changes in wetland emissions and independently verified with remote sensing data products. The LPJ-wsl model is regularly used in conjunction with NASA’s GEOS model to simulate the impact of wetlands and other methane sources on atmospheric methane concentrations.\n\n>> tm54dvar-ch4flux-monthgrid-v1\n- Global, monthly 1 degree resolution methane emission estimates from microbial, fossil and pyrogenic sources derived using inverse modeling, version 1.\n\n>> gosat-based-ch4budget-yeargrid-v1\n- Annual methane emissions gridded globally at 1° resolution for 2019, version.\n\n>> sedac-popdensity-yeargrid5yr-v4.11\n- The Gridded Population of the World, Version 4 (GPWv4): Population Density, Revision 11 consists of estimates of human population density (number of persons per square kilometer) based on counts consistent with national censuses and population registers, for the years 2000, 2005, 2010, 2015, and 2020. \n\n>> tm54dvar-ch4flux-mask-monthgrid-v1\n- Global, monthly 1 degree resolution methane emission estimates from microbial, fossil and pyrogenic sources derived using inverse modeling, version 1.\n\n>> casagfed-carbonflux-monthgrid-v3\n- This product provides Monthly average Net Primary Production (NPP), heterotrophic respiration (Rh), wildfire emissions (FIRE), and fuel wood burning emissions (FUEL) derived from the Carnegie-Ames-Stanford-Approach – Global Fire Emissions Database version 3 (CASA-GFED3) model.\n\n>> oco2geos-co2-daygrid-v10r\n- Daily, global 0.5 x 0.625 degree assimilated CO2 concentrations derived from OCO-2 satellite data, version 10r\n\n>> lpjwsl-wetlandch4-daygrid-v1\n- Wetland methane emissions produced by the Lund–Potsdam–Jena Dynamic Global Vegetation Model (LPJ-DGVM) Wald Schnee und Landscaft version (LPJ-wsl). LPJ-wsl is a prognostic model used to simulate future changes in wetland emissions and independently verified with remote sensing data products. The LPJ-wsl model is regularly used in conjunction with NASA’s GEOS model to simulate the impact of wetlands and other methane sources on atmospheric methane concentrations.\n\n>> epa-ch4emission-yeargrid-v2express\n- This gridded dataset represents an update to the original version 1 of the gridded GHGI from Maasakkers, et al., (2016). The annual files contain one year of emissions per source category but include a time dimension to make them suitable (COARDS-compliant) for atmospheric models. This main dataset also includes monthly source-specific methane emission scaling factors for those select sources with strong interannual variability.\n\n>> emit-ch4plume-v1\n- Methane plume complexes from point source emitters\n\n>> oco2-mip-meanco2budget-yeargrid-v1\n- National CO2 Budgets (2015-2020) inferred from atmospheric CO2 observations in support of the Global Stocktake\n\n>> oco2-mip-co2budget-yeargrid-v1\n- National CO2 Budgets (2015-2020) inferred from atmospheric CO2 observations in support of the Global Stocktake\n\n>> eccodarwin-co2flux-monthgrid-v5\n- Global, monthly average air-sea CO2 flux at ~1/3° resolution from 2020 to 2022\n\n>> odiac-ffco2-monthgrid-v2022\n- The Open-Data Inventory for Anthropogenic Carbon dioxide (ODIAC) is a high-spatial resolution global emission data product of CO₂ emissions from fossil fuel combustion (Oda and Maksyutov, 2011). ODIAC pioneered the combined use of space-based nighttime light data and individual power plant emission/location profiles to estimate the global spatial extent of fossil fuel CO₂ emissions. With the innovative emission modeling approach, ODIAC achieved the fine picture of global fossil fuel CO₂ emissions at a 1x1km.\n\n\n\nPick a collection to interact with. Let’s pick eccodarwin-co2flux-monthgrid-v5. This dataset represents the Air-Sea CO₂ flux, estimated using the ECCO (Estimating the Circulation and Climate of the Ocean) Darwin model.\nRead more about the dataset in the GHG Center Web Portal: https://earth.gov/ghgcenter/data-catalog/eccodarwin-co2flux-monthgrid-v5\n\ncollection = catalog.get_collection(\"eccodarwin-co2flux-monthgrid-v5\")\ncollection\n\n\n\n\n\n \n \n \n \n \n \n type\n \"Collection\"\n \n \n \n \n \n \n \n id\n \"eccodarwin-co2flux-monthgrid-v5\"\n \n \n \n \n \n \n \n stac_version\n \"1.0.0\"\n \n \n \n \n \n \n \n description\n \"Global, monthly average air-sea CO2 flux at ~1/3° resolution from 2020 to 2022\"\n \n \n \n \n \n \n \n links\n [] 4 items\n \n \n \n \n \n \n \n 0\n \n \n \n \n \n rel\n \"items\"\n \n \n \n \n \n \n \n href\n \"https://ghg.center/api/stac/collections/eccodarwin-co2flux-monthgrid-v5/items\"\n \n \n \n \n \n \n \n type\n \"application/geo+json\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 1\n \n \n \n \n \n rel\n \"parent\"\n \n \n \n \n \n \n \n href\n \"https://ghg.center/api/stac/\"\n \n \n \n \n \n \n \n type\n \"application/json\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 2\n \n \n \n \n \n rel\n \"root\"\n \n \n \n \n \n \n \n href\n \"https://ghg.center/api/stac\"\n \n \n \n \n \n \n \n type\n \"application/json\"\n \n \n \n \n \n \n \n title\n \"veda-stac\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 3\n \n \n \n \n \n rel\n \"self\"\n \n \n \n \n \n \n \n href\n \"https://ghg.center/api/stac/collections/eccodarwin-co2flux-monthgrid-v5\"\n \n \n \n \n \n \n \n type\n \"application/json\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n item_assets\n \n \n \n \n \n co2\n \n \n \n \n \n type\n \"image/tiff; application=geotiff; profile=cloud-optimized\"\n \n \n \n \n \n \n \n roles\n [] 2 items\n \n \n \n \n \n \n \n 0\n \"data\"\n \n \n \n \n \n \n \n \n \n \n \n 1\n \"layer\"\n \n \n \n \n \n \n \n \n \n \n \n \n title\n \"Air-Sea CO2 Flux\"\n \n \n \n \n \n \n \n description\n \"Monthly mean air-sea CO2 Flux (negative into ocean)\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n dashboard:is_periodic\n True\n \n \n \n \n \n \n \n dashboard:time_density\n \"month\"\n \n \n \n \n \n \n \n title\n \"Air-Sea CO2 Flux, ECCO-Darwin Model v5\"\n \n \n \n \n \n \n \n extent\n \n \n \n \n \n spatial\n \n \n \n \n \n bbox\n [] 1 items\n \n \n \n \n \n \n \n 0\n [] 4 items\n \n \n \n \n \n \n \n 0\n -180.125\n \n \n \n \n \n \n \n \n \n \n \n 1\n -90.12483215332031\n \n \n \n \n \n \n \n \n \n \n \n 2\n 179.875\n \n \n \n \n \n \n \n \n \n \n \n 3\n 89.87517547607422\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n temporal\n \n \n \n \n \n interval\n [] 1 items\n \n \n \n \n \n \n \n 0\n [] 2 items\n \n \n \n \n \n \n \n 0\n \"2020-01-01T00:00:00Z\"\n \n \n \n \n \n \n \n \n \n \n \n 1\n \"2022-12-31T00:00:00Z\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n license\n \"CC-BY-4.0\"\n \n \n \n \n \n \n \n summaries\n \n \n \n \n \n datetime\n [] 2 items\n \n \n \n \n \n \n \n 0\n \"2020-01-01T00:00:00Z\"\n \n \n \n \n \n \n \n \n \n \n \n 1\n \"2022-12-31T00:00:00Z\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n\n\n\nLet’s look at the items within the collection, using the CollectionClient.get_items method\n\n# get_items\nitems = list(collection.get_items())\n\n\nfor item in items[:10]:\n print(item)\n\n<Item id=eccodarwin-co2flux-monthgrid-v5-202212>\n<Item id=eccodarwin-co2flux-monthgrid-v5-202211>\n<Item id=eccodarwin-co2flux-monthgrid-v5-202210>\n<Item id=eccodarwin-co2flux-monthgrid-v5-202209>\n<Item id=eccodarwin-co2flux-monthgrid-v5-202208>\n<Item id=eccodarwin-co2flux-monthgrid-v5-202207>\n<Item id=eccodarwin-co2flux-monthgrid-v5-202206>\n<Item id=eccodarwin-co2flux-monthgrid-v5-202205>\n<Item id=eccodarwin-co2flux-monthgrid-v5-202204>\n<Item id=eccodarwin-co2flux-monthgrid-v5-202203>\n\n\n\nitem = collection.get_item(items[0].id) # item = collection.get_item(\"eccodarwin-co2flux-monthgrid-v5-202212\")\nitem\n\n\n\n\n\n \n \n \n \n \n \n type\n \"Feature\"\n \n \n \n \n \n \n \n stac_version\n \"1.0.0\"\n \n \n \n \n \n \n \n id\n \"eccodarwin-co2flux-monthgrid-v5-202212\"\n \n \n \n \n \n \n \n properties\n \n \n \n \n \n end_datetime\n \"2022-12-31T00:00:00+00:00\"\n \n \n \n \n \n \n \n start_datetime\n \"2022-12-01T00:00:00+00:00\"\n \n \n \n \n \n \n \n datetime\n None\n \n \n \n \n \n \n \n \n \n \n \n \n geometry\n \n \n \n \n \n type\n \"Polygon\"\n \n \n \n \n \n \n \n coordinates\n [] 1 items\n \n \n \n \n \n \n \n 0\n [] 5 items\n \n \n \n \n \n \n \n 0\n [] 2 items\n \n \n \n \n \n \n \n 0\n -180.125\n \n \n \n \n \n \n \n \n \n \n \n 1\n -90.124826629681\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 1\n [] 2 items\n \n \n \n \n \n \n \n 0\n 179.875\n \n \n \n \n \n \n \n \n \n \n \n 1\n -90.124826629681\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 2\n [] 2 items\n \n \n \n \n \n \n \n 0\n 179.875\n \n \n \n \n \n \n \n \n \n \n \n 1\n 89.875173370319\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 3\n [] 2 items\n \n \n \n \n \n \n \n 0\n -180.125\n \n \n \n \n \n \n \n \n \n \n \n 1\n 89.875173370319\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 4\n [] 2 items\n \n \n \n \n \n \n \n 0\n -180.125\n \n \n \n \n \n \n \n \n \n \n \n 1\n -90.124826629681\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n links\n [] 4 items\n \n \n \n \n \n \n \n 0\n \n \n \n \n \n rel\n \"self\"\n \n \n \n \n \n \n \n href\n \"https://ghg.center/api/stac/collections/eccodarwin-co2flux-monthgrid-v5/items/eccodarwin-co2flux-monthgrid-v5-202212\"\n \n \n \n \n \n \n \n type\n \"application/json\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 1\n \n \n \n \n \n rel\n \"collection\"\n \n \n \n \n \n \n \n href\n \"https://ghg.center/api/stac/collections/eccodarwin-co2flux-monthgrid-v5\"\n \n \n \n \n \n \n \n type\n \"application/json\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 2\n \n \n \n \n \n rel\n \"parent\"\n \n \n \n \n \n \n \n href\n \"https://ghg.center/api/stac/collections/eccodarwin-co2flux-monthgrid-v5\"\n \n \n \n \n \n \n \n type\n \"application/json\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 3\n \n \n \n \n \n rel\n \"root\"\n \n \n \n \n \n \n \n href\n \"https://ghg.center/api/stac/collections/eccodarwin-co2flux-monthgrid-v5\"\n \n \n \n \n \n \n \n type\n \"application/json\"\n \n \n \n \n \n \n \n title\n \"Air-Sea CO2 Flux, ECCO-Darwin Model v5\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n assets\n \n \n \n \n \n co2\n \n \n \n \n \n href\n \"s3://ghgc-data-store/eccodarwin-co2flux-monthgrid-v5/ECCO-Darwin_CO2_flux_202212.tif\"\n \n \n \n \n \n \n \n type\n \"image/tiff; application=geotiff\"\n \n \n \n \n \n \n \n title\n \"Air-Sea CO2 Flux\"\n \n \n \n \n \n \n \n description\n \"Monthly mean air-sea CO2 Flux (negative into ocean)\"\n \n \n \n \n \n \n \n proj:bbox\n [] 4 items\n \n \n \n \n \n \n \n 0\n -180.125\n \n \n \n \n \n \n \n \n \n \n \n 1\n -90.124826629681\n \n \n \n \n \n \n \n \n \n \n \n 2\n 179.875\n \n \n \n \n \n \n \n \n \n \n \n 3\n 89.875173370319\n \n \n \n \n \n \n \n \n \n \n \n \n proj:epsg\n 4326.0\n \n \n \n \n \n \n \n proj:shape\n [] 2 items\n \n \n \n \n \n \n \n 0\n 721.0\n \n \n \n \n \n \n \n \n \n \n \n 1\n 1440.0\n \n \n \n \n \n \n \n \n \n \n \n \n raster:bands\n [] 1 items\n \n \n \n \n \n \n \n 0\n \n \n \n \n \n scale\n 1.0\n \n \n \n \n \n \n \n offset\n 0.0\n \n \n \n \n \n \n \n sampling\n \"area\"\n \n \n \n \n \n \n \n data_type\n \"float64\"\n \n \n \n \n \n \n \n histogram\n \n \n \n \n \n max\n 1e+20\n \n \n \n \n \n \n \n min\n -0.0560546528687938\n \n \n \n \n \n \n \n count\n 11.0\n \n \n \n \n \n \n \n buckets\n [] 10 items\n \n \n \n \n \n \n \n 0\n 338606.0\n \n \n \n \n \n \n \n \n \n \n \n 1\n 0.0\n \n \n \n \n \n \n \n \n \n \n \n 2\n 0.0\n \n \n \n \n \n \n \n \n \n \n \n 3\n 0.0\n \n \n \n \n \n \n \n \n \n \n \n 4\n 0.0\n \n \n \n \n \n \n \n \n \n \n \n 5\n 0.0\n \n \n \n \n \n \n \n \n \n \n \n 6\n 0.0\n \n \n \n \n \n \n \n \n \n \n \n 7\n 0.0\n \n \n \n \n \n \n \n \n \n \n \n 8\n 0.0\n \n \n \n \n \n \n \n \n \n \n \n 9\n 186706.0\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n statistics\n \n \n \n \n \n mean\n 3.554192556042885e+19\n \n \n \n \n \n \n \n stddev\n 4.786401658343999e+19\n \n \n \n \n \n \n \n maximum\n 1e+20\n \n \n \n \n \n \n \n minimum\n -0.0560546528687938\n \n \n \n \n \n \n \n valid_percent\n 0.0001903630604288499\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n proj:geometry\n \n \n \n \n \n type\n \"Polygon\"\n \n \n \n \n \n \n \n coordinates\n [] 1 items\n \n \n \n \n \n \n \n 0\n [] 5 items\n \n \n \n \n \n \n \n 0\n [] 2 items\n \n \n \n \n \n \n \n 0\n -180.125\n \n \n \n \n \n \n \n \n \n \n \n 1\n -90.124826629681\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 1\n [] 2 items\n \n \n \n \n \n \n \n 0\n 179.875\n \n \n \n \n \n \n \n \n \n \n \n 1\n -90.124826629681\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 2\n [] 2 items\n \n \n \n \n \n \n \n 0\n 179.875\n \n \n \n \n \n \n \n \n \n \n \n 1\n 89.875173370319\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 3\n [] 2 items\n \n \n \n \n \n \n \n 0\n -180.125\n \n \n \n \n \n \n \n \n \n \n \n 1\n 89.875173370319\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 4\n [] 2 items\n \n \n \n \n \n \n \n 0\n -180.125\n \n \n \n \n \n \n \n \n \n \n \n 1\n -90.124826629681\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n proj:projjson\n \n \n \n \n \n id\n \n \n \n \n \n code\n 4326.0\n \n \n \n \n \n \n \n authority\n \"EPSG\"\n \n \n \n \n \n \n \n \n \n \n \n \n name\n \"WGS 84\"\n \n \n \n \n \n \n \n type\n \"GeographicCRS\"\n \n \n \n \n \n \n \n datum\n \n \n \n \n \n name\n \"World Geodetic System 1984\"\n \n \n \n \n \n \n \n type\n \"GeodeticReferenceFrame\"\n \n \n \n \n \n \n \n ellipsoid\n \n \n \n \n \n name\n \"WGS 84\"\n \n \n \n \n \n \n \n semi_major_axis\n 6378137.0\n \n \n \n \n \n \n \n inverse_flattening\n 298.257223563\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n $schema\n \"https://proj.org/schemas/v0.4/projjson.schema.json\"\n \n \n \n \n \n \n \n coordinate_system\n \n \n \n \n \n axis\n [] 2 items\n \n \n \n \n \n \n \n 0\n \n \n \n \n \n name\n \"Geodetic latitude\"\n \n \n \n \n \n \n \n unit\n \"degree\"\n \n \n \n \n \n \n \n direction\n \"north\"\n \n \n \n \n \n \n \n abbreviation\n \"Lat\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n 1\n \n \n \n \n \n name\n \"Geodetic longitude\"\n \n \n \n \n \n \n \n unit\n \"degree\"\n \n \n \n \n \n \n \n direction\n \"east\"\n \n \n \n \n \n \n \n abbreviation\n \"Lon\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n subtype\n \"ellipsoidal\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n proj:transform\n [] 9 items\n \n \n \n \n \n \n \n 0\n 0.25\n \n \n \n \n \n \n \n \n \n \n \n 1\n 0.0\n \n \n \n \n \n \n \n \n \n \n \n 2\n -180.125\n \n \n \n \n \n \n \n \n \n \n \n 3\n 0.0\n \n \n \n \n \n \n \n \n \n \n \n 4\n -0.24965325936199723\n \n \n \n \n \n \n \n \n \n \n \n 5\n 89.875173370319\n \n \n \n \n \n \n \n \n \n \n \n 6\n 0.0\n \n \n \n \n \n \n \n \n \n \n \n 7\n 0.0\n \n \n \n \n \n \n \n \n \n \n \n 8\n 1.0\n \n \n \n \n \n \n \n \n \n \n \n \n roles\n [] 2 items\n \n \n \n \n \n \n \n 0\n \"data\"\n \n \n \n \n \n \n \n \n \n \n \n 1\n \"layer\"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n bbox\n [] 4 items\n \n \n \n \n \n \n \n 0\n -180.125\n \n \n \n \n \n \n \n \n \n \n \n 1\n -90.124826629681\n \n \n \n \n \n \n \n \n \n \n \n 2\n 179.875\n \n \n \n \n \n \n \n \n \n \n \n 3\n 89.875173370319\n \n \n \n \n \n \n \n \n \n \n \n \n stac_extensions\n [] 2 items\n \n \n \n \n \n \n \n 0\n \"https://stac-extensions.github.io/raster/v1.1.0/schema.json\"\n \n \n \n \n \n \n \n \n \n \n \n 1\n \"https://stac-extensions.github.io/projection/v1.1.0/schema.json\"\n \n \n \n \n \n \n \n \n \n \n \n \n collection\n \"eccodarwin-co2flux-monthgrid-v5\"\n \n \n \n \n \n \n\n\n\n\nasset = item.assets[\"co2\"].href\nasset\n\n's3://ghgc-data-store/eccodarwin-co2flux-monthgrid-v5/ECCO-Darwin_CO2_flux_202212.tif'\n\n\nVisualize this asset using TiTiler\n\n# Define the TiTiler url\nTITILER_URL = \"https://ghg.center/api/raster\"\n\n\n# TiTiler preview endpoint\ncog_preview = f\"/cog/preview.png?url={asset}&rescale=-0.0007,0.0002&colormap_name=bwr\"\n\nUser requests.get to make a GET request for the preview\n\nresponse = requests.get(f\"{TITILER_URL}{cog_preview}\") #https://ghg.center/api/raster/cog/preview.png?url=s3://ghgc-data-store/eccodarwin-co2flux-monthgrid-v5/ECCO-Darwin_CO2_flux_202212.tif&rescale=-0.0007,0.0002&colormap_name=bwr\nresponse\n\n<Response [200]>\n\n\n\ndisplay(Image(response.content))\n\n\n\n\n\n\n\n\n\nSearching for datasets based on the Area of Interest (AOI) and/or datetime\n\n# Rought AOI for Baltimore, MD area\nbaltimore_aoi = {\n \"type\": \"Polygon\",\n \"coordinates\": [\n [\n [\n -76.7413596126004,\n 39.37730408865011\n ],\n [\n -76.7413596126004,\n 39.20129583511198\n ],\n [\n -76.47249934044682,\n 39.20129583511198\n ],\n [\n -76.47249934044682,\n 39.37730408865011\n ],\n [\n -76.7413596126004,\n 39.37730408865011\n ]\n ]\n ],\n}\n\n\n# Search the catalog for the given collection, aoi and datetime\nsearch = catalog.search(\n max_items = 100,\n # limit = 5,\n collections = \"epa-ch4emission-yeargrid-v2express\",\n intersects = baltimore_aoi,\n datetime = \"2012-04-01/2015-12-31\",\n)\nitems = list(search.item_collection())\n\nlen(items)\n\n100\n\n\n\nitems[:5]\n\n[<Item id=oco2geos-co2-daygrid-v10r-20151231>,\n <Item id=lpjwsl-wetlandch4-daygrid-v1-20151231>,\n <Item id=oco2geos-co2-daygrid-v10r-20151230>,\n <Item id=lpjwsl-wetlandch4-daygrid-v1-20151230>,\n <Item id=oco2geos-co2-daygrid-v10r-20151229>]", "crumbs": [ "Home", "Sections", @@ -891,8 +891,8 @@ "objectID": "sections/us-ghg-center-and-veda/catalog-interaction.html#summary", "href": "sections/us-ghg-center-and-veda/catalog-interaction.html#summary", "title": "Accessing and using the US GHG Center Data Catalog", - "section": "", - "text": "In this notebook, we used the pystac_client library to interact with the US GHG Center Data Catalog. We learned how to list all the datasets, list all the items in a dataset, read the metadata for the dataset/items, access the data file, visualize it and finally search the catalog for specific area of interest and datetime.", + "section": "Summary", + "text": "Summary\nIn this notebook, we used the pystac_client library to interact with the US GHG Center Data Catalog. We learned how to list all the datasets, list all the items in a dataset, read the metadata for the dataset/items, access the data file, visualize it and finally search the catalog for specific area of interest and datetime.", "crumbs": [ "Home", "Sections", diff --git a/sections/us-ghg-center-and-veda/catalog-interaction.html b/sections/us-ghg-center-and-veda/catalog-interaction.html index 87afb4a..d0eb8c3 100644 --- a/sections/us-ghg-center-and-veda/catalog-interaction.html +++ b/sections/us-ghg-center-and-veda/catalog-interaction.html @@ -349,8 +349,6 @@
The US GHG Center uses a Spatio-Temporal Asset Catalog (STAC) to catalog it listing of datasets. This tutorial teaches the basics of searching and accessing datasets using the US GHG Center STAC catalog.
In this notebook, we used the pystac_client
library to interact with the US GHG Center Data Catalog. We learned how to list all the datasets, list all the items in a dataset, read the metadata for the dataset/items, access the data file, visualize it and finally search the catalog for specific area of interest and datetime.