doxa-maps/plugin-designs/doxa-vision-card/HOW-THE-NUMBERS-ARE-COUNTED.md
doxa-maps-88655c70 33bd7ca387
Some checks are pending
Deploy to GitHub Pages / build (push) Waiting to run
Deploy to GitHub Pages / deploy (push) Blocked by required conditions
All People Groups loads fast on a light map; the Vision Card becomes a true funnel from data
ALL PEOPLE GROUPS. The Driver: "not even loading, takes a very long
time", and its DOXA pins were dark on a dark map.
- It downloaded the 7.5 MB people-groups-slim.json (22 columns) to draw
  ten fields. It now fetches people-groups-points.json: the same rows in
  column order, repeated strings in dictionaries, coordinates at 3
  decimals. 0.74 MB, generated deterministically by
  library/scripts/people-groups/build-points.mjs and staged into the tree
  by generate-tree. It falls back to the old file on an older tree.
- Pins no longer wait for the live prayer API. Every pin draws by GSEC
  from the file, and the DOXA overlay recolours when the API answers. The
  DOXA count reads "…" until then, not 0.
- Named style 'paper' (Mapbox light-v11 / MapLibre positron) instead of
  'ink'. The four categories keep their meaning; yellow and green are a
  step darker, and pins get a thin dark ring, so they read on near-white.
- Its words are in all 11 locales (allPeopleGroups.json), with a guarded
  useI18n and values passed to vue-i18n so {n} is not blanked.
Measured on a served built tree, 3 fresh runs each, median time to first
rendered pins: 8.3 s before, 5.2 s after, on localhost. This box renders
GL in software, so most of the remaining time is map start-up; the 10x
smaller download matters more on a real connection.

DOXA VISION CARD. The Driver: "the data doesn't make sense … super false
information". The card rotated four typed-in figures with no source.
It is now a proportional funnel, every number computed from data by
library/scripts/people-groups/build-vision-funnel.mjs:
  12,379 people groups   (IMB rows: one group in one country)
   7,341 unreached       (IMB LostnessPriority 0-2, < 2% evangelical)
   4,754 frontier        (LostnessPriority 0, < 0.1% evangelical)
   2,107 DOXA groups     (the DOXA prayer list, snapshot saved in data/;
                          1,745 of them frontier)
The first three nest; DOXA groups do not all sit inside frontier, so the
card says how many do. The rules are on the card ("How these are
counted") and in HOW-THE-NUMBERS-ARE-COUNTED.md, which also explains why
the total is not the 16-17 thousand of Joshua Project's count. Material
light, all 11 locales, right-to-left in Arabic, sources and dates shown.
The old fake stats are removed from the instances file, the frontier
page, the manifest, the staging page and the gallery.

CHECKS.
- check:vision-card-numbers recomputes the funnel independently (own CSV
  reader, the published rules) and compares with vision-funnel.json and,
  with --url, the rendered bars. Negative-tested: a corrupted count exits
  1. On the built tree: bars 12,379 / 7,341 / 4,754 / 2,107 and "1,745 of
  them are frontier", all matching.
- check:map-embed-cells measures PRODUCTION-MATRIX cells B and C for the
  seven gallery maps on a foreign origin; C proves the host's token is
  used by handing the host a distinct token and checking every Mapbox
  request. 14 of 14 pass.
2026-09-25 07:18:30 +00:00

1.9 KiB
Raw Blame History

How the Vision Card's numbers are counted

Every number on the card is computed from data. None is typed in. library/scripts/people-groups/build-vision-funnel.mjs writes them to data/people-groups/vision-funnel.json, and the card compiles that file in.

Step Rule Source field
People groups Every row of the IMB people-group data: one people group in one country all rows of people_groups.csv
Unreached Less than 2% evangelical IMB LostnessPriority 0–2 (Frontier, Pioneer, Expanding Unreached)
Frontier Less than 0.1% evangelical, a subset of the unreached IMB LostnessPriority 0 ("Frontier Unreached People Group")
DOXA people groups Every group on DOXA's prayer list, matched to the IMB row by people (ROP3) and country doxa-groups-snapshot.json, saved from pray.doxa.life/api/people-groups/list

The first three steps nest: frontier ⊂ unreached ⊂ all. DOXA groups do not nest inside frontier. Most are frontier, but not all, so the card states how many are ("1,745 of them are frontier") instead of drawing DOXA as a slice of frontier.

Populations sum the IMB Population of each step's rows. For DOXA groups, that is the rows the list matched; the few list entries with no IMB row count as groups but add no population.

Why the total is not 16–17 thousand. That figure counts people groups the way Joshua Project does. This card uses the IMB (peoplegroups.org) dataset that ships in this repository, which lists 12,379 people groups by country. doxa.life's own "Who are the unengaged?" funnel uses its own research data, so its figures differ slightly from these.

To refresh: replace data/people-groups/people_groups.csv, then run node library/scripts/people-groups/build-vision-funnel.mjs (add --offline to keep the saved DOXA list), then rebuild the bundle. The card shows the date of both sources.