{"pack_id":"volcanoes","pack_name":"Volcanoes","pack_version":"1.1.0","title":"Volcanoes","description":"Global volcanic eruption records from the Smithsonian GVP, including VEI, duration, and eruption-history detail for both recent and deep-history volcanic activity.","catalog_short_description":"55500 BCE - 2026, 11,084 volcanic eruption events worldwide. Full timestamp coverage from 1800 onward.","license":"Smithsonian GVP Terms of Use (non-commercial)","material_policy":{"schema_version":"1.2.0","object_kind":"pack","object_id":"volcanoes","policy_source":"build/catalog/license_permission_crosswalk.csv","permission":"free","licenses":["Smithsonian GVP Terms of Use (non-commercial)"],"resolution_status":"resolved","hosted_access":{"maximum_lane":"free","publication_ready":true,"free_allowed":true,"paid_allowed":false,"reason_codes":["paid_hosted_not_permitted","redistribution_not_permitted"]},"redistribution":{"status":"restricted","allowed":false,"share_alike":"no"},"reuse_obligations":[],"surface_access":{"hosted_results":true,"server_rendered_display":true,"client_geometry":false,"download":false,"blocked_by_source_review":[],"restrictions":[]},"attribution":{"required":true,"status":"resolved","text":"Global Volcanism Program, Smithsonian Institution. Volcanoes.","lines":["Global Volcanism Program, Smithsonian Institution. Volcanoes."]},"citation":{"style":"daedalmap-1","entries":[{"text":"Smithsonian Institution Global Volcanism Program. Volcanoes. Smithsonian GVP Terms of Use (non-commercial). https://volcano.si.edu/.","role":"data","parts":{"role":"data","agency":"Smithsonian Institution Global Volcanism Program","title":"Volcanoes","vintage":"","url":"https://volcano.si.edu/","license":"Smithsonian GVP Terms of Use (non-commercial)"}}],"text":"Smithsonian Institution Global Volcanism Program. Volcanoes. Smithsonian GVP Terms of Use (non-commercial). https://volcano.si.edu/."},"license_evidence":[{"license":"Smithsonian GVP Terms of Use (non-commercial)","source_url":"https://volcano.si.edu/gvp_termsofuse.cfm","reviewed_on":"2026-09-10"}],"facts_fingerprint":"1f338c1a1eb86bbfa7eea1cb236712649a1d0749ea5176eaa5d5c8be8fbf5ec1","policy_fingerprint":"123740dd765e310006fb5f503611d126185258df4412f6d75314d33948deb949"},"upstream_sources":[{"agency":"Smithsonian Institution Global Volcanism Program","agency_short":"Smithsonian GVP","license":"Smithsonian GVP Terms of Use (non-commercial)","notes":"Sole upstream. GVP eruption catalog with VEI ratings, duration, and impact data. Holocene to present.","source_id":"smithsonian_gvp","source_url":"https://volcano.si.edu/"}],"quick_start":{"why_it_exists":"Use this pack for volcanic event counts, VEI comparisons, and eruption-focused country queries.","start_here":["Use source_id = 'volcanoes_events' for execution.","Use metrics = ['event_count'] for the easiest first query.","Pass numeric years such as time.value = 2020 or a numeric year range.","Start with ISO3 region_ids such as IDN, JPN, and CHL."],"first_query_template":{"source_id":"volcanoes_events","metrics":["event_count"],"filters":{"region_ids":["IDN","JPN","CHL"],"time":{"value":2020}},"sort":{"field":"value","direction":"desc"},"limit":25},"important_rules":["use the exact metric ids shown in pack detail; casing matters","generate a fresh request_id for each real query when tracing matters","volcanoes uses numeric years rather than ISO date strings","event_count is the easiest first metric for cross-country comparisons","event_count may be simplest as its own query; switch to raw event metrics like VEI in a separate query when needed","broad multi-year event scans may need region_ids or a narrower time window before the live API will allow them","use VEI when you want eruption intensity instead of simple counts","volcanoes is currently a free lane"],"starter_metrics":["event_count","VEI"],"starter_sources":["volcanoes_events"]},"discovery_model":{"role":"pack_detail","purpose":"rich_free_discovery","pack_catalog_includes_source_execution_summaries":true,"separate_source_catalog_required":false},"source_count":2,"source_ids":["volcano_aggregates","volcanoes_events"],"data_types":["events","metrics"],"category":"disasters","location":{"scopes":["ATA"],"geographic_levels":[2],"empty_geographic_levels_meaning":"not_declared","coverage_contract":{"assertions":["explicit_countries","regional_countries_not_declared"],"worldwide":false,"countries":["ATA"],"excluded_countries":["AFG","AGO","ALB","AND","ARE","ATG","AUT","AZE","BDI","BEL","BEN","BFA","BGD","BGR","BHR","BHS","BIH","BLR","BLZ","BOL","BRA","BRB","BRN","BTN","BWA","CAF","CHE","CIV","COG","COK","CUB","CYP","CZE","DMA","DNK","DOM","DZA","EGY","EST","FIN","FSM","GAB","GBR","GHA","GIN","GMB","GNB","GRD","GUY","HKG","HRV","HTI","HUN","IRL","IRQ","ISR","JAM","JOR","KAZ","KGZ","KHM","KIR","KNA","KWT","LAO","LBN","LBR","LBY","LIE","LKA","LSO","LTU","LUX","LVA","MAC","MAR","MCO","MDA","MDG","MDV","MHL","MKD","MLI","MLT","MNE","MOZ","MRT","MUS","MWI","MYS","NAM","NER","NGA","NIU","NLD","NOR","NPL","NRU","OMN","PAK","PLW","POL","PRK","PRY","PSE","QAT","ROU","RWA","SEN","SGP","SLE","SMR","SOM","SRB","SSD","STP","SUR","SVK","SVN","SWE","SWZ","SYC","SYR","TCD","TGO","THA","TJK","TKM","TLS","TTO","TUN","TUV","UKR","URY","UZB","VAT","VCT","VEN","VNM","ZAF","ZMB","ZWE"],"unknown_country_coverage":true},"coverage_description":"63/200 common","geographic_coverage":[{"type":"global","countries":null,"admin_levels":[2],"common_count":63,"common_missing":["AFG","AGO","ALB","AND","ARE","ATG","AUT","BDI","BEL","BEN","BFA","BGD","BGR","BHR","BHS","BIH","BLR","BLZ","BRA","BRB","BRN","BTN","BWA","CAF","CHE","CIV","COG","COK","CUB","CYP","CZE","DMA","DNK","DOM","DZA","EGY","EST","FIN","FSM","GAB","GBR","GHA","GIN","GMB","GNB","GRD","GUY","HKG","HRV","HTI","HUN","IRL","IRQ","ISR","JAM","KAZ","KGZ","KHM","KIR","KNA","KWT","LAO","LBN","LBR","LBY","LIE","LKA","LSO","LTU","LUX","LVA","MAC","MAR","MCO","MDA","MDV","MHL","MKD","MLI","MLT","MNE","MOZ","MRT","MUS","MWI","MYS","NAM","NER","NGA","NIU","NLD","NOR","NPL","NRU","OMN","PAK","PLW","POL","PRY","PSE","QAT","ROU","RWA","SEN","SGP","SLE","SMR","SOM","SRB","SSD","STP","SUR","SVK","SVN","SWE","SWZ","SYC","SYR","TCD","TGO","THA","TJK","TKM","TLS","TTO","TUN","TUV","UKR","URY","UZB","VAT","VCT","VEN","VNM","ZAF","ZMB","ZWE"],"uncommonly_included":[],"region_coverage":{}},{"type":"global","countries":null,"admin_levels":[2],"common_count":68,"common_missing":["AFG","AGO","ALB","AND","ARE","ATG","AUT","AZE","BDI","BEL","BEN","BFA","BGD","BGR","BHR","BHS","BIH","BLR","BLZ","BOL","BRA","BRB","BRN","BTN","BWA","CAF","CHE","CIV","COG","COK","CUB","CYP","CZE","DNK","DOM","DZA","EGY","EST","FIN","FSM","GAB","GHA","GIN","GMB","GNB","GUY","HKG","HRV","HTI","HUN","IRL","IRQ","ISR","JAM","JOR","KAZ","KGZ","KHM","KIR","KWT","LAO","LBN","LBR","LBY","LIE","LKA","LSO","LTU","LUX","LVA","MAC","MAR","MCO","MDA","MDG","MDV","MHL","MKD","MLI","MLT","MNE","MOZ","MRT","MUS","MWI","MYS","NAM","NER","NGA","NIU","NPL","NRU","OMN","PAK","PLW","POL","PRK","PRY","PSE","QAT","ROU","RWA","SEN","SGP","SLE","SMR","SOM","SRB","SSD","STP","SUR","SVK","SVN","SWE","SWZ","SYC","TCD","TGO","THA","TJK","TKM","TLS","TTO","TUN","TUV","UKR","URY","UZB","VAT","VEN","ZMB","ZWE"],"uncommonly_included":["ATA"],"region_coverage":{}}]},"coverage_windows":[{"source_id":"volcanoes_events","coverage_contract":{"assertion":"explicit_countries","scopes":["ATA"],"countries":["ATA"],"worldwide":false,"excluded_countries":["AFG","AGO","ALB","AND","ARE","ATG","AUT","AZE","BDI","BEL","BEN","BFA","BGD","BGR","BHR","BHS","BIH","BLR","BLZ","BOL","BRA","BRB","BRN","BTN","BWA","CAF","CHE","CIV","COG","COK","CUB","CYP","CZE","DNK","DOM","DZA","EGY","EST","FIN","FSM","GAB","GHA","GIN","GMB","GNB","GUY","HKG","HRV","HTI","HUN","IRL","IRQ","ISR","JAM","JOR","KAZ","KGZ","KHM","KIR","KWT","LAO","LBN","LBR","LBY","LIE","LKA","LSO","LTU","LUX","LVA","MAC","MAR","MCO","MDA","MDG","MDV","MHL","MKD","MLI","MLT","MNE","MOZ","MRT","MUS","MWI","MYS","NAM","NER","NGA","NIU","NPL","NRU","OMN","PAK","PLW","POL","PRK","PRY","PSE","QAT","ROU","RWA","SEN","SGP","SLE","SMR","SOM","SRB","SSD","STP","SUR","SVK","SVN","SWE","SWZ","SYC","TCD","TGO","THA","TJK","TKM","TLS","TTO","TUN","TUV","UKR","URY","UZB","VAT","VEN","ZMB","ZWE"],"geographic_levels":[],"empty_geographic_levels_meaning":"not_declared"},"temporal_start":-55500,"temporal_end":2026},{"source_id":"volcano_aggregates","coverage_contract":{"assertion":"regional_countries_not_declared","scopes":["unknown"],"countries":[],"worldwide":false,"excluded_countries":["AFG","AGO","ALB","AND","ARE","ATG","AUT","BDI","BEL","BEN","BFA","BGD","BGR","BHR","BHS","BIH","BLR","BLZ","BRA","BRB","BRN","BTN","BWA","CAF","CHE","CIV","COG","COK","CUB","CYP","CZE","DMA","DNK","DOM","DZA","EGY","EST","FIN","FSM","GAB","GBR","GHA","GIN","GMB","GNB","GRD","GUY","HKG","HRV","HTI","HUN","IRL","IRQ","ISR","JAM","KAZ","KGZ","KHM","KIR","KNA","KWT","LAO","LBN","LBR","LBY","LIE","LKA","LSO","LTU","LUX","LVA","MAC","MAR","MCO","MDA","MDV","MHL","MKD","MLI","MLT","MNE","MOZ","MRT","MUS","MWI","MYS","NAM","NER","NGA","NIU","NLD","NOR","NPL","NRU","OMN","PAK","PLW","POL","PRY","PSE","QAT","ROU","RWA","SEN","SGP","SLE","SMR","SOM","SRB","SSD","STP","SUR","SVK","SVN","SWE","SWZ","SYC","SYR","TCD","TGO","THA","TJK","TKM","TLS","TTO","TUN","TUV","UKR","URY","UZB","VAT","VCT","VEN","VNM","ZAF","ZMB","ZWE"],"geographic_levels":[2],"empty_geographic_levels_meaning":null},"temporal_start":-55500,"temporal_end":2026}],"topic_tags":["admin2","aggregate","county","disasters","eruptions","hazard","volcanoes"],"temporal_coverage":{"start":"-55500","end":"2026"},"coverage_description":"63/200 common","metric_count":19,"metrics":{"event_count":"Count of events matching the applied filters","max_vei":"Max VEI","avg_vei":"Average VEI","avg_duration_days":"Average eruption duration","deaths":"Number of deaths attributed to the eruption","injuries":"Number of injuries attributed to the eruption","VEI":"Volcanic Explosivity Index (0-8 scale)","damage_radius_km":"Estimated radius of structural damage","damage_usd":"Estimated damage in USD","duration_days":"Duration of eruption in days","end_year":"End Year","eruption_id":"Eruption Id","felt_radius_km":"Estimated radius where eruption effects were felt","houses_destroyed":"Number of houses destroyed","is_ongoing":"Whether the eruption is currently ongoing","missing":"Number of missing persons","noaa_id":"Noaa Id","sibling_level":"Sibling Level","volcano_number":"Volcano Number"},"supported_query_shapes":["filtered_event_query","multi_year_multi_location","multi_year_single_location","single_year_multi_location"],"sample_questions":["Compare volcano exposure for Indonesia, Japan, and the Philippines in 2020","Show volcano exposure across Indonesia, Japan, and the Philippines from 2000 to 2020"],"query_dimensions":{"data":"single_or_variable_within_pack","location":"single_or_variable","time":"single_or_variable"},"query_rule":"easy_if_one_query_one_dataset","free_detail":true,"paid_data_calls":false,"live_updates_enabled":true,"canonical_available_through":"2026-03-10T00:00:00","processing_state":"aggregate_ready","preferred_tool":"get_data","related_disaster_links":{"supported":true,"requires_exact_event_id":true,"max_chain_depth":2,"supported_link_types":["triggered"],"tool":"get_event","tool_arguments":{"event_id":"<event_id from get_data>","pack_id":"volcanoes","include":["relationships"],"relationship_depth":1},"cross_hazard_only":true,"published_link_families_last_checked":"2026-09-20","pack_relevant_link_families":[{"from_event_type":"volcano","to_event_type":"earthquake","source":"smithsonian","count":29,"notes":"Volcano-linked earthquake references."},{"from_event_type":"volcano","to_event_type":"tsunami","source":"smithsonian","count":30,"notes":"Volcano-linked tsunami references."}],"network_link_families":[{"from_event_type":"earthquake","to_event_type":"tsunami","source":"noaa","count":592,"notes":"Cross-hazard seismic trigger links."},{"from_event_type":"hurricane","to_event_type":"flood","source":"derived_tc_flood","count":1005,"notes":"Tropical-cyclone flood links."},{"from_event_type":"hurricane","to_event_type":"tornado","source":"derived_tc_tornado","count":1305,"notes":"Tropical-cyclone tornado links."},{"from_event_type":"volcano","to_event_type":"earthquake","source":"smithsonian","count":29,"notes":"Volcano-linked earthquake references."},{"from_event_type":"volcano","to_event_type":"tsunami","source":"smithsonian","count":30,"notes":"Volcano-linked tsunami references."},{"from_event_type":"wildfire","to_event_type":"flood","source":"derived_postfire_flood","count":13,"notes":"Post-fire flood or burn-scar runoff links."}],"not_paired_families_last_checked":"2026-06-27","pack_relevant_not_paired_families":[{"event_types":["volcano","hurricane"],"published_any_direction":false},{"event_types":["volcano","tornado"],"published_any_direction":false},{"event_types":["volcano","flood"],"published_any_direction":false},{"event_types":["volcano","wildfire"],"published_any_direction":false}],"usage_note":"Use an exact event_id returned by get_data, then call get_event with include=['relationships']. Increase relationship_depth to 2 only for a bounded chain. Same-pack observations such as earthquake aftershocks use include=['observations'] instead."},"sources":[{"source_id":"volcano_aggregates","source_name":"Volcano Aggregates by Admin2 Region","description":"Annual and rolling volcano aggregates by admin2 region for eruption counts, VEI, duration, and casualties.","path":"global/disasters/volcanoes/sources/aggregates","data_type":"metrics","scope":"global","geometry_family":"admin_spine","geographic_levels":[2],"coverage_contract":{"assertion":"regional_countries_not_declared","scopes":["unknown"],"countries":[],"worldwide":false,"excluded_countries":["AFG","AGO","ALB","AND","ARE","ATG","AUT","BDI","BEL","BEN","BFA","BGD","BGR","BHR","BHS","BIH","BLR","BLZ","BRA","BRB","BRN","BTN","BWA","CAF","CHE","CIV","COG","COK","CUB","CYP","CZE","DMA","DNK","DOM","DZA","EGY","EST","FIN","FSM","GAB","GBR","GHA","GIN","GMB","GNB","GRD","GUY","HKG","HRV","HTI","HUN","IRL","IRQ","ISR","JAM","KAZ","KGZ","KHM","KIR","KNA","KWT","LAO","LBN","LBR","LBY","LIE","LKA","LSO","LTU","LUX","LVA","MAC","MAR","MCO","MDA","MDV","MHL","MKD","MLI","MLT","MNE","MOZ","MRT","MUS","MWI","MYS","NAM","NER","NGA","NIU","NLD","NOR","NPL","NRU","OMN","PAK","PLW","POL","PRY","PSE","QAT","ROU","RWA","SEN","SGP","SLE","SMR","SOM","SRB","SSD","STP","SUR","SVK","SVN","SWE","SWZ","SYC","SYR","TCD","TGO","THA","TJK","TKM","TLS","TTO","TUN","TUV","UKR","URY","UZB","VAT","VCT","VEN","VNM","ZAF","ZMB","ZWE"],"geographic_levels":[2],"empty_geographic_levels_meaning":null},"temporal_coverage":{"start":-55500,"end":2026,"frequency":"annual","granularity":"yearly","field":"year"},"time_field":"year","location_field":"loc_id","supported_query_shapes":["single_year_multi_location","multi_year_single_location","multi_year_multi_location"],"metrics":{"event_count":{"name":"Eruption count","unit":"events","years":[-55500,2026],"countries":63,"density":1.0,"stats":{"min":1.0,"max":9.0,"median":1.0}},"max_vei":{"name":"Max VEI","unit":"VEI","years":[-55500,2025],"countries":52,"density":0.833,"stats":{"min":0.0,"max":7.0,"median":3.0}},"avg_vei":{"name":"Average VEI","unit":"VEI","years":[-55500,2025],"countries":52,"density":0.833,"stats":{"min":0.0,"max":7.0,"median":3.0}},"avg_duration_days":{"name":"Average eruption duration","unit":"days","years":[10,2026],"countries":42,"density":0.362,"stats":{"min":0.0,"max":276108.0,"median":70.0}},"deaths":{"name":"Deaths","unit":"people","years":[-55500,2026],"countries":63,"density":1.0,"stats":{"min":0.0,"max":16000.0,"median":0.0}},"injuries":{"name":"Injuries","unit":"people","years":[-55500,2026],"countries":63,"density":1.0,"stats":{"min":0.0,"max":1000.0,"median":0.0}}},"metric_ids":["avg_duration_days","avg_vei","deaths","event_count","injuries","max_vei"],"filterable_fields":["loc_id","year"],"sortable_fields":["loc_id","year","avg_duration_days","avg_vei","deaths","event_count","injuries","max_vei"],"reference_guidance":{"files":{"admin2/rolling_10y.parquet":"Rolling 10y volcano aggregates by admin2 region.","admin2/rolling_20y.parquet":"Rolling 20y volcano aggregates by admin2 region.","admin2/yearly.parquet":"Annual volcano aggregates by admin2 region."},"data_quality_notes":["Rows are event-grain records re-keyed to Admin2/year; event_count is flat at one and must not be summed or used for entity rankings.","Deaths and injuries are event-level values carried on re-keyed rows. Do not sum them across Admin2 regions without a source-owned attribution rule."],"keywords":["volcano","aggregate","admin2","regional summary","rolling window"]},"upstream_sources":[{"agency":"Smithsonian Institution Global Volcanism Program","agency_short":"Smithsonian GVP","license":"Smithsonian GVP Terms of Use (non-commercial)","notes":"Sole upstream. GVP eruption catalog with VEI ratings, duration, and impact data. Holocene to present.","source_id":"smithsonian_gvp","source_url":"https://volcano.si.edu/"}],"license_policy":{"schema_version":"1.2.0","license":"Smithsonian GVP Terms of Use (non-commercial)","permission":"free","resolution_status":"resolved","policy_source":"build/catalog/license_permission_crosswalk.csv","reason":"Non-commercial terms prohibit paid hosted use.","redistribution":"restricted","share_alike":"no","attribution_required":true,"attribution_template":"Global Volcanism Program, Smithsonian Institution. {title?}.","source_url":"https://volcano.si.edu/gvp_termsofuse.cfm","reviewed_on":"2026-09-10","notes":"Conservative label for general GVP content. The official page separately identifies some U.S.-employee database and report content, but this row does not broaden a product unless its exact content class is recorded.","reuse_obligations":{"copyleft_scope":null,"required_public_license":null,"source_offer_required":null}},"material_policy":{"schema_version":"1.2.0","object_kind":"source","object_id":"volcano_aggregates","policy_source":"build/catalog/license_permission_crosswalk.csv","permission":"free","licenses":["Smithsonian GVP Terms of Use (non-commercial)"],"resolution_status":"resolved","hosted_access":{"maximum_lane":"free","publication_ready":true,"free_allowed":true,"paid_allowed":false,"reason_codes":["paid_hosted_not_permitted","redistribution_not_permitted"]},"redistribution":{"status":"restricted","allowed":false,"share_alike":"no"},"reuse_obligations":[],"surface_access":{"hosted_results":true,"server_rendered_display":true,"client_geometry":false,"download":false,"blocked_by_source_review":[],"restrictions":[]},"attribution":{"required":true,"status":"resolved","text":"Global Volcanism Program, Smithsonian Institution. Volcano Aggregates by Admin2 Region.","lines":["Global Volcanism Program, Smithsonian Institution. Volcano Aggregates by Admin2 Region."]},"citation":{"style":"daedalmap-1","entries":[{"text":"Smithsonian Institution Global Volcanism Program. Volcano Aggregates by Admin2 Region. Smithsonian GVP Terms of Use (non-commercial). https://volcano.si.edu/.","role":"data","parts":{"role":"data","agency":"Smithsonian Institution Global Volcanism Program","title":"Volcano Aggregates by Admin2 Region","vintage":"","url":"https://volcano.si.edu/","license":"Smithsonian GVP Terms of Use (non-commercial)"}}],"text":"Smithsonian Institution Global Volcanism Program. Volcano Aggregates by Admin2 Region. Smithsonian GVP Terms of Use (non-commercial). https://volcano.si.edu/."},"license_evidence":[{"license":"Smithsonian GVP Terms of Use (non-commercial)","source_url":"https://volcano.si.edu/gvp_termsofuse.cfm","reviewed_on":"2026-09-10"}],"facts_fingerprint":"e1dee3362e9d79198a8945d450114dc95169954462563c27df476fa507f513e1","policy_fingerprint":"123740dd765e310006fb5f503611d126185258df4412f6d75314d33948deb949"},"size":{"contract_version":1,"transfer_mb":0.17,"browser_storage_estimate_mb":0.17,"working_set_estimate_mb":2.17},"browser_artifact":{"contract_version":1,"artifact_version":"897b3f6faf3ed33bd5190a9cedce39009a0c229162a18b48dc58192c8fcde143","format":"application/gzip","storage_key":"published/browser_artifacts/sources/volcano_aggregates/runtime_snapshot_v1_897b3f6faf3ed33b.json.gz","sha256":"897b3f6faf3ed33bd5190a9cedce39009a0c229162a18b48dc58192c8fcde143","transfer_bytes":180836,"transfer_mb":0.17,"stored_bytes":180836,"stored_mb":0.17,"expanded_bytes":2272592,"expanded_mb":2.17,"generated_at":"2026-08-16T21:31:41.714740Z","source_snapshot_version":1},"live_updates_enabled":true,"live_watermark_utc":"2026-03-10T00:00:00","processing_state":"aggregate_ready","canonical_available_through":"2026-03-10T00:00:00","source_url":"https://volcano.si.edu/","license":"Smithsonian GVP Terms of Use (non-commercial)","source_license":null,"category":"hazard","geojson_shape":"geometry_shape","geometry_families":null,"supports_admin_spine_crosswalk":null,"display_contract":{"family":"admin_choropleth","geometry_family":"admin_spine","popup_family":"metric_popup","timeline":{"clock":"utc","playhead_unit":"epoch_ms","mode":"discrete_frames","time_field":"year","source_time_unit":"year","native_granularity":"yearly","timestamp_semantics":"period_start","frame_policy":"hold_previous","animation_style":"replace_frame"}},"pack_id":"volcanoes","pack_representative":false,"pack_maintainer_name":"","pack_maintainer_url":"","pack_version":"1.1.0","release_state":"published","access_scope":null,"wip_note":"","catalog_surfaces":["api","research","explore","mcp"],"topic_tags":["disasters","volcanoes","eruptions","hazard","aggregate","admin2","county"],"keywords":["volcanoe","aggregate","admin2","regional summary","rolling window"],"geographic_level":"admin_2","geographic_coverage":{"type":"global","countries":null,"admin_levels":[2],"common_count":63,"common_missing":["AFG","AGO","ALB","AND","ARE","ATG","AUT","BDI","BEL","BEN","BFA","BGD","BGR","BHR","BHS","BIH","BLR","BLZ","BRA","BRB","BRN","BTN","BWA","CAF","CHE","CIV","COG","COK","CUB","CYP","CZE","DMA","DNK","DOM","DZA","EGY","EST","FIN","FSM","GAB","GBR","GHA","GIN","GMB","GNB","GRD","GUY","HKG","HRV","HTI","HUN","IRL","IRQ","ISR","JAM","KAZ","KGZ","KHM","KIR","KNA","KWT","LAO","LBN","LBR","LBY","LIE","LKA","LSO","LTU","LUX","LVA","MAC","MAR","MCO","MDA","MDV","MHL","MKD","MLI","MLT","MNE","MOZ","MRT","MUS","MWI","MYS","NAM","NER","NGA","NIU","NLD","NOR","NPL","NRU","OMN","PAK","PLW","POL","PRY","PSE","QAT","ROU","RWA","SEN","SGP","SLE","SMR","SOM","SRB","SSD","STP","SUR","SVK","SVN","SWE","SWZ","SYC","SYR","TCD","TGO","THA","TJK","TKM","TLS","TTO","TUN","TUV","UKR","URY","UZB","VAT","VCT","VEN","VNM","ZAF","ZMB","ZWE"],"uncommonly_included":[],"region_coverage":{}},"coverage_description":"63/200 common","row_count":40612,"file_size_mb":0.17,"browser_storage_estimate_mb":0.17,"working_set_estimate_mb":2.17,"browser_artifact_available":true,"browser_artifact_policy":null,"llm_summary":"Annual and rolling volcano aggregates by admin2 region for eruption counts, VEI, duration, and casualties.","time_granularity":"yearly","runtime_primary_file":"admin2/yearly.parquet","default_question":"Show annual volcano event counts by region.","default_response":"Showing yearly volcano aggregate statistics by admin2 region. Ask to compare eruption counts, VEI, duration, deaths, or injuries across places and years.","reference":{"source":{"source_id":"volcano_aggregates","source_name":"Volcano Aggregates by Admin2 Region","source_url":"https://volcano.si.edu/","license":"Smithsonian GVP Terms of Use (non-commercial)","description":"Annual and rolling-window volcanoe aggregate statistics by admin2 region, derived from the published volcanoes event source for cross-region comparison, ranking, and joins with other county-scale risk layers.","category":"hazard","data_type":"metrics","topic_tags":["disasters","volcanoes","eruptions","hazard","aggregate","admin2","county"],"keywords":["volcano","aggregate","admin2","regional summary","rolling window"]},"upstream_sources":[{"agency":"Smithsonian Institution Global Volcanism Program","agency_short":"Smithsonian GVP","license":"Smithsonian GVP Terms of Use (non-commercial)","notes":"Sole upstream. GVP eruption catalog with VEI ratings, duration, and impact data. Holocene to present.","source_id":"smithsonian_gvp","source_url":"https://volcano.si.edu/"}],"metrics":{"event_count":"Legacy per-row event marker (currently one per re-keyed event row), not a grouped Admin2 event count. Use Smithsonian GVP Events for event rankings or a future genuinely grouped aggregate for regional counts.","max_vei":"Maximum Volcanic Explosivity Index observed in the selected window","avg_vei":"Average Volcanic Explosivity Index observed in the selected window","avg_duration_days":"Average eruption duration in days in the selected window","deaths":"Total volcanic-event deaths in the selected window","injuries":"Total volcanic-event injuries in the selected window"},"manual_guidance":{"files":{"admin2/rolling_10y.parquet":"Rolling 10y volcano aggregates by admin2 region.","admin2/rolling_20y.parquet":"Rolling 20y volcano aggregates by admin2 region.","admin2/yearly.parquet":"Annual volcano aggregates by admin2 region."},"data_quality_notes":["Rows are event-grain records re-keyed to Admin2/year; event_count is flat at one and must not be summed or used for entity rankings.","Deaths and injuries are event-level values carried on re-keyed rows. Do not sum them across Admin2 regions without a source-owned attribution rule."]}},"permission":"free","provenance_fingerprint":"e1dee3362e9d79198a8945d450114dc95169954462563c27df476fa507f513e1","license_conditions":{"permission":"free","redistribution":"restricted","share_alike":"no"},"attribution_text":"Global Volcanism Program, Smithsonian Institution. Volcano Aggregates by Admin2 Region.","attribution_lines":["Global Volcanism Program, Smithsonian Institution. Volcano Aggregates by Admin2 Region."],"citation":{"style":"daedalmap-1","entries":[{"text":"Smithsonian Institution Global Volcanism Program. Volcano Aggregates by Admin2 Region. Smithsonian GVP Terms of Use (non-commercial). https://volcano.si.edu/.","role":"data","parts":{"role":"data","agency":"Smithsonian Institution Global Volcanism Program","title":"Volcano Aggregates by Admin2 Region","vintage":"","url":"https://volcano.si.edu/","license":"Smithsonian GVP Terms of Use (non-commercial)"}}],"text":"Smithsonian Institution Global Volcanism Program. Volcano Aggregates by Admin2 Region. Smithsonian GVP Terms of Use (non-commercial). https://volcano.si.edu/."},"download":{"available":true,"channel":"stable","version":"1.1.0","published_at":"2026-10-10T01:45:29.603137Z","current_manifest_url":"https://downloads.daedalmap.com/downloadable/packs/volcanoes/volcanoes-lite/stable/current.json","version_manifest_url":"https://downloads.daedalmap.com/downloadable/packs/volcanoes/volcanoes-lite/stable/1.1.0/version.json","artifact_url":"https://downloads.daedalmap.com/downloadable/packs/volcanoes/volcanoes-lite/stable/1.1.0/pack.zip","filename":"pack.zip","sha256":"7cb1228845a4956242f445df49091ef42b9f3651f04b0bd3b1fe2a936ab1deed","size_bytes":931897,"file_count":13,"validation_status":"passed"},"last_updated":"2026-07-10"},{"source_id":"volcanoes_events","source_name":"Smithsonian Global Volcanism Program Events","description":"55500 BCE - 2026, 11,084 volcanic eruption events worldwide. Full timestamp coverage from 1800 onward.","path":"global/disasters/volcanoes/sources/volcanoes_events","data_type":"events","scope":"global","geometry_families":["admin_spine","marine"],"coverage_contract":{"assertion":"explicit_countries","scopes":["ATA"],"countries":["ATA"],"worldwide":false,"excluded_countries":["AFG","AGO","ALB","AND","ARE","ATG","AUT","AZE","BDI","BEL","BEN","BFA","BGD","BGR","BHR","BHS","BIH","BLR","BLZ","BOL","BRA","BRB","BRN","BTN","BWA","CAF","CHE","CIV","COG","COK","CUB","CYP","CZE","DNK","DOM","DZA","EGY","EST","FIN","FSM","GAB","GHA","GIN","GMB","GNB","GUY","HKG","HRV","HTI","HUN","IRL","IRQ","ISR","JAM","JOR","KAZ","KGZ","KHM","KIR","KWT","LAO","LBN","LBR","LBY","LIE","LKA","LSO","LTU","LUX","LVA","MAC","MAR","MCO","MDA","MDG","MDV","MHL","MKD","MLI","MLT","MNE","MOZ","MRT","MUS","MWI","MYS","NAM","NER","NGA","NIU","NPL","NRU","OMN","PAK","PLW","POL","PRK","PRY","PSE","QAT","ROU","RWA","SEN","SGP","SLE","SMR","SOM","SRB","SSD","STP","SUR","SVK","SVN","SWE","SWZ","SYC","TCD","TGO","THA","TJK","TKM","TLS","TTO","TUN","TUV","UKR","URY","UZB","VAT","VEN","ZMB","ZWE"],"geographic_levels":[],"empty_geographic_levels_meaning":"not_declared"},"temporal_coverage":{"end":2026,"field":"year","granularity":"yearly","start":-55500},"time_field":"year","location_field":"loc_id","supported_query_shapes":["single_year_multi_location","multi_year_single_location","multi_year_multi_location","filtered_event_query"],"metrics":{"VEI":{"name":"Volcanic Explosivity Index (0-8 scale)","unit":null,"years":null,"countries":null,"density":0.757,"stats":{"min":0.0,"max":7.0,"median":2.0}},"damage_radius_km":{"name":"Estimated radius of structural damage","unit":null,"years":null,"countries":null,"density":1.0,"stats":{"min":1.0,"max":125.9,"median":4.0}},"damage_usd":{"name":"Estimated damage in USD","unit":null,"years":null,"countries":null,"density":0.0,"stats":{"min":19000000.0,"max":19000000.0,"median":19000000.0}},"deaths":{"name":"Number of deaths attributed to the eruption","unit":null,"years":null,"countries":null,"density":0.009,"stats":{"min":1.0,"max":16000.0,"median":16.0}},"duration_days":{"name":"Duration of eruption in days","unit":null,"years":null,"countries":null,"density":0.404,"stats":{"min":0.0,"max":276108.0,"median":53.5}},"end_year":{"name":"End Year","unit":"unknown","years":null,"countries":null,"density":0.404,"stats":{"min":-2080.0,"max":2026.0,"median":1962.0}},"eruption_id":{"name":"Eruption Id","unit":"unknown","years":null,"countries":null,"density":1.0,"stats":{"min":10001.0,"max":22658.0,"median":15851.5}},"felt_radius_km":{"name":"Estimated radius where eruption effects were felt","unit":null,"years":null,"countries":null,"density":1.0,"stats":{"min":5.0,"max":1020.9,"median":22.9}},"houses_destroyed":{"name":"Number of houses destroyed","unit":null,"years":null,"countries":null,"density":0.001,"stats":{"min":24.0,"max":9000.0,"median":188.5}},"injuries":{"name":"Number of injuries attributed to the eruption","unit":null,"years":null,"countries":null,"density":0.003,"stats":{"min":1.0,"max":1000.0,"median":30.5}},"is_ongoing":{"name":"Whether the eruption is currently ongoing","unit":null,"years":null,"countries":null,"density":1.0,"stats":{"min":0.0,"max":1.0,"median":1.0}},"missing":{"name":"Number of missing persons","unit":null,"years":null,"countries":null,"density":0.0,"stats":{"min":78.0,"max":78.0,"median":78.0}},"noaa_id":{"name":"Noaa Id","unit":"unknown","years":null,"countries":null,"density":0.015,"stats":{"min":1.0,"max":994.0,"median":443.0}},"sibling_level":{"name":"Sibling Level","unit":"unknown","years":null,"countries":null,"density":0.993,"stats":{"min":0.0,"max":1.0,"median":1.0}},"volcano_number":{"name":"Volcano Number","unit":"unknown","years":null,"countries":null,"density":1.0,"stats":{"min":210010.0,"max":390140.0,"median":285070.0}}},"metric_ids":["VEI","damage_radius_km","damage_usd","deaths","duration_days","end_year","eruption_id","event_count","felt_radius_km","houses_destroyed","injuries","is_ongoing","missing","noaa_id","sibling_level","volcano_number"],"filterable_fields":["loc_id","year","is_ongoing","volcano_name","activity_type","country","region"],"sortable_fields":["loc_id","year","is_ongoing","volcano_name","VEI","duration_days","felt_radius_km","damage_radius_km","deaths","injuries","missing","houses_destroyed","damage_usd"],"routing_hints":{"broad_topic_aliases":["volcano events","eruption events","volcanic activity","volcanic eruptions"],"metric_aliases":{"eruption magnitude":"VEI","strongest":"VEI","largest eruption":"VEI","volcanic eruptions":"VEI","volcanic explosivity":"VEI"},"prefer_order_for_analytics":true,"query_aliases":["volcanic eruptions","major eruptions","eruptions in","active volcano events","vei eruptions","recent eruptions"],"query_priority":0.18,"single_metric_default":"VEI"},"reference_guidance":{"query_contract":{"location_field":"loc_id","time_field":"year","time_required":true,"location_filter_mode":"hierarchical_loc_id","default_limit":100,"max_limit":500,"notes":["region_ids are resolved through the nested loc_id hierarchy","exact loc_id requests and higher-level region prefixes are both supported through hierarchy-aware matching","equals filters can be used for source-specific fields like is_ongoing, volcano_name, activity_type, country, and region"]},"geographic_context":{"coverage":"Global volcano event coverage across 69 ISO3 areas","focus":"Primary event-level volcano retrieval","temporal":"Deep historical to present","admin_levels":["Point locations with lat/lon"]},"data_quality_notes":["Very old eruptions may have approximate or BCE year values","Many historical events remain marked as ongoing in the source record","Deaths, injuries, and damage are recorded only for a small minority of eruptions","Aggregate yearly volcano views are intentionally excluded from this execution source"],"qualifier_hints":{"biggest":"By default, treat biggest or largest volcanic eruptions as highest VEI events unless the user explicitly asks for duration, deaths, or damage.","strongest":"Treat strongest or most explosive eruptions as ranking by VEI.","longest":"Treat longest eruptions as ranking by duration_days.","deadliest":"Treat deadliest eruptions as ranking by deaths.","costliest":"Treat costliest eruptions as ranking by damage_usd."},"qa":{"notes":"Normalized event-only volcano source for the API lane. Keep yearly and admin2 aggregate tables out of this execution source."},"keywords":["volcano","eruption","VEI","lava","ash","Smithsonian","GVP"],"runtime_filter_summary":"This normalized source contains the main volcano eruption event catalog only. Aggregate yearly views remain separate sources.","full_dataset_note":"Use this source for direct volcano event retrieval. Aggregate and rollup-oriented volcano sources should be queried separately.","default_map_filter_summary":"Default live map overlay does not impose a VEI cutoff by default; API filters can narrow to stronger eruptions or specific ongoing events."},"analysis_contract":{"groupable_dimensions":{"volcano_number":{"column":"volcano_number","label_fields":["volcano_name"],"max_groups":100,"requires_time_filter":true}}},"upstream_sources":[{"agency":"Smithsonian Institution Global Volcanism Program","agency_short":"Smithsonian GVP","license":"Smithsonian GVP Terms of Use (non-commercial)","notes":"Sole upstream. GVP eruption catalog with VEI ratings, duration, and impact data. Holocene to present.","source_id":"smithsonian_gvp","source_url":"https://volcano.si.edu/"}],"license_policy":{"schema_version":"1.2.0","license":"Smithsonian GVP Terms of Use (non-commercial)","permission":"free","resolution_status":"resolved","policy_source":"build/catalog/license_permission_crosswalk.csv","reason":"Non-commercial terms prohibit paid hosted use.","redistribution":"restricted","share_alike":"no","attribution_required":true,"attribution_template":"Global Volcanism Program, Smithsonian Institution. {title?}.","source_url":"https://volcano.si.edu/gvp_termsofuse.cfm","reviewed_on":"2026-09-10","notes":"Conservative label for general GVP content. The official page separately identifies some U.S.-employee database and report content, but this row does not broaden a product unless its exact content class is recorded.","reuse_obligations":{"copyleft_scope":null,"required_public_license":null,"source_offer_required":null}},"material_policy":{"schema_version":"1.2.0","object_kind":"source","object_id":"volcanoes_events","policy_source":"build/catalog/license_permission_crosswalk.csv","permission":"free","licenses":["Smithsonian GVP Terms of Use (non-commercial)"],"resolution_status":"resolved","hosted_access":{"maximum_lane":"free","publication_ready":true,"free_allowed":true,"paid_allowed":false,"reason_codes":["paid_hosted_not_permitted","redistribution_not_permitted"]},"redistribution":{"status":"restricted","allowed":false,"share_alike":"no"},"reuse_obligations":[],"surface_access":{"hosted_results":true,"server_rendered_display":true,"client_geometry":false,"download":false,"blocked_by_source_review":[],"restrictions":[]},"attribution":{"required":true,"status":"resolved","text":"Global Volcanism Program, Smithsonian Institution. Smithsonian Global Volcanism Program Events.","lines":["Global Volcanism Program, Smithsonian Institution. Smithsonian Global Volcanism Program Events."]},"citation":{"style":"daedalmap-1","entries":[{"text":"Smithsonian Institution Global Volcanism Program. Smithsonian Global Volcanism Program Events. Smithsonian GVP Terms of Use (non-commercial). https://volcano.si.edu/.","role":"data","parts":{"role":"data","agency":"Smithsonian Institution Global Volcanism Program","title":"Smithsonian Global Volcanism Program Events","vintage":"","url":"https://volcano.si.edu/","license":"Smithsonian GVP Terms of Use (non-commercial)"}}],"text":"Smithsonian Institution Global Volcanism Program. Smithsonian Global Volcanism Program Events. Smithsonian GVP Terms of Use (non-commercial). https://volcano.si.edu/."},"license_evidence":[{"license":"Smithsonian GVP Terms of Use (non-commercial)","source_url":"https://volcano.si.edu/gvp_termsofuse.cfm","reviewed_on":"2026-09-10"}],"facts_fingerprint":"7effffc800c4bc7fdfa4a48b8dbdbd3142df01415127f899b8c3a629a85022a0","policy_fingerprint":"123740dd765e310006fb5f503611d126185258df4412f6d75314d33948deb949"},"size":{"contract_version":1,"transfer_mb":0.46,"browser_storage_estimate_mb":0.46,"working_set_estimate_mb":6.56},"browser_artifact":{"contract_version":1,"artifact_version":"c217e7776453604b85f6b41b04d4e0c19002f2570fe8cc9eb9721594e9315a29","format":"application/gzip","storage_key":"published/browser_artifacts/sources/volcanoes_events/runtime_snapshot_v1_c217e7776453604b.json.gz","sha256":"c217e7776453604b85f6b41b04d4e0c19002f2570fe8cc9eb9721594e9315a29","transfer_bytes":479172,"transfer_mb":0.46,"stored_bytes":479172,"stored_mb":0.46,"expanded_bytes":6874954,"expanded_mb":6.56,"generated_at":"2026-08-16T21:31:42.747767Z","source_snapshot_version":1},"live_updates_enabled":true,"live_watermark_utc":"2026-03-10T00:00:00","processing_state":"aggregate_ready","canonical_available_through":"2026-03-10T00:00:00","default_limit":100,"max_limit":500,"source_url":"https://volcano.si.edu/","license":"Smithsonian GVP Terms of Use (non-commercial)","source_license":null,"category":"disasters","geojson_shape":"event_shape","geometry_family":null,"supports_admin_spine_crosswalk":null,"display_contract":{"family":"event_overlay","rendering_model":"point_radius_event","popup_family":"disaster_popup","render_variants":[{"kind":"point_radius","latitude_field":"latitude","longitude_field":"longitude","radius_field":"damage_radius_km","radius_unit":"km"},{"kind":"point","latitude_field":"latitude","longitude_field":"longitude"}],"timeline":{"clock":"utc","playhead_unit":"epoch_ms","mode":"event_lifecycle","time_field":"timestamp","source_time_unit":"datetime","native_granularity":"event","timestamp_semantics":"instant","frame_policy":"active_interval","animation_style":"event_lifecycle"},"lifecycle_fields":{"start_field":"display_start_timestamp","end_field":"display_end_timestamp","animation_kind_field":"display_animation_kind"}},"pack_id":"volcanoes","pack_representative":false,"pack_maintainer_name":"","pack_maintainer_url":"","pack_version":"1.1.0","release_state":"published","access_scope":null,"wip_note":"","catalog_surfaces":["api","research","explore","mcp"],"topic_tags":["disasters","volcanoes","eruptions","hazard"],"keywords":["volcano","eruption","VEI","lava","ash","Smithsonian","GVP"],"geographic_level":null,"geographic_levels":[],"geographic_coverage":{"type":"global","countries":null,"admin_levels":[2],"common_count":68,"common_missing":["AFG","AGO","ALB","AND","ARE","ATG","AUT","AZE","BDI","BEL","BEN","BFA","BGD","BGR","BHR","BHS","BIH","BLR","BLZ","BOL","BRA","BRB","BRN","BTN","BWA","CAF","CHE","CIV","COG","COK","CUB","CYP","CZE","DNK","DOM","DZA","EGY","EST","FIN","FSM","GAB","GHA","GIN","GMB","GNB","GUY","HKG","HRV","HTI","HUN","IRL","IRQ","ISR","JAM","JOR","KAZ","KGZ","KHM","KIR","KWT","LAO","LBN","LBR","LBY","LIE","LKA","LSO","LTU","LUX","LVA","MAC","MAR","MCO","MDA","MDG","MDV","MHL","MKD","MLI","MLT","MNE","MOZ","MRT","MUS","MWI","MYS","NAM","NER","NGA","NIU","NPL","NRU","OMN","PAK","PLW","POL","PRK","PRY","PSE","QAT","ROU","RWA","SEN","SGP","SLE","SMR","SOM","SRB","SSD","STP","SUR","SVK","SVN","SWE","SWZ","SYC","TCD","TGO","THA","TJK","TKM","TLS","TTO","TUN","TUV","UKR","URY","UZB","VAT","VEN","ZMB","ZWE"],"uncommonly_included":["ATA"],"region_coverage":{}},"coverage_description":"68/200 common","row_count":11084,"file_size_mb":0.46,"browser_storage_estimate_mb":0.46,"working_set_estimate_mb":6.56,"browser_artifact_available":true,"browser_artifact_policy":null,"llm_summary":"55500 BCE - 2026, 11,084 volcanic eruption events worldwide. Full timestamp coverage from 1800 onward.","location_filter_mode":"hierarchical_loc_id","time_granularity":"yearly","event_type":"volcano","significance_column":"VEI","runtime_primary_file":"events.parquet","default_load":{"items":[{"filters":{"VEI":{"min":2}},"metric":"event_count","mode":"events","pack_id":"volcanoes","source_id":"volcanoes_events"}],"kind":"confirmed_order","relative_years":10,"summary":"Showing recorded volcanic eruptions VEI 2 and above over the last 10 years -- the broad event list with explosivity, duration, and casualties. Ask to raise the VEI, focus a region, or see impact."},"default_question":"Show me recent volcanic eruptions worldwide with VEI 2 and above from the last 10 years.","default_response":"Showing recorded volcanic eruptions VEI 2 and above over the last 10 years -- the broad event list with explosivity, duration, and casualties. Ask to raise the VEI, focus a region, or see impact.","overlay":{"default_visible":false,"icon":null,"label":"Volcanoes","path":"disasters/volcanoes","scope":null,"visibility":{"max_area_sq_deg":null,"max_zoom":18,"min_area_sq_deg":null,"min_zoom":0}},"reference":{"source":{"source_id":"volcanoes_events","source_name":"Smithsonian Global Volcanism Program Events","source_url":"https://volcano.si.edu/","license":"Smithsonian GVP Terms of Use (non-commercial)","category":"hazard","description":"Global volcanic eruption event catalog from the Smithsonian Global Volcanism Program. This normalized source is the primary event-level volcano execution lane for the API.","topic_tags":["disasters","volcanoes","eruptions","hazard"],"keywords":["volcano","eruption","VEI","lava","ash","Smithsonian","GVP"],"data_type":"events","data_scope":"normalized_api_source","full_dataset_available":true,"runtime_filter_summary":"This normalized source contains the main volcano eruption event catalog only. Aggregate yearly views remain separate sources.","full_dataset_note":"Use this source for direct volcano event retrieval. Aggregate and rollup-oriented volcano sources should be queried separately.","default_map_filter_summary":"Default live map overlay does not impose a VEI cutoff by default; API filters can narrow to stronger eruptions or specific ongoing events."},"metrics":{"VEI":"Volcanic Explosivity Index (0-8 scale)","duration_days":"Duration of eruption in days","is_ongoing":"Whether the eruption is currently ongoing","felt_radius_km":"Estimated radius where eruption effects were felt","damage_radius_km":"Estimated radius of structural damage","deaths":"Number of deaths attributed to the eruption","injuries":"Number of injuries attributed to the eruption","missing":"Number of missing persons","houses_destroyed":"Number of houses destroyed","damage_usd":"Estimated damage in USD"},"manual_guidance":{"query_contract":{"location_field":"loc_id","time_field":"year","time_required":true,"location_filter_mode":"hierarchical_loc_id","default_limit":100,"max_limit":500,"notes":["region_ids are resolved through the nested loc_id hierarchy","exact loc_id requests and higher-level region prefixes are both supported through hierarchy-aware matching","equals filters can be used for source-specific fields like is_ongoing, volcano_name, activity_type, country, and region"]},"geographic_context":{"coverage":"Global volcano event coverage across 69 ISO3 areas","focus":"Primary event-level volcano retrieval","temporal":"Deep historical to present","admin_levels":["Point locations with lat/lon"]},"data_quality_notes":["Very old eruptions may have approximate or BCE year values","Many historical events remain marked as ongoing in the source record","Deaths, injuries, and damage are recorded only for a small minority of eruptions","Aggregate yearly volcano views are intentionally excluded from this execution source"],"qualifier_hints":{"biggest":"By default, treat biggest or largest volcanic eruptions as highest VEI events unless the user explicitly asks for duration, deaths, or damage.","strongest":"Treat strongest or most explosive eruptions as ranking by VEI.","longest":"Treat longest eruptions as ranking by duration_days.","deadliest":"Treat deadliest eruptions as ranking by deaths.","costliest":"Treat costliest eruptions as ranking by damage_usd."},"qa":{"notes":"Normalized event-only volcano source for the API lane. Keep yearly and admin2 aggregate tables out of this execution source."}}},"permission":"free","provenance_fingerprint":"7effffc800c4bc7fdfa4a48b8dbdbd3142df01415127f899b8c3a629a85022a0","license_conditions":{"permission":"free","redistribution":"restricted","share_alike":"no"},"attribution_text":"Global Volcanism Program, Smithsonian Institution. Smithsonian Global Volcanism Program Events.","attribution_lines":["Global Volcanism Program, Smithsonian Institution. Smithsonian Global Volcanism Program Events."],"citation":{"style":"daedalmap-1","entries":[{"text":"Smithsonian Institution Global Volcanism Program. Smithsonian Global Volcanism Program Events. Smithsonian GVP Terms of Use (non-commercial). https://volcano.si.edu/.","role":"data","parts":{"role":"data","agency":"Smithsonian Institution Global Volcanism Program","title":"Smithsonian Global Volcanism Program Events","vintage":"","url":"https://volcano.si.edu/","license":"Smithsonian GVP Terms of Use (non-commercial)"}}],"text":"Smithsonian Institution Global Volcanism Program. Smithsonian Global Volcanism Program Events. Smithsonian GVP Terms of Use (non-commercial). https://volcano.si.edu/."},"download":{"available":true,"channel":"stable","version":"1.1.0","published_at":"2026-10-10T01:45:29.603137Z","current_manifest_url":"https://downloads.daedalmap.com/downloadable/packs/volcanoes/volcanoes-lite/stable/current.json","version_manifest_url":"https://downloads.daedalmap.com/downloadable/packs/volcanoes/volcanoes-lite/stable/1.1.0/version.json","artifact_url":"https://downloads.daedalmap.com/downloadable/packs/volcanoes/volcanoes-lite/stable/1.1.0/pack.zip","filename":"pack.zip","sha256":"7cb1228845a4956242f445df49091ef42b9f3651f04b0bd3b1fe2a936ab1deed","size_bytes":931897,"file_count":13,"validation_status":"passed"},"last_updated":"2026-07-10"}],"release_state":"published","access_scope":null,"wip_note":"","catalog_surfaces":["api","explore","mcp","research"],"pack_maintainer_name":"","pack_maintainer_url":"","scopes":["global"],"categories":["disasters","hazard"],"geographic_levels":["2"],"row_count_total":51696,"file_size_mb_total":0.63,"browser_storage_estimate_mb_total":0.63,"working_set_estimate_mb_total":8.73,"browser_artifact_available":true,"browser_artifact_transfer_mb_total":0.63,"browser_artifact_stored_mb_total":0.63,"browser_artifact_expanded_mb_total":8.73,"size":{"contract_version":1,"transfer_mb":0.63,"browser_storage_estimate_mb":0.63,"working_set_estimate_mb":8.73},"load_policy":{"can_load_all_sources":true,"size_bucket":"small","reason":"Safe to load the full pack at once.","max_sources":8,"max_file_size_mb":200,"max_row_count":2000000},"download":{"available":true,"channel":"stable","version":"1.1.0","published_at":"2026-10-10T01:45:29.603137Z","current_manifest_url":"https://downloads.daedalmap.com/downloadable/packs/volcanoes/volcanoes-lite/stable/current.json","version_manifest_url":"https://downloads.daedalmap.com/downloadable/packs/volcanoes/volcanoes-lite/stable/1.1.0/version.json","artifact_url":"https://downloads.daedalmap.com/downloadable/packs/volcanoes/volcanoes-lite/stable/1.1.0/pack.zip","filename":"pack.zip","sha256":"7cb1228845a4956242f445df49091ef42b9f3651f04b0bd3b1fe2a936ab1deed","size_bytes":931897,"file_count":13,"validation_status":"passed"},"default_load":{"kind":"overlay_range_load","overlay_id":"volcanoes","relative_years":10,"params":{"min_vei":3,"exclude_ongoing":true},"summary":"Showing major volcanic eruptions -- explosivity index (VEI) 3 and above -- worldwide over the last 10 years. Ask to lower the VEI, focus a region, or see the deadliest eruptions."},"default_question":"Show me the biggest recent volcanic eruptions worldwide (VEI 3 and above over the last 10 years).","default_response":"Showing major volcanic eruptions -- explosivity index (VEI) 3 and above -- worldwide over the last 10 years. Ask to lower the VEI, focus a region, or see the deadliest eruptions.","example_questions":["Show me the biggest recent volcanic eruptions worldwide, not just every volcano on the map.","Can I see the volcanic eruptions Indonesia has had since 2000?"],"permission":"free","license_policy":{"schema_version":"1.2.0","license":"Smithsonian GVP Terms of Use (non-commercial)","permission":"free","resolution_status":"resolved","policy_source":"build/catalog/license_permission_crosswalk.csv","reason":"Non-commercial terms prohibit paid hosted use.","redistribution":"restricted","share_alike":"no","attribution_required":true,"attribution_template":"Global Volcanism Program, Smithsonian Institution. {title?}.","source_url":"https://volcano.si.edu/gvp_termsofuse.cfm","reviewed_on":"2026-09-10","notes":"Conservative label for general GVP content. The official page separately identifies some U.S.-employee database and report content, but this row does not broaden a product unless its exact content class is recorded.","reuse_obligations":{"copyleft_scope":null,"required_public_license":null,"source_offer_required":null}},"provenance_fingerprint":"1f338c1a1eb86bbfa7eea1cb236712649a1d0749ea5176eaa5d5c8be8fbf5ec1","license_conditions":{"permission":"free","redistribution":"restricted","share_alike":"no"},"attribution_text":"Global Volcanism Program, Smithsonian Institution. Volcanoes.","attribution_lines":["Global Volcanism Program, Smithsonian Institution. Volcanoes."],"citation":{"style":"daedalmap-1","entries":[{"text":"Smithsonian Institution Global Volcanism Program. Volcanoes. Smithsonian GVP Terms of Use (non-commercial). https://volcano.si.edu/.","role":"data","parts":{"role":"data","agency":"Smithsonian Institution Global Volcanism Program","title":"Volcanoes","vintage":"","url":"https://volcano.si.edu/","license":"Smithsonian GVP Terms of Use (non-commercial)"}}],"text":"Smithsonian Institution Global Volcanism Program. Volcanoes. Smithsonian GVP Terms of Use (non-commercial). https://volcano.si.edu/."},"live_watermark_utc":"2026-03-10T00:00:00","last_updated":"2026-07-10"}