# South Sudan maps: sources

## states.json

TopoJSON, object `units`, 13 features: the ten states and the three administrative areas. Feature
`id` = the unit key in `src/lib/south-sudan/places.ts` (`central-equatoria` … `warrap`,
`greater-pibor`, `ruweng`, `abyei`). Properties: `name`, `kind` (`state` or `area`), `parent`
(the state the National Elections Commission counts the unit's constituencies under; a state's
own name for a state) and `constituencies` (how many of the NEC's 102 are drawn in the unit).

- **Source:** OCHA Common Operational Dataset, administrative boundaries (COD-AB), South Sudan,
  version 03, HDX dataset `cod-ab-ssd`
  (https://data.humdata.org/dataset/cod-ab-ssd), file `ssd_admin_boundaries.geojson.zip`, layer
  `ssd_admin2` (counties). Contributors named by HDX: South Sudan Information Management Working
  Group (IMWG), National Bureau of Statistics (NBS), IOM and OCHA. Boundaries created November
  2020, valid from 19 December 2022, reviewed 9 October 2024, resource dated 19 August 2026.
  Downloaded 9 November 2026.
- **Licence:** Creative Commons Attribution for Intergovernmental Organisations (CC BY-IGO 3.0).
  Attribution: **OCHA COD-AB South Sudan (IMWG, NBS, IOM, OCHA), via HDX.**
- **Why COD-AB:** no South Sudanese government body (the NEC, the National Bureau of Statistics or
  a survey department) publishes boundary files online that we could find. COD-AB is the
  humanitarian reference set and names the NBS among its sources; it is used as the best available
  source, not as an official one.
- **Method:** `bun scripts/south-sudan/maps.ts`. COD-AB's ADM1 layer has only the ten states, so
  the script works from ADM2 (78 counties, plus a unit "Abyei Region" that COD-AB keeps outside
  the ten states). Every county is assigned to one unit in `places.ts` (`UNITS[].counties`), and
  the counties are dissolved by unit, so the areas and their parent states share edges exactly:
  - **Greater Pibor Administrative Area** = Pibor + Pochalla counties, taken out of Jonglei. These
    are the two counties carved out of Jonglei for the area (2014, and again in 2020 after Boma
    State was dissolved; since split into six counties that COD-AB does not draw). The NEC lists
    Pochalla and Pibor West/East under "Pibor Administrative Area".
  - **Ruweng Administrative Area** = Pariang + Abiemnhom counties, taken out of Unity. The NEC lists
    Pariang and Abiemnon under "Ruweng Administrative Area".
  - **Abyei Area** = COD-AB "Abyei Region" as drawn (about 10,500 km²). It is not part of Warrap in
    COD-AB, so nothing is subtracted. Abyei is claimed by both South Sudan and Sudan; its final
    status has not been determined, and the site draws and names it without taking a position.
  The script stops if a county is unassigned or assigned twice, if a state's county is not in that
  state in COD-AB, or if the result is not 13 units. Simplified with mapshaper (Visvalingam
  weighted, 20%, shapes kept, slivers filtered, quantisation 1e5): about 45 KB.
- **Outline:** COD-AB's outline is not an authority on international boundaries. It includes the
  Ilemi Triangle (administered by Kenya) inside Eastern Equatoria, and Western Bahr el Ghazal
  reaches 10.43° N, which appears to include Kafia Kingi (administered by Sudan); the latter is
  read from the coordinates and is UNVERIFIED.

## counties.json

TopoJSON, object `counties`, 79 features: COD-AB's 78 counties plus "Abyei" (the Abyei Region,
which COD-AB keeps outside the ten states). Feature `id` = the COD-AB ADM2 pcode (`SS0101` …).
Properties: `name` (COD-AB `adm2_name`, as in `places.ts` `UNITS[].counties`) and `unit` (the
`places.ts` unit key the county is dissolved into for states.json).

- **Source and licence:** as states.json (COD-AB v03, layer `ssd_admin2`; CC BY-IGO 3.0).
  Attribution: **OCHA COD-AB South Sudan (IMWG, NBS, IOM, OCHA), via HDX.**
- **Method:** `bun scripts/south-sudan/constituency-map.ts`. Simplified with mapshaper
  (Visvalingam weighted, 15%, shapes kept, quantisation 1e5): about 55 KB. Counties created since
  COD-AB's county set was fixed (for example the six counties Greater Pibor is now divided into)
  are not drawn.

## constituencies.json: an UNOFFICIAL reconstruction

**These are not official boundaries.** The National Elections Commission publishes no
constituency maps or boundary files, and none were found for the 2010 constituencies its list
reinstates. Its list of the 102 constituencies (22 December 2025,
https://nec.gov.ss/press-statement-of-the-chairperson-of-the-national-elections-commission-of-the-republic-of-south-sudan/)
describes each by the payams ("residential units") it printed, sometimes with a county. The site
reconstructs each constituency by dissolving the COD-AB payams (ADM3) whose names match. Payam
names and lines have changed since 2010 (COD-AB's payams were drawn in 2020, valid from 2022), many
NEC names are bomas, town quarters or old spellings, and some listed payams sit in a different
county in COD-AB than the NEC implies, so every polygon is approximate.

TopoJSON, object `constituencies`, 100 features. Feature `id` = the constituency id in
`src/data/south-sudan/snapshot/constituencies.json` (`central-equatoria-1` …). Properties: `name`,
`number` (the NEC's number within the state), `unit` (the `places.ts` unit key it is drawn in) and
`match` (`full`, `partial` or `county`; see below).

- **Source and licence:** COD-AB v03 (HDX dataset `cod-ab-ssd`), file
  `ssd_admin_boundaries.geojson.zip`, layer `ssd_admin3` (512 payams; fields `adm3_name`,
  `adm3_pcode`, `adm2_pcode`, `adm1_name`). CC BY-IGO 3.0. Attribution: **OCHA COD-AB South Sudan
  (IMWG, NBS, IOM, OCHA), via HDX.** Downloaded 9 November 2026. No better payam layer was found:
  HDX has only this COD-AB (v03; the GeoDatabase, shapefile and GeoJSON downloads are the same
  data), and HDX search turned up no other payam layer for South Sudan (Kontur's set there is
  OpenStreetMap-based); geoBoundaries was not compared (UNVERIFIED whether it differs from COD-AB). The NBS publishes no boundary files online.
- **Method:** `bun scripts/south-sudan/constituency-map.ts`, matching with
  `src/lib/south-sudan/payam-match.ts` (tested in `tests/south-sudan-maps.test.ts`). Each NEC name
  is normalised (case, diacritics, "Payam", hyphens and spaces, roman numerals, doubled letters)
  and looked up first in the county the NEC named, then in the constituency's map unit, then in
  the whole state as the NEC counts it (so Warrap includes Abyei). Spellings no rule can bridge
  are written down in `PAYAM_ALIASES`, each with a note (several are marked "Probable"); typing
  slips in the printed list are repaired in `UNIT_FIXES`. "All payams of X" takes county X whole.
  A payam claimed by two constituencies is drawn once, for the claimant with fewer payams (ties to
  the lower number). Simplified with mapshaper (Visvalingam weighted, 20%, shapes kept,
  quantisation 1e5): about 78 KB. The full match, per constituency, is in
  `src/data/south-sudan/snapshot/constituency-payams.json`.
- **Match (9 November 2026):** `full` 69 (every listed payam matched), `partial` 19 (some listed
  names matched nothing; 52 names unmatched in all), `county` 12 (the NEC listed no payams but
  named a whole county: Old Fangak, Pigi, Nyirol, Twic East, Duk, Pochalla, Rubkona, Guit,
  Mayendit, Mayom, Leer, Tonj East), `none` 2.
- **Contested payams (3):** Malual West (Gokmachar and Korok; drawn in Korok), Aweeng (Abyei and
  Twic, and Twic No. 2; drawn in No. 2) and Turalei (Abyei and Twic, and Twic Nos 2 and 4; drawn in
  No. 2). Twic No. 4 is drawn as Wunrok only.
- **Not drawn (`KNOWN_UNDRAWN`):** Northern Bahr el Ghazal No. 7, Aweil Town (the NEC lists town
  quarters COD-AB does not draw), and No. 9, Ayat and Majak (none of its five listed places is a
  COD-AB payam). The site shows them through their state.
- **Gaps:** 61 payams match no constituency (they are listed by state in the snapshot), mostly
  where the NEC's list uses bomas or old names (Northern Bahr el Ghazal 19), or where the NEC draws
  no constituency at all (Koch and Panyijiar counties in Unity, 17 payams; Mundri East and Nagero
  in Western Equatoria). Those areas are blank on the constituency layer; draw states.json beneath
  it.
- **Abyei is not drawn on the constituency layer.** The NEC counts Abyei under Warrap ("twelve (12)
  National Constituencies including Abyei Administrative Area"), and Warrap No. 1 is "Abyei and
  Twic". Abyei's final status is undetermined, so the constituency layer leaves OCHA's "Abyei
  Region" (SS000101) undrawn (`NOT_DRAWN_PAYAMS` in `payam-match.ts`): Warrap No. 1 is drawn from its
  Twic payams only, and the state layer shows Abyei in its own neutral colour.
- **Known oddities kept as the NEC wrote them:** Raga Centre is the whole of Raja County plus three
  payams COD-AB puts in Wau County (Bagari, Besselia, Kpaile); Maban includes Jalhak and Chemmedi,
  which COD-AB puts in Renk County; Gogrial West No. 5 has "part of Alek North", drawn as the whole
  payam.
