Package: explodemap 0.3.0

explodemap: Hierarchical Exploded-View Cartography

Tools for generating hierarchical exploded-view maps from dense administrative boundary data. The package applies rigid-body translations to polygon geometries using a centroid-driven vector field, preserving the internal geometry of each feature while separating units within and across regions. Parameters can be derived analytically from dataset geometry using closed-form models for regional separation and local expansion. The package also includes grouped layouts, optional bounded collision refinement, and an interactive focus-map widget for selected-area inspection in 'htmlwidgets' and 'Shiny'. It implements the methodology described in George Arthur (2026) <https://github.com/PrigasG/explodemap> "A Hierarchical Vector-Based Framework for Multi-Scale Exploded-View Cartography".

Authors:George Arthur [aut, cre]

explodemap_0.3.0.tar.gz
explodemap_0.3.0.zip(r-4.7)explodemap_0.3.0.zip(r-4.6)explodemap_0.3.0.zip(r-4.5)
explodemap_0.3.0.tgz(r-4.6-any)explodemap_0.3.0.tgz(r-4.5-any)
explodemap_0.3.0.tar.gz(r-4.7-any)explodemap_0.3.0.tar.gz(r-4.6-any)
explodemap_0.3.0.tgz(r-4.6-emscripten)
manual.pdf |manual.html✨
DESCRIPTION |NEWS
card.svg |card.png
explodemap/json (API)

# Install 'explodemap' in R:
install.packages('explodemap', repos = c('https://prigasg.r-universe.dev', 'https://cloud.r-project.org'))

Bug tracker:https://github.com/prigasg/explodemap/issues

Pkgdown/docs site:https://prigasg.github.io

On CRAN:

Conda:

5.35 score 487 downloads 43 exports 60 dependencies

Last updated from:99971279c2. Checks:9 OK. Indexed: yes.

TargetResultTimeFilesSyslog
linux-devel-x86_64OK165
source / vignettesOK251
linux-release-x86_64OK141
macos-release-arm64OK85
macos-oldrel-arm64OK103
windows-develOK93
windows-releaseOK96
windows-oldrelOK115
wasm-releaseOK166

Exports:apply_region_offsetsas_dragmapras_dragmapr_stateas_hhs_statesassign_spatial_groupscache_clearcache_listcalibration_rowcompute_statscount_geometry_verticesderive_paramsdiagnose_layoutestimate_block_radiiexplode_groupedexplode_sectionexplode_sfexplode_sf_with_lookupexplode_stateexplodemap_fingerprintexport_topojsonfocus_mapfocus_map_presetfocusmapOutputfocusMapProxygroup_palettehhs_display_offsetshhs_focus_maphhs_layouthhs_palettehhs_region_nameshhs_regionslayout_objectivelayout_regionsoptimize_grouped_layoutprepare_explodemap_inputread_drag_offsetsrenderFocusmapsimplify_to_vertex_budgetupdate_exploded_layoutupdate_focus_dataupdate_focus_labelsupdate_focus_palettevalidate_explodemap_input

Dependencies:base64encbslibcachemclassclassIntclicpp11DBIdigestdplyre1071evaluatefarverfastmapfontawesomefsgenericsggplot2gluegtablehighrhtmltoolshtmlwidgetsisobandjquerylibjsonliteKernSmoothknitrlabelinglifecyclemagrittrMASSmemoisemimepillarpkgconfigproxypurrrR6rappdirsRColorBrewerRcpprlangrmarkdowns2S7sassscalessftibbletidyselecttinytexunitsutf8vctrsviridisLitewithrwkxfunyaml

State-first composition with dragmapr
1. Compute the layout | 2. Hand the layout over as a state | 3. Compose | 4. Render the composed state
Rendered fromstate-first-composition.Rmdusingknitr::rmarkdown

Last update: 2026-06-26
Started: 2026-06-26

Reproducing the paper examples
Overview | 1. New Jersey — Ground-truth calibration (Section 5) | 2. Pennsylvania — Transfer test (Section 6) | Sensitivity analysis | 3. Cross-state calibration (Section 7) | 4. Ohio — Extended validation (Section 7) | 5. Canada — Non-US validation (Section 7) | 6. HHS national grouped layout (Section 12) | Replication checklist | Paper drag helpers | Session info
Rendered fromreproducing-paper-examples.Rmdusingknitr::rmarkdown

Last update: 2026-06-07
Started: 2026-03-24

Choosing an explodemap workflow
The short version | Static exploded maps | Dense municipal cores | Grouped layouts | Interactive focus maps | Performance guidance | Installed examples
Rendered fromworkflow-guide.Rmdusingknitr::rmarkdown

Last update: 2026-05-26
Started: 2026-04-13

Getting started with explodemap
Overview | Input requirements | A minimal example | Running the explosion | Diagnostics | Plotting | Calibration output | Manual parameter overrides | Optional collision refinement | Centroid options | Using TIGER/Line data for U.S. states | Using a lookup table | Export | Interactive focus maps and Shiny | Notes | Next steps
Rendered fromgetting-started.Rmdusingknitr::rmarkdown

Last update: 2026-05-26
Started: 2026-03-24

Grouped layouts and anchor placement
Overview | A synthetic grouped example | Anchor modes | Automatic grouped layout | Collision-aware grouped layout | Viewing all stages | Inspecting anchor positions | Manual anchors | Key parameters | Summary | Interactive grouped focus maps | What the grouped object stores | Scope of guarantees | Next steps
Rendered fromgrouped-layouts.Rmdusingknitr::rmarkdown

Last update: 2026-05-11
Started: 2026-03-24

Readme and manuals

Help Manual

Help pageTopics
Apply documented display offsets by regionapply_region_offsets
Convert a grouped layout to a drag-edit handoff object (legacy)as_dragmapr
Convert a grouped layout to a dragmapr editing stateas_dragmapr_state
Standardize state polygons for HHS reference mapsas_hhs_states
Assign generated spatial groupsassign_spatial_groups
Clear explodemap download cachecache_clear
List cached datasetscache_list
Extract calibration row from an exploded_mapcalibration_row
Compute geometry statistics for parameter derivationcompute_stats
Count geometry verticescount_geometry_vertices
Derive displacement parameters from geometry statisticsderive_params
Diagnose grouped layout qualitydiagnose_layout
Estimate block radius for each regionestimate_block_radii
Create a three-level grouped exploded mapexplode_grouped
Explode one selected section and keep the rest as contextexplode_section
Explode any sf object with an existing grouping columnexplode_sf
Explode any sf object using an external lookup tableexplode_sf_with_lookup
Explode a US state from TIGER/Line dataexplode_state
Fingerprint explodemap geometry and groupingexplodemap_fingerprint
Export an exploded map as TopoJSONexport_topojson
Interactive focus-map viewerfocusmapOutput focus_map renderFocusmap
Focus-map option presetsfocus_map_preset
Focus-map Shiny proxyfocusMapProxy update_focus_data update_focus_labels update_focus_palette
Create a stable group palettegroup_palette
HHS reference-layout display offsetshhs_display_offsets
Create a focus-map widget for HHS regionshhs_focus_map
Build an HHS reference layouthhs_layout
HHS region colour palettehhs_palette
HHS region display nameshhs_region_names
HHS regional assignments for states and territorieshhs_regions
Build layout objective weightslayout_objective
Compute region anchor positions for grouped layoutslayout_regions
Search grouped-layout parametersoptimize_grouped_layout
Plot an exploded_map objectplot.exploded_map
Plot a grouped_exploded_map objectplot.grouped_exploded_map
Plot a grouped-layout diagnosticplot.layout_quality_report
Prepare input for grouped explodemap layoutsprepare_explodemap_input
Print an exploded_map objectprint.exploded_map
Print a grouped_exploded_map objectprint.grouped_exploded_map
Read drag-helper offset CSVs into a region offset data frameread_drag_offsets
Simplify geometry to a vertex budgetsimplify_to_vertex_budget
Summary of an exploded_map objectsummary.exploded_map
Summary of a grouped_exploded_map objectsummary.grouped_exploded_map
Update an exploded grouped layout after manual compositionupdate_exploded_layout
Validate explodemap inputvalidate_explodemap_input