Roadmap

PyWorldAtlas grows through small, installable releases with explicit data, documentation, and compatibility boundaries. Planned work is not part of the public API until it is implemented, tested, documented, and published.

Current release

0.9.4 adds accessible automatic rotation, adjustable motion, crisp image export, and a repeatable documentation-animation workflow.

Next milestone

Stable-API hardening will focus on consistency, typing, performance, packaging, compatibility, and complete reference coverage.

Stable destination

1.0.0 represents a dependable offline atlas contract with clear upgrades and reproducible releases.

Release train

Version

Status

Main boundary

Publication

0.1.0

Complete

Rebuilt runtime, generated database, countries, capitals, and cities

Published

0.2.1

Complete

Rich profiles, coordinates, distances, and initial discovery tools

Published

0.3.1

Complete

Reviewed neighbors, shortest land paths, and border learning tools

Published

0.5.0

Complete

Local identities, English formal names, and editorial policy

Published

0.6.0

Complete

Reference facts, practical metadata, filters, and rankings

Published

0.7.0

Complete

Physical geography, climate classes, feature search, and learning prompts

Published

0.8.0

Complete

Summaries, city discovery, coordinate helpers, quizzes, and documentation UX

Published

0.9.1

Complete

Optional 3D elevation and climate maps, river overlays, and HTML export

Published

0.9.2

Complete

Terrain-height controls, selectable labels, and sharper map presentation

Published

0.9.3

Complete

Installation, API-reference, Explore, and project-page polish

Published

0.9.4

Complete

Map rotation, speed controls, PNG export, and documentation animation

Release candidate

1.0.0

Planned

Stable offline atlas contract

What 0.9 adds

The map release is an optional presentation layer over documented geographic sources:

  • map() resolves any existing country query;

  • show() opens a local browser view;

  • figure() supports notebooks and direct Plotly customization;

  • write_html() creates a standalone offline document with configurable initial rotation;

  • standalone viewers provide rotation-speed and high-resolution PNG controls; and

  • Overview and Standard editions offer the same 248-profile API at different elevation sampling intervals.

See Interactive 3D maps for installation, examples, sources, and interpretation limits.

Deferred work

Boundary geometry, GeoJSON export, bounding boxes, polygon centroids, and point-in-country lookup remain outside the current plan. The 0.9 viewer uses generalized outlines internally for display but does not expose them as a public geographic geometry API.

Native desktop rendering, Detailed and Ultra map editions, anthem lyrics, audio, contributor histories, and adoption dates also remain outside the current release.