Skip to contents

Create geographic area maps, geographic networks and schematic networks in R, then share them as a single offline HTML file. The viewer requires no R installation, server, API key or internet connection.

Details

Start with atlas. Add geographic variables with add_areas, or entities and connections with add_nodes and add_edges. Finish with export_html.

The API is experimental. sf, ggplot2, igraph and ggrepel are required authoring dependencies. The installer includes them automatically when missing. sf handles polygon and point inputs; ggplot2 creates editable static area maps and networks through as_ggplot. igraph supplies layouts and network measures; ggrepel places static labels. Saved HTML and image files require no R packages. Installing authoring dependencies may need internet access. Preparing the bundled examples and viewing their exports use local resources.

Getting started

Read the installed tutorial with vignette("getting-started", package = "offlineatlas"). It covers a GDP map, Florence marriages, an FDI timeline, presentation options, and static figures. example_data reads bundled tables; example_file locates local assets and notices.

Presentation

Use set_view for explicit or automatic regional framing. Choose set_preset for compact or presentation defaults. Add one geographic detail panel with set_inset. Use set_background for a schematic illustration. set_controls, set_legend and set_style customize the viewer from R. Configuration functions replace their own settings using supplied arguments and defaults; keep the desired overrides together in one call.

Time and missing data

Use summary.offline_atlas through summary(x) to inspect coverage, missing values and numeric sign counts before export. Area panels use fixed geometry and labels, with one row per area and period. Numeric breaks and categorical colors stay fixed across periods. Explicit NA, zero and negative observations remain distinct. See add_areas for panel requirements and add_edges for network coverage rules. Playback, selection and numeric country histories run in the browser.

Current limits

HTML maps use one equirectangular display projection, with longitude -180 to 180 and latitude -60 to 85. Regional framing does not change projection. One rectangular geographic inset is supported. Schematic layouts can be supplied or computed with layout_network. Self-links, changing historical boundaries and synchronized map/network panels are not implemented. Large-data performance is unmeasured. Static ggplot output supports sf area maps and networks, without insets or SVG illustrations. Automatic label placement is best-effort; crowded figures may need more space. Read source notes and preserve dataset attribution.