# Choropleth
URL: /diagrammatic/docs/charts/choropleth

Regions colored by value.

> For AI agents: a documentation index is available at [llms.txt](/llms.txt). Use `.md` for canonical markdown pages; `.mdx` is kept as a backwards-compatible alias on supported URL paths.

```
import { Choropleth } from "diagrammatic";
```

A rate, never a count. The tiles are an abstract landmass. The legend is the scale a reader can use.

- aspect

  1.7

- title

  Checkout errors per 1k sessions

- values

  - 18
  - 19
  - 20
  - 21
  - 10
  - 10
  - 18
  - 19
  - 20
  - 21
  - 2.8
  - 2.8
  - 11
  - 11
  - 11
  - 18
  - 19
  - 20
  - 21
  - 3.2
  - 3.2
  - 3.2
  - 20.8
  - 20.8
  - 12
  - 12
  - 12
  - 3.6
  - 3.6
  - 3.6
  - 3.6
  - 3.6
  - 3.6
  - 22.2
  - 22.2
  - 22.2
  - 13
  - 13
  - 4
  - 4
  - 4
  - 4
  - 4
  - 23.6
  - 23.6
  - 4.4
  - 4.4
  - 4.4
  - 4.4
  - 4.4
  - 4.800000000000001
  - 4.800000000000001
  - 4.800000000000001
  - 4.800000000000001
  - 5.2
  - 5.2
  - 5.2

- legendLabel

  errors / 1k sessions

Illustrative data. Checkout POST errors per 1k sessions, week of 11 Aug.

fig. 55.1 · Checkout errors per 1k sessions

The east edge is the dark band, and it darkens further toward the south. The capital and the west coast form two smaller hot spots. The interior stays pale, because this is a rate and a large tile is not a large problem.

The metric remains errors per 1k sessions, now on hexagonal cells. One region, one hex. Adjacency is approximate. This is not a hexbin.

- aspect

  1.7

- title

  Incident rate by region

- tiles

  - - col

      3

    - row

      0

    - kind

      hex

    - size

      5.95

    - x

      61.25537550532245

    - y

      18

  - - col

      4

    - row

      0

    - kind

      hex

    - size

      5.95

    - x

      72.34050067376326

    - y

      18

  - - col

      5

    - row

      0

    - kind

      hex

    - size

      5.95

    - x

      83.42562584220407

    - y

      18

  - - col

      6

    - row

      0

    - kind

      hex

    - size

      5.95

    - x

      94.5107510106449

    - y

      18

  - - col

      7

    - row

      0

    - kind

      hex

    - size

      5.95

    - x

      105.5958761790857

    - y

      18

  - - col

      2

    - row

      1

    - kind

      hex

    - size

      5.95

    - x

      55.712812921102035

    - y

      27.6

  - - col

      3

    - row

      1

    - kind

      hex

    - size

      5.95

    - x

      66.79793808954285

    - y

      27.6

  - - col

      4

    - row

      1

    - kind

      hex

    - size

      5.95

    - x

      77.88306325798366

    - y

      27.6

  - - col

      5

    - row

      1

    - kind

      hex

    - size

      5.95

    - x

      88.96818842642448

    - y

      27.6

  - - col

      6

    - row

      1

    - kind

      hex

    - size

      5.95

    - x

      100.0533135948653

    - y

      27.6

  - - col

      7

    - row

      1

    - kind

      hex

    - size

      5.95

    - x

      111.13843876330611

    - y

      27.6

  - - col

      8

    - row

      1

    - kind

      hex

    - size

      5.95

    - x

      122.22356393174692

    - y

      27.6

  - - col

      1

    - row

      2

    - kind

      hex

    - size

      5.95

    - x

      39.08512516844081

    - y

      37.2

  - - col

      2

    - row

      2

    - kind

      hex

    - size

      5.95

    - x

      50.17025033688163

    - y

      37.2

  - - col

      3

    - row

      2

    - kind

      hex

    - size

      5.95

    - x

      61.25537550532245

    - y

      37.2

  - - col

      4

    - row

      2

    - kind

      hex

    - size

      5.95

    - x

      72.34050067376326

    - y

      37.2

  - - col

      5

    - row

      2

    - kind

      hex

    - size

      5.95

    - x

      83.42562584220407

    - y

      37.2

  - - col

      6

    - row

      2

    - kind

      hex

    - size

      5.95

    - x

      94.5107510106449

    - y

      37.2

  - - col

      7

    - row

      2

    - kind

      hex

    - size

      5.95

    - x

      105.5958761790857

    - y

      37.2

  - - col

      8

    - row

      2

    - kind

      hex

    - size

      5.95

    - x

      116.68100134752652

    - y

      37.2

  - - col

      9

    - row

      2

    - kind

      hex

    - size

      5.95

    - x

      127.76612651596733

    - y

      37.2

  - - col

      1

    - row

      3

    - kind

      hex

    - size

      5.95

    - x

      44.62768775266122

    - y

      46.800000000000004

  - - col

      2

    - row

      3

    - kind

      hex

    - size

      5.95

    - x

      55.712812921102035

    - y

      46.800000000000004

  - - col

      3

    - row

      3

    - kind

      hex

    - size

      5.95

    - x

      66.79793808954285

    - y

      46.800000000000004

  - - col

      4

    - row

      3

    - kind

      hex

    - size

      5.95

    - x

      77.88306325798366

    - y

      46.800000000000004

  - - col

      5

    - row

      3

    - kind

      hex

    - size

      5.95

    - x

      88.96818842642448

    - y

      46.800000000000004

  - - col

      6

    - row

      3

    - kind

      hex

    - size

      5.95

    - x

      100.0533135948653

    - y

      46.800000000000004

  - - col

      7

    - row

      3

    - kind

      hex

    - size

      5.95

    - x

      111.13843876330611

    - y

      46.800000000000004

  - - col

      8

    - row

      3

    - kind

      hex

    - size

      5.95

    - x

      122.22356393174692

    - y

      46.800000000000004

  - - col

      9

    - row

      3

    - kind

      hex

    - size

      5.95

    - x

      133.30868910018773

    - y

      46.800000000000004

  - - col

      10

    - row

      3

    - kind

      hex

    - size

      5.95

    - x

      144.39381426862855

    - y

      46.800000000000004

  - - col

      2

    - row

      4

    - kind

      hex

    - size

      5.95

    - x

      50.17025033688163

    - y

      56.400000000000006

  - - col

      3

    - row

      4

    - kind

      hex

    - size

      5.95

    - x

      61.25537550532245

    - y

      56.400000000000006

  - - col

      4

    - row

      4

    - kind

      hex

    - size

      5.95

    - x

      72.34050067376326

    - y

      56.400000000000006

  - - col

      5

    - row

      4

    - kind

      hex

    - size

      5.95

    - x

      83.42562584220407

    - y

      56.400000000000006

  - - col

      6

    - row

      4

    - kind

      hex

    - size

      5.95

    - x

      94.5107510106449

    - y

      56.400000000000006

  - - col

      7

    - row

      4

    - kind

      hex

    - size

      5.95

    - x

      105.5958761790857

    - y

      56.400000000000006

  - - col

      8

    - row

      4

    - kind

      hex

    - size

      5.95

    - x

      116.68100134752652

    - y

      56.400000000000006

  - - col

      9

    - row

      4

    - kind

      hex

    - size

      5.95

    - x

      127.76612651596733

    - y

      56.400000000000006

  - - col

      10

    - row

      4

    - kind

      hex

    - size

      5.95

    - x

      138.85125168440814

    - y

      56.400000000000006

  - - col

      3

    - row

      5

    - kind

      hex

    - size

      5.95

    - x

      66.79793808954285

    - y

      66

  - - col

      4

    - row

      5

    - kind

      hex

    - size

      5.95

    - x

      77.88306325798366

    - y

      66

  - - col

      5

    - row

      5

    - kind

      hex

    - size

      5.95

    - x

      88.96818842642448

    - y

      66

  - - col

      6

    - row

      5

    - kind

      hex

    - size

      5.95

    - x

      100.0533135948653

    - y

      66

  - - col

      7

    - row

      5

    - kind

      hex

    - size

      5.95

    - x

      111.13843876330611

    - y

      66

  - - col

      8

    - row

      5

    - kind

      hex

    - size

      5.95

    - x

      122.22356393174692

    - y

      66

  - - col

      9

    - row

      5

    - kind

      hex

    - size

      5.95

    - x

      133.30868910018773

    - y

      66

  - - col

      4

    - row

      6

    - kind

      hex

    - size

      5.95

    - x

      72.34050067376326

    - y

      75.60000000000001

  - - col

      5

    - row

      6

    - kind

      hex

    - size

      5.95

    - x

      83.42562584220407

    - y

      75.60000000000001

  - - col

      6

    - row

      6

    - kind

      hex

    - size

      5.95

    - x

      94.5107510106449

    - y

      75.60000000000001

  - - col

      7

    - row

      6

    - kind

      hex

    - size

      5.95

    - x

      105.5958761790857

    - y

      75.60000000000001

  - - col

      8

    - row

      6

    - kind

      hex

    - size

      5.95

    - x

      116.68100134752652

    - y

      75.60000000000001

  - - col

      5

    - row

      7

    - kind

      hex

    - size

      5.95

    - x

      88.96818842642448

    - y

      85.20000000000002

  - - col

      6

    - row

      7

    - kind

      hex

    - size

      5.95

    - x

      100.0533135948653

    - y

      85.20000000000002

  - - col

      7

    - row

      7

    - kind

      hex

    - size

      5.95

    - x

      111.13843876330611

    - y

      85.20000000000002

- values

  - 3
  - 3
  - 3
  - 3
  - 3
  - 9
  - 3.5
  - 3.5
  - 3.5
  - 3.5
  - 3.5
  - 17.6
  - 10
  - 10
  - 4
  - 4
  - 4
  - 4
  - 4
  - 19.2
  - 19.2
  - 11
  - 11
  - 4.5
  - 4.5
  - 4.5
  - 4.5
  - 4.5
  - 20.8
  - 20.8
  - 20.8
  - 12
  - 5
  - 5
  - 5
  - 5
  - 5
  - 22.4
  - 22.4
  - 22.4
  - 5.5
  - 5.5
  - 5.5
  - 5.5
  - 5.5
  - 24
  - 24
  - 6
  - 6
  - 6
  - 6
  - 25.6
  - 6.5
  - 6.5
  - 6.5

- legendLabel

  errors / 1k sessions

Illustrative data. Checkout POST errors per 1k sessions, week of 11 Aug.

fig. 55.2 · Incident rate on a honeycomb map

The eastern hexes are the dark cluster, and every column darkens toward the south. The west sits in between, and the middle stays pale.

- Use it for

  Rates and ratios across regions on one sequential ramp.

- Watch out

  Big areas dominate; map rates, never raw counts.