Package: explodemap 0.5.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.5.0.tar.gz
explodemap_0.5.0.zip(r-4.7-any)explodemap_0.5.0.zip(r-4.6-any)explodemap_0.5.0.zip(r-4.5-any)
explodemap_0.5.0.tgz(r-4.6-any)explodemap_0.5.0.tgz(r-4.5-any)
explodemap_0.5.0.tar.gz(r-4.7-any)explodemap_0.5.0.tar.gz(r-4.6-any)
explodemap_0.5.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.59 score 382 downloads 59 exports 59 dependencies

Last updated from:b2fbf96717. Checks:9 OK. Indexed: yes.

TargetResultTimeFilesSyslog
linux-develOK225
source / vignettesOK215
linux-releaseOK207
macos-releaseOK110
macos-oldrelOK113
windows-develOK114
windows-releaseOK117
windows-oldrelOK119
wasm-releaseOK195

Exports:anchor_tableapply_region_offsetsas_dragmapras_dragmapr_stateas_hhs_statesas_sfassign_spatial_groupscache_clearcache_listcalibration_rowchild_layout_geometrychild_layout_offsetscompare_layoutscompute_statsconnector_geometrycount_geometry_verticesderive_paramsdiagnose_layoutdisplacement_magnitudese_fingerprintestimate_block_radiiexplode_groupedexplode_sectionexplode_sfexplode_sf_with_lookupexplode_stateexport_topojsonfinal_geometryfocus_mapfocus_map_presetfocusmapOutputfocusMapProxygroup_geometrygroup_palettehhs_display_offsetshhs_focus_maphhs_layouthhs_palettehhs_region_nameshhs_regionslayout_childrenlayout_objectivelayout_offsetslayout_regionslocal_geometryoptimize_grouped_layoutoriginal_geometryprepare_explodemap_inputread_drag_offsetsrenderFocusmapsimplify_to_vertex_budgetspatial_join_indextransition_dataupdate_exploded_layoutupdate_focus_dataupdate_focus_labelsupdate_focus_palettevalidate_explodemap_inputvalidate_spatial_join

Dependencies:base64encbslibcachemclassclassIntclicpp11DBIdigestdplyre1071evaluatefarverfastmapfontawesomefsgenericsggplot2gluegtablehighrhtmltoolshtmlwidgetsisobandjquerylibjsonliteKernSmoothknitrlabelinglifecyclemagrittrmemoisemimepillarpkgconfigproxypurrrR6rappdirsRColorBrewerRcpprlangrmarkdowns2S7sassscalessftibbletidyselecttinytexunitsutf8vctrsviridisLitewithrwkxfunyaml

Explode, edit, compare, render
1. Explode | 2. Measure the layout | 3. Hand off to dragmapr | 4. Edit | 5. Compare before and after | 6. Render and export
Rendered fromexplode-edit-render.Rmdusingknitr::rmarkdown

Last update: 2026-09-21
Started: 2026-09-21

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-09-21
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
Access grouped-layout anchor dataanchor_table
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
Extract plain sf geometry from an exploded layoutas_sf
Assign generated spatial groupsassign_spatial_groups
Clear explodemap download cachecache_clear
List cached datasetscache_list
Extract calibration row from an exploded_mapcalibration_row
Access a child layoutchild_layout_geometry child_layout_offsets
Compare displacement between two exploded layoutscompare_layouts
Compute geometry statistics for parameter derivationcompute_stats
Connector geometry for computed layout movementconnector_geometry
Count geometry verticescount_geometry_vertices
Derive displacement parameters from geometry statisticsderive_params
Diagnose grouped layout qualitydiagnose_layout
Per-feature displacement magnitudes of an exploded layoutdisplacement_magnitudes
Fingerprint explodemap geometry and groupinge_fingerprint
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
Export an exploded map as TopoJSONexport_topojson
Interactive focus-map viewerfocusmapOutput focus_map renderFocusmap
Focus-map option presetsfocus_map_preset
[Experimental] 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
[Experimental] 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
Lay out child geography around a parentlayout_children
Build layout objective weightslayout_objective
Computed offsets from a grouped exploded layoutlayout_offsets
Compute region anchor positions for grouped layoutslayout_regions
Search grouped-layout parametersoptimize_grouped_layout
Access geometry from a grouped exploded layoutfinal_geometry group_geometry local_geometry original_geometry
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
Build a stable spatial join indexspatial_join_index
Summary of an exploded_map objectsummary.exploded_map
Summary of a grouped_exploded_map objectsummary.grouped_exploded_map
Renderer-neutral transition datatransition_data
Update an exploded grouped layout after manual compositionupdate_exploded_layout
Validate explodemap inputvalidate_explodemap_input
Validate an external data-to-spatial joinvalidate_spatial_join