About the data
Where the lines come from.
The source
Every border, region and settlement here comes from historical-basemaps, a public dataset started by André Ourednik and corrected over the years by many contributors. It is released under the GNU General Public License v3, and so is this viewer. The maps are in WGS 84 (EPSG:4326), one GeoJSON file per snapshot, generalised for continent- and world-scale maps.
How much to trust a border
Each region carries a precision value, drawn three ways in the atlas. In practice the value is set mostly per snapshot: in this release every region of 1000 AD is rated approximate and every region of 1815 precise, so the line style tells you about the era more than about one border.
| Value | Meaning | Drawn as |
|---|---|---|
3 | Precise | Solid border, full colour |
2 | Moderately precise | Dashed border |
1 | Approximate | Faint dotted border, lighter fill |
Colours follow the controlling authority (SUBJECTO): a province is coloured as its empire. The dataset's author asks that the maps be checked against other sources before academic use.
Borders also carry a politics. Many territories are disputed today, and the dataset's own guidance is to draw each country as its own government sees it and let the overlaps show the dispute. Before the modern era, most of the land on any map belonged to no state at all.
Correcting a border
Corrections belong upstream, so everyone who uses the dataset gets them: open an issue or a pull request on aourednik/historical-basemaps, editing only the GeoJSON (QGIS is the suggested editor). Once accepted there, the fix reaches this atlas with the next sync.
How new snapshots arrive
This viewer is a fork that never edits the dataset's own files. The data folders are byte-for-byte upstream's; the viewer lives in its own site/ and tools/ folders. So bringing in new snapshots is an ordinary, conflict-free merge:
python tools/sync_upstream.py
That fetches upstream, merges it, checks that nothing in the viewer was touched, and rebuilds the home stack, the era thumbnails and the counts on these pages. A new snapshot appears on the timeline, the Eras page and the counts with no other change.
Credits
- Data: André Ourednik and contributors, historical-basemaps (GPL-3.0).
- Rendering: D3 and Leaflet, bundled with the site.
- Quotation on the home page: David Graeber and David Wengrow, The Dawn of Everything (2021), as quoted in the dataset's README.
- Viewer and design: SolutionsAsService.