climate-impacts

tools

• compare_scenarios

  Compare climate projections across multiple scenarios side by side. Fetches data for each scenario in parallel and displays a comparison table at key time horizons. Args: country_iso: ISO 3166-1 alpha-3 country code. See climate://countries resource for all valid codes. variable: Climate variable ID (e.g. 'tasAdjust', 'prAdjust'). See climate://variables resource for all valid IDs — do NOT guess. scenarios: List of scenario IDs to compare (e.g. ['o_1p5c', 'h_cpol', 'h_ndc']). See climate://scenarios resource for all valid IDs. season: Season — one of 'annual', 'MAM', 'JJA', 'SON', 'DJF'. Default: 'annual'. spatial_weighting: Spatial aggregation method. Default: 'area'. time_horizons: Years to show in comparison. Default: [2030, 2050, 2100].

  in ▸ season variable scenarios country_iso time_horizons spatial_weighting

• get_climate_projections

  Get climate change projections for a country, variable, and scenario. Returns a timeseries from 2015 to 2100 with median, uncertainty range, and warming levels. Args: country_iso: ISO 3166-1 alpha-3 country code (e.g. 'DEU', 'USA'). See climate://countries resource for all valid codes. variable: Climate variable ID (e.g. 'tasAdjust', 'prAdjust'). See climate://variables resource for all valid IDs — do NOT guess. scenario: Emission scenario ID (e.g. 'h_cpol'). See climate://scenarios resource for all valid IDs. season: Season — one of 'annual', 'MAM', 'JJA', 'SON', 'DJF'. Default: 'annual'. spatial_weighting: Spatial aggregation — one of 'area', 'pop', 'gdp', 'harvarea', 'wheat', 'maize', 'soybean', 'rice', 'sum'. Default: 'area'.

  in ▸ season scenario variable country_iso spatial_weighting

• get_country_overview

  Get a comprehensive climate change impact overview for a country. Returns projections for key climate variables across multiple impact categories, comparing current policies (business as usual) vs 1.5C-compatible pathways. Accepts country names (e.g. 'Costa Rica') or ISO codes (e.g. 'CRI'). Args: country: Country name (e.g. 'Costa Rica', 'Germany') or ISO code (e.g. 'CRI', 'DEU'). season: Season — one of 'annual', 'MAM', 'JJA', 'SON', 'DJF'. Default: 'annual'.

  in ▸ season country

• get_spatial_data

  Get spatial (gridded) climate data for a country at a specific warming level. Returns full per-cell grid data (lat/lon/value/agreement), statistics, and country boundary (TopoJSON from world-atlas) for map rendering. Output includes a JSON block that can be used directly for D3/SVG visualizations. RENDERING INSTRUCTIONS: The response includes a `boundary` field with the country's TopoJSON border. You MUST use it as a clip path — do NOT fetch country borders from any external URL. Each grid cell is a 0.5deg x 0.5deg rectangle. Clip all grid cells to the `boundary` outline (D3: clipPath + topojson.feature) before rendering. NEVER filter, crop, or omit grid cells — render ALL cells including zeros and low values. Use a continuous color scale so zeros appear as the lightest shade, not gaps. Args: country_iso: ISO 3166-1 alpha-3 country code. See climate://countries resource for all valid codes. variable: Climate variable ID (e.g. 'tasAdjust', 'prAdjust'). See climate://variables resource for all valid IDs — do NOT guess. warming_level: Global warming level in degrees C (1.5, 2.0, 2.5, or 3.0). scenario: Emission scenario ID. Default: 'h_cpol'. See climate://scenarios resource for all valid IDs. season: Season. Default: 'annual'.

  in ▸ season scenario variable country_iso warming_level

• get_warming_level_snapshot

  View climate impacts indexed by global warming level (1.5/2.0/2.5/3.0C). Shows what impact values correspond to each warming level rather than by year. Args: country_iso: ISO 3166-1 alpha-3 country code. See climate://countries resource for all valid codes. variable: Climate variable ID (e.g. 'tasAdjust', 'prAdjust'). See climate://variables resource for all valid IDs — do NOT guess. scenario: Emission scenario ID. Default: 'h_cpol' (current policies). See climate://scenarios resource for all valid IDs. season: Season. Default: 'annual'. spatial_weighting: Spatial aggregation method. Default: 'area'.

  in ▸ season scenario variable country_iso spatial_weighting

• list_climate_variables

  List available climate variables, optionally filtered by category group. Args: group: Optional category filter (e.g. 'Climate', 'Heat', 'Agriculture').

  in ▸ group

• list_scenarios

  List all available emission scenarios with descriptions.

• lookup_country

  Look up a country's ISO code by name, or list countries in a group. Args: query: Country name (or partial name) to search for. Use '*' to list all. group: Optional country group filter (e.g. 'sids', 'ldc', 'g20'). Use list_scenarios to find group IDs.

  in ▸ group query