Threadlands

A planning support system for city-regions

Every city lives on water, farms and wild places.

Threadlands helps planners and communities plan a city together with the land that sustains it. See how heat, flooding, food and wildlife connect across a region. Then test your plan against the climate of 2050 and find where to act first.

Three cities, one pattern

Explore a city

Place Fictional river cityDemo
Resilience index 0
Climate

Tap or hover a hex to inspect it.

    Pull the threads

    Drag a lever. The map and every score update together. Effort is capped, so the levers compete with each other.

    Effort used

    Tries about 4,000 lever settings within the effort cap and applies the highest-scoring one.

    Scores

    Each bar runs 0 to 100. The dark tick marks business as usual for this place.

    Stress tests

    The same map, hit three ways. Select one to see where it bites.

    Where to start

    The specific places where each action pays off most, ranked on today's map before any lever changes. Select a place to see it on the map.

      About this place's data

        Map key

          Regional threads

          Beyond the city

          A city drinks from a whole river basin and eats from land far beyond its edge. This view zooms out to show both for this place.

          Load any place

          Any city, state, region or country can become a Threadlands map. The place builder is a free Google Colab notebook that finds the place's outline, adds a ring of surrounding land so a city brings its farms, rivers and forests with it, and fills each hex from open global data.

          1. Open the Threadlands place builder notebook in Google Colab. In Colab, choose File, then Upload notebook. A free Google account is enough.
          2. In the first cell, type a place, such as Toluca, Mexico or Khon Kaen, Thailand.
          3. Choose Runtime, then Run all. A city takes a few minutes and a country takes longer. Your browser downloads a file ending in .threadlands.json.
          4. Choose Load a place file above, or drop the file onto the map.

          What each thread carries

          Water

          Flood or supply

          Rain that falls upstream reaches the city as a flood or as a steady supply. Wetlands, healthy soils and street trees decide which.

          Heat

          Stored or released

          Dense surfaces hold heat through the night. Shade, water and nearby vegetation pull it back out of the air.

          Food

          Buffer or exposure

          A region that grows more of its own food has more buffer when supply chains break. Farmland managed for soil is also habitat.

          Habitat

          Islands or network

          Species move along connected land. A city park and a forest stay separate islands until a corridor joins them.

          How the model works

          Every place is a set of hexes. Each hex carries its share of built-up land, trees, shrubs, grass, cropland, bare ground, water and wetland, plus its population, elevation and a flood screening value. The levers change the cover of specific hexes, and five scores are computed from the new map. Scores run from 0 to 100 and compare scenarios within one place. The weights are modelling choices made so that the levers trade off against each other. They are not forecasts.

          Reading the map
          A hex counts as built up when a quarter or more of it is buildings and paving. Built-up hexes split into dense core, mid-density and sprawl edge by population per km². Green hexes surrounded by city on three or more sides become city parks. Where none exist, new park sites go in the densest districts.
          Heat relief
          Each built-up hex gets a heat load from its population density. Street trees lower it, and so do cool neighbors such as forest, wetland, water, parks, greenways and farmland. Compact growth raises density because the same people live on less land.
          Flood safety
          A hex is flood-prone when a river runs through it, or when it sits within about 2 km of a river, lake or sea and less than 5 m above it. Rivers come from OpenStreetMap, because satellites miss narrow ones. Canals and small streams are drawn on the map but are not treated as flood sources, since most are controlled channels. People living in flood-prone built-up hexes carry the exposure. Restored wetlands hold the most water, with street trees and regenerative soils adding a little.
          Habitat network
          Forest, wetland, open grassland, water, parks, corridors and regenerative farms count as habitat. The score blends how much habitat exists, how much of it sits in one connected network, and how many city parks join that network. Corridors follow the cheapest path from the largest natural area to each park, avoiding dense districts where they can.
          Local food
          Cropland in the region is compared with what its people would need at about 0.19 hectares each, roughly the world average. Regenerative farms yield slightly less in a normal year and hold up much better in a drought. Farms near restored wetlands keep more water in a dry year.
          Satellite heat check
          A separate notebook adds measured surface temperature from Landsat 8 and 9 (2021 to 2025, clear skies only; the three hottest months outside the tropics, the whole year inside them). Each scene is compared with its own typical land temperature, and the median across scenes is kept, so hotter and cooler days can be pooled. The page then compares that measured pattern with the model\u2019s heat estimate using a rank correlation over built-up hexes. The first check, on Milan, showed the model leaning too hard on population density (correlation 0.38): warehouses and rail yards with few residents were among the hottest ground. Heat intensity now follows built-up surface for three quarters and population density for one quarter, which lifts Milan to 0.62. Without further tuning, the same change lifts San Francisco from 0.28 to 0.49 and Bangkok from 0.74 to 0.81. Land within a few kilometers of a large sea, bay or lake also gets a modest sea-breeze cooling. San Francisco\u2019s fog is a different matter: built-up land on the Pacific side measures about 0.7 \u00b0C below typical land, while the Bay shore runs 2 to 3 \u00b0C above it, because the fog comes from cold upwelling ocean water and the prevailing wind, not from nearness to water. No simple rule captures that, so wherever a place has satellite readings, the model corrects each built-up hex toward the measured value (70% of the gap, less where few clear scenes exist). The match figures shown are for the model before that correction, so the check stays honest.
          2050 stress test
          The climate switch reruns every score for about 2050. Global warming reaches about 2.0 \u00b0C on a middle path (SSP2-4.5) and 2.4 \u00b0C at high emissions (SSP5-8.5), compared with 1.09 \u00b0C in 2011\u20132020, and land warms about 1.46 times as fast as the global average. That gives about 1.3 \u00b0C or 1.9 \u00b0C of extra summer heat over land. Heat load rises 10% per degree. Heavy rain grows about 7% more intense per degree, raising flood exposure, and seas rise about 20 to 23 cm, adding exposure on coastal land under 3 m. Crop yields fall about 4% per degree, and twice that on conventional farms in a dry year, while living soils hold up better. Climate figures come from the IPCC Sixth Assessment Report; crop figures from Zhao and others, 2017.
          Where to start
          Each action gets its own ranking on today's map. Street trees go first where heat load and population are highest. Wetlands go first on low floodplain land with the most people in flood-prone homes within two hex rings. Corridors start with parks that are cut off from the main habitat, favoring short links near many people. Regenerative farming starts on farmland in the floodplain or next to habitat. Compact growth starts with the outermost sprawl, sooner where it floods. Sites that touch a site already listed are skipped, so each list covers more ground.
          Low-carbon travel
          Rises as sprawl is pulled back, with a small bonus for greenways and shade that make walking easier.
          Stress testMade of
          Heatwave50% heat relief, 25% habitat network, 25% local food
          River flood50% flood safety, 25% habitat network, 25% local food
          Drought year40% local food in a dry year, 20% water storage, 20% heat relief, 20% habitat network
          Resilience index80% average of the three tests, 20% low-carbon travel

          Levers cost different amounts per point: shade 0.9, corridors 0.6, wetlands 0.85, regenerative farming 0.8 and compact growth 1.6, against a cap of 240. The best-mix search tries every combination in steps of 20 that fits the cap. Several quite different mixes often score within a point or two of the best, so there is usually more than one good route.