Package 'dragmapr'

Description

Add or replace spatial features

Usage

add_spatial_features(x, features)

replace_spatial_features(x, ids, features, key_col = NULL)

Arguments

Value

An sf object.

Description

Apply a dragmapr state to sf geometry

Usage

apply_dragmapr_state(
  x,
  state,
  region_col = NULL,
  base_offsets = NULL,
  ancestor_offsets = NULL
)

Arguments

Value

An sf object with region offsets applied.

Description

apply_label_offsets() is deprecated. Use apply_label_state() instead.

Usage

apply_label_offsets(labels, label_offsets = NULL)

Arguments

Value

A label data frame with adjusted x and y.

Description

Apply draggable label state to a label table

Usage

apply_label_state(labels, label_state = NULL)

Arguments

Value

A label data frame with adjusted x and y.

Examples

labels <- as_drag_labels(data.frame(
  label_id = "North", region = "North", label = "North",
  x = 50000, y = 150000, stringsAsFactors = FALSE
))
state <- data.frame(
  label_id = "North", region = "North", dx_m = 5000, dy_m = -2000,
  stringsAsFactors = FALSE
)
apply_label_state(labels, state)

Description

Apply rigid offsets to grouped sf geometries

Usage

apply_offsets(x, offsets, region_col)

Arguments

Value

An sf object with geometries translated by group.

Examples

regions <- sf::st_sf(
  region = c("A", "B"),
  geometry = sf::st_sfc(sf::st_point(c(0, 0)), sf::st_point(c(100, 100)),
                        crs = 3857)
)
offsets <- data.frame(region = "A", dx_m = 5000, dy_m = -2000)
apply_offsets(regions, offsets, region_col = "region")

Description

Annotation boxes use the same position and state workflow as labels, but render as larger text boxes for notes, callouts, or location descriptions.

Usage

as_drag_annotations(
  labels,
  width_px = 150,
  height_px = 72,
  connector = FALSE,
  connector_type = c("straight", "elbow", "curve", "squiggle")
)

Arguments

Value

A normalized label data frame with label_type = "box".

Examples

as_drag_annotations(data.frame(
  label_id = "note-1", region = "North",
  label = "This note can hold more text than a short label.",
  x = 50000, y = 150000
))

Description

Use this for user-supplied labels. Extra columns are preserved so interactive applications can carry styling, tooltip, or grouping metadata alongside the core label position columns.

Usage

as_drag_labels(labels)

Arguments

Value

A normalized label data frame.

Examples

as_drag_labels(data.frame(
  label_id = "note-1", region = "North", label = "Check this",
  x = 50000, y = 150000, tooltip = "extra metadata"
))

Description

Prepares an sf object and transition list for parent-to-child leaf-flip bloom in drag_map_prototype().

Usage

build_branch_transition_data(
  x,
  parent_col,
  child_col,
  expanded = NULL,
  dissolve = TRUE,
  max_child_groups = 600L,
  animation = c("branch_bloom", "leaf_flip"),
  duration_ms = 375,
  easing = c("cubic-out", "cubic-in-out", "linear"),
  show_parent_ghost = FALSE,
  parent_ghost_opacity = 0.18,
  leaf_flip_strength = 0.16,
  leaf_child_scale = 0.86,
  leaf_expand_duration_factor = 0.82,
  leaf_collapse_duration_factor = 0.58,
  boundary = TRUE,
  boundary_behavior = c("drag", "none"),
  boundary_drag_threshold = 8,
  boundary_label = "Drag to",
  parent_key_col = "..dragmapr_parent_key..",
  child_key_col = "..dragmapr_child_key..",
  shell_col = "..dragmapr_parent_shell.."
)

Arguments

Value

A list with sf, transition, parent_key_col, child_key_col, shell_col, and validation.

Description

Prepares everything needed to animate child regions blooming out of their parent region: per-child anchor and final positions, relative motion strengths, ready-to-plot animation frames, and the dotted group-drag boundary for each expanded group. The parent layout itself is never moved (stable skeleton); only the expanded branch animates.

Usage

build_elastic_transition(
  child_sf,
  parent_sf,
  parent_col,
  parent_id_col = parent_col,
  options = transition_options()
)

Arguments

Details

Children whose parent id has no match in parent_sf fall back to their own centroid as the anchor (they fade in place instead of blooming), and a warning lists the unmatched ids so data problems are visible early.

The returned frames interpolate each child from a small seed at the parent centroid (frame 1) to its exact final geometry (last frame) using an ease-out-back curve, so the last frame equals child_sf and can be used as the settled state.

Value

A list of class "dragmapr_transition" with elements:

anchored

child_sf plus anchor_x, anchor_y, final_x, final_y, move_dist, move_ratio, stretch_strength, and duration_ms columns.

frames

An sf object of n_frames stacked copies of the children with frame_id, frame_progress, and frame_eased columns and interpolated geometry, suitable for ggplot2 playback or export.

boundaries

The dotted group-drag boundary per parent group from make_group_boundaries(), or NULL when options$group_drag_frame is FALSE.

options

The validated options used.

See Also

transition_options(), make_group_boundaries(), layout_metrics(), inherit_layout() for carrying drag offsets from parent to child groupings.

Examples

rect <- function(x0, x1, y0, y1) {
  sf::st_polygon(list(cbind(c(x0, x1, x1, x0, x0), c(y0, y0, y1, y1, y0))))
}
parents <- sf::st_sf(
  county = c("A", "B"),
  geometry = sf::st_sfc(rect(0, 3, 0, 3), rect(4, 7, 0, 3), crs = 3857)
)
children <- sf::st_sf(
  county = c("A", "A", "B", "B"),
  mun    = c("A1", "A2", "B1", "B2"),
  geometry = sf::st_sfc(
    rect(-1, 1, 0, 3), rect(2, 4, 0, 3),
    rect(3, 5, 0, 3), rect(6, 8, 0, 3),
    crs = 3857
  )
)
tr <- build_elastic_transition(
  children, parents,
  parent_col = "county",
  options    = transition_options(n_frames = 5)
)
names(tr)
head(tr$anchored[, c("county", "mun", "anchor_x", "final_x")])
tr$boundaries

Description

Adds editorial timing semantics to renderer-neutral movement data, including tables from explodemap::transition_data() and explodemap::layout_children(). The browser only needs to interpolate the supplied anchors according to the returned order and timing columns.

Usage

build_transition_plan(
  movement,
  duration = 650,
  easing = "elastic",
  stagger = 12,
  overshoot = 1.25
)

Arguments

Value

A dragmapr_transition_plan data frame containing the movement schema plus delay_ms, duration_ms, easing, and overshoot.

Description

Query hierarchy relationships

Usage

children_of(relationships, id, level = NULL)

parent_of(relationships, id, level = NULL)

descendants_of(relationships, id, level = NULL)

ancestors_of(relationships, id, level = NULL)

hierarchy_path(relationships, id, level = NULL)

Arguments

Value

children_of() and parent_of() return normalized edge subsets; descendants_of() and ancestors_of() return node tables; and hierarchy_path() returns the root-to-node IDs.

Description

Collapse drag offsets between hierarchy levels

Usage

collapse_drag_offsets(state, from, to, relation, method = "centroid")

Arguments

Value

A dragmapr_state at level to.

Description

Establishes the cross-package composition contract: algorithmic base movement (for example from explodemap), inherited ancestor movement, and local manual edits remain separately inspectable while their sum becomes the effective movement applied to geometry.

Usage

compose_offsets(base = NULL, state, ancestor_offsets = NULL, key_col = NULL)

effective_offsets(
  state,
  base_offsets = NULL,
  ancestor_offsets = NULL,
  key_col = NULL
)

Arguments

Details

effective_offsets() is the state-first alias for this composition path. Every caller that needs effective offsets goes through one of these two forms, so algorithmic, inherited, and manual layers always combine identically.

Value

A data frame with region, separate base/inherited/manual columns, and effective_dx_m/effective_dy_m.

Description

Coerce connector rows to sf lines

Usage

connector_sf(connectors, crs = NA)

Arguments

Value

An sf line layer.

Description

Captures the current drag offsets for a given grouping and returns a named list. Snapshots can be passed to inherit_layout() when switching to a finer grouping, or stored and later recovered with restore_layout_snapshot().

Usage

create_layout_snapshot(x, group, offsets = NULL)

Arguments

Value

A named list with elements group (character), offsets (data frame or NULL), and timestamp (POSIXct).

See Also

restore_layout_snapshot(), inherit_layout().

Examples

poly <- sf::st_sf(
  county = c("A", "B"),
  geometry = sf::st_sfc(
    sf::st_polygon(list(rbind(c(0,1e5),c(1e5,1e5),c(1e5,2e5),c(0,2e5),c(0,1e5)))),
    sf::st_polygon(list(rbind(c(0,0),c(1e5,0),c(1e5,1e5),c(0,1e5),c(0,0)))),
    crs = 3857
  )
)
offsets <- data.frame(region = c("A", "B"), dx_m = c(10000, -10000), dy_m = 0)
snap <- create_layout_snapshot(poly, group = "county", offsets = offsets)
snap$group
snap$offsets

Description

Launches a compact Shiny gadget that lets you pick a projected sf object from an environment, choose the region and label columns, adjust label, connector, legend, label-filter, movement-context, colour, and static-output settings, and interact with the D3 drag-map prototype inside the IDE viewer pane. When you click Done, the current region and label offsets are assigned as region_offsets and label_offsets in the same environment, ready to pass to render_dragged_map().

Usage

d_addin(env = d_global_env())

Arguments

Details

The addin appears under Addins > Launch dragmapr in RStudio once the package is installed.

Value

Invisibly returns a list with elements region_offsets, label_offsets, and static_options. The offset data frames are also assigned into env as region_offsets and label_offsets; static render settings are assigned as dragmapr_static_options.

See Also

drag_map_prototype() for the underlying HTML generator; render_dragged_map() to reconstruct a static ggplot2 image from the returned offsets.

Description

Inspects an sf object and reports geometry type, coordinate reference system, feature count, candidate grouping columns (including empty-value counts), detected parent-to-child column hierarchies (including cases where child names repeat across parents), and invalid geometry counts. The output guides column selection in drag_map_prototype() and helps diagnose unexpected behaviour when uploading custom spatial files to Spatial Studio.

Usage

d_diagnostics(x, region_col = NULL, quiet = FALSE)

Arguments

Value

An invisible named list with components:

geometry_type

Character vector of unique geometry type names.

crs

CRS identifier string (e.g. "EPSG:3857" or "Unknown CRS").

is_longlat

Logical — TRUE when the CRS is geographic.

n_features

Integer row count.

candidate_cols

Character vector of candidate grouping columns.

column_details

Named list with n_unique and n_empty per candidate column.

n_invalid_geometries

Number of features with invalid geometry.

hierarchy_pairs

List of detected parent-to-child column pairs, each with parent, child, n_parent, n_child, and child_repeats_across_parents.

recommended_path

Suggested grouping path string, or NULL.

Examples

poly <- sf::st_sf(
  county = c("Essex", "Essex", "Morris", "Morris"),
  mun    = c("Fairfield", "Caldwell", "Fairfield", "Roxbury"),
  geometry = sf::st_sfc(
    sf::st_polygon(list(rbind(c(0,1e5),c(1e5,1e5),c(1e5,2e5),c(0,2e5),c(0,1e5)))),
    sf::st_polygon(list(rbind(c(0,0),c(1e5,0),c(1e5,1e5),c(0,1e5),c(0,0)))),
    sf::st_polygon(list(rbind(c(1e5,1e5),c(2e5,1e5),c(2e5,2e5),c(1e5,2e5),c(1e5,1e5)))),
    sf::st_polygon(list(rbind(c(1e5,0),c(2e5,0),c(2e5,1e5),c(1e5,1e5),c(1e5,0)))),
    crs = 3857
  )
)
diag <- d_diagnostics(poly)

Description

A friendly front-door to the native draggable editor and the composition step of the state-first workflow: compute a layout, edit it, render the edited state. It accepts the objects produced upstream – a projected sf, an explodemap grouped_exploded_map, or a dragmapr_layout – together with an optional d_state(), and returns a configured d_widget() ready to embed in Shiny, R Markdown, or the viewer.

Usage

d_edit(x, region_col = NULL, state = NULL, ...)

Arguments

Details

For an explodemap layout, pass the composed state explicitly so the editor opens on the exploded composition rather than the bare geometry:

layout <- explodemap::explode_grouped(x, region_col = "region")
state  <- explodemap::as_dragmapr_state(layout)
d_edit(layout, state = state)

To capture edits back into a dragmapr_state (to persist, merge, or re-render them), read the widget's state input in Shiny with d_widget_state():

output$map <- renderDragmapr(d_edit(layout, state = state))
observeEvent(input$map_state, {
  state <- d_widget_state(input$map_state)
})

Value

A dragmapr htmlwidget (the interactive editor).

See Also

d_widget(), d_widget_state().

Description

These constructors separate options that affect source geometry from options that can be updated live in the browser.

Usage

d_geometry_options(width = 7200, height = 4800)

d_display_options(
  region_palette = NULL,
  show_origin_outlines = FALSE,
  show_movement_connectors = FALSE,
  show_drag_trail = FALSE,
  map_background = c("white", "transparent", "light_grid", "dark"),
  connector_color = "#334155",
  connector_linewidth = 1.3
)

d_interaction_options(
  draggable_regions = TRUE,
  draggable_labels = TRUE,
  state_emit = c("end", "throttled", "continuous"),
  live_drag = TRUE,
  throttle_ms = 75
)

Arguments

Value

A named list of options.

Description

A hierarchy state keeps one parent/root dragmapr_state together with any child-level states created while drilling into the map. It is useful for apps that move between levels such as divisions, states, counties, or municipalities without losing each level's edits.

Usage

d_hierarchy_state(
  root = d_state(),
  children = list(),
  active_path = character(),
  relationships = NULL,
  version = 0L
)

validate_dragmapr_hierarchy_state(hierarchy)

Arguments

Value

An object of class "dragmapr_hierarchy_state".

Description

d_history() creates an undo/redo stack for dragmapr_state objects. Push a checkpoint with d_history_push() after each meaningful edit, then step backwards with d_undo() and forwards with d_redo(). Pushing a new checkpoint clears the redo stack, matching familiar editor behaviour.

Usage

d_history()

d_history_push(history, state)

d_undo(history)

d_redo(history)

Arguments

Details

The history object has reference semantics: d_history_push(), d_undo(), and d_redo() modify it in place, so reassignment is optional.

Value

d_history() returns a dragmapr_history object; d_history_push() returns the history invisibly; d_undo() and d_redo() return the restored dragmapr_state.

Examples

h <- d_history()
s0 <- d_state(
  region_offsets = data.frame(region = "A", dx_m = 0, dy_m = 0)
)
d_history_push(h, s0)
s1 <- d_nudge(s0, "A", dx_m = 50)
d_history_push(h, s1)
back <- d_undo(h) # s0 offsets again
fwd <- d_redo(h)  # s1 offsets again
d_state_equal(back, s0)
d_state_equal(fwd, s1)

Description

Returns the JavaScript needed to pass region and label offset state from the draggable helper iframe back into Shiny inputs via postMessage, and to poll the iframe until state arrives. The string is suitable for wrapping in tags$head(tags$script(HTML(...))).

Usage

d_iframe_bridge(
  region_input = "region_csv",
  label_input = "label_csv",
  slow_poll_ms = 2000L,
  fast_poll_ms = 500L,
  allowed_origin = "same-origin",
  iframe_selector = "iframe"
)

Arguments

Value

A character string of JavaScript ready for tags$head(tags$script(HTML(d_iframe_bridge()))).

Examples

# In a Shiny UI:
if(interactive()){
library(shiny)
ui <- fluidPage(
  tags$head(tags$script(HTML(
    d_iframe_bridge(iframe_selector = "#my-helper-frame")
  ))),
  uiOutput("helper")  # render tags$iframe(id = "my-helper-frame", ...)
)
}

Description

Adds a small increment to the current offset of one region or label in a d_state(). This is the scripted equivalent of dragging slightly in the browser: existing movement is preserved and the delta is added on top. Unknown ids gain a new row, matching update_region_offset().

Usage

d_nudge(state, id, dx_m = 0, dy_m = 0, target = c("region", "label"))

Arguments

Value

An updated dragmapr_state with a bumped version.

Examples

state <- d_state(
  region_offsets = data.frame(region = "A", dx_m = 10, dy_m = 0)
)
state <- d_nudge(state, "A", dx_m = 5)
state$region_offsets

Description

Normalizes application vocabulary into a package-neutral edge table. The package understands levels and stable identifiers; terms such as county, parish, municipality, or district remain data values rather than hard-coded assumptions.

Usage

d_relationships(
  data = NULL,
  parent_level = NULL,
  parent_id = NULL,
  child_level = NULL,
  child_id = NULL
)

Arguments

Value

A dragmapr_relationships data frame with parent_level, parent_id, child_level, and child_id.

Description

These pure helpers make hierarchy state operational without imposing UI behavior. Paths are character vectors of branch IDs. Child states may be keyed by the full slash-separated path or, for backward compatibility, by the final path component.

Usage

d_set_active_path(hierarchy, path = character())

d_active_state(hierarchy, path = hierarchy$active_path, missing = NULL)

d_parent_state(hierarchy, path = hierarchy$active_path, missing = NULL)

d_branch_offsets(hierarchy, path = hierarchy$active_path)

d_effective_offsets(
  hierarchy,
  path = hierarchy$active_path,
  base_offsets = NULL
)

d_move_branch(hierarchy, path = hierarchy$active_path, dx_m = 0, dy_m = 0)

Arguments

Value

Updated hierarchy states, active/parent states, or composed offset tables as described by each function.

Description

Manage child states in a dragmapr hierarchy

Usage

d_set_child_state(hierarchy, key, state)

d_child_state(hierarchy, key, missing = NULL)

d_remove_child_state(hierarchy, key)

Arguments

Value

A hierarchy state for setters/removers, or a dragmapr_state for d_child_state().

Description

Rounds every region and label offset in a d_state() to the nearest multiple of grid, tidying hand-dragged layouts into even increments.

Usage

d_snap_offsets(state, grid = 1000)

Arguments

Value

An updated dragmapr_state with a bumped version.

Examples

state <- d_state(
  region_offsets = data.frame(region = "A", dx_m = 1234, dy_m = -567)
)
state <- d_snap_offsets(state, grid = 1000)
state$region_offsets

Description

A dragmapr_state stores the mutable, editorial layout of a draggable map separately from the source geometry and from display options. It is the shared composition contract handed between layout producers (such as explodemap::as_dragmapr_state()), the interactive editor, and static renderers.

Usage

d_state(
  level = "region",
  region_col = NULL,
  label_id_col = NULL,
  region_offsets = NULL,
  label_offsets = NULL,
  expanded_groups = character(),
  view = NULL,
  version = 0L,
  crs = NULL,
  geometry_id = NULL,
  selected_feature = NULL,
  styles = NULL,
  binding = NULL,
  schema_version = "1.2.0",
  package_version = as.character(utils::packageVersion("dragmapr"))
)

Arguments

Details

The state is deliberately geometry-free: it carries deltas, not absolute geometry, and is bound to features at apply time via a join key. That key is recorded in region_col, while level remains the human geography level label. For durable round-trips prefer a stable code (e.g. a FIPS/ISO id) over a display name, and record which geometry the state was composed against with geometry_id.

Value

An object of class "dragmapr_state".

Description

d_state_diff() reports composition and optional interaction changes between two states. d_state_equal() is the corresponding predicate.

Usage

d_state_diff(
  draft,
  canonical,
  tolerance = 1,
  compare = c("composition", "interaction", "all")
)

d_state_equal(
  a,
  b,
  tolerance = 1,
  compare = c("composition", "interaction", "all")
)

Arguments

Value

d_state_diff() returns a dragmapr_state_diff object. d_state_equal() returns TRUE or FALSE.

Description

Normalizes lightweight, already-classified visual overrides so interactive widgets, static renders, state JSON, and project bundles can preserve the same editorial styling. Data classification and palette selection remain application responsibilities.

Usage

d_styles(data = NULL, id_col = "region")

Arguments

Value

A dragmapr_styles data frame with columns region, fill, stroke, stroke_width, opacity, label_visible, and highlight.

Description

d_validate_state() checks a d_state() and returns TRUE when it is valid, throwing an informative error otherwise. It is the d_-prefixed predicate form of validate_dragmapr_state(), convenient for assertions and stopifnot().

Usage

d_validate_state(state)

Arguments

Value

TRUE for a valid state.

Examples

d_validate_state(d_state())

Description

Create a native dragmapr htmlwidget

Usage

d_widget(
  x,
  region_col,
  label_col = region_col,
  labels = TRUE,
  state = NULL,
  region_palette = NULL,
  geometry_options = d_geometry_options(),
  display_options = d_display_options(),
  interaction_options = d_interaction_options(),
  width = "100%",
  height = "650px",
  elementId = NULL
)

Arguments

Value

An htmlwidget.

Description

The native widget reports edits to Shiny through an input named paste0(outputId, "_state"). This function turns that value back into a d_state() so server code can persist, merge, or re-render the user's live composition. It is the inbound half of the widget bridge that d_widget() / updateDragmapr() form on the outbound side.

Usage

d_widget_state(value)

Arguments

Details

The browser's monotonic revision becomes the state version unchanged – the client owns the live counter, so the server records the edit faithfully rather than bumping it again. The empty-string selection sentinel is mapped back to NULL.

Value

A dragmapr_state, or NULL if value is NULL.

Examples

## Not run: 
shiny::observeEvent(input$map_state, {
  state <- d_widget_state(input$map_state)
  write_dragmapr_state(state, "composition.json")
})

## End(Not run)

Description

Finds candidate hierarchy pairs in a data frame or sf object. A pair is treated as parent-child when the child column has more groups than the parent column and most child values sit inside one parent group.

Usage

detect_hierarchy_columns(
  x,
  cols = NULL,
  max_child_groups = 600L,
  min_confidence = 0.72
)

Arguments

Value

A data frame with one row per detected pair.

Examples

df <- data.frame(
  county = c("A", "A", "B", "B"),
  town = c("A1", "A2", "B1", "B2")
)
detect_hierarchy_columns(df)

Description

Opens an interactive HTML page where you can drag map regions and labels into any layout you like. When you are happy with the result, click the copy or download buttons to save two small CSV files (one for regions, one for labels). Pass those CSVs to render_dragged_map() to reproduce the layout as a static image.

Usage

drag_map_prototype(
  x,
  region_col,
  label_col = region_col,
  labels = TRUE,
  draggable_labels = TRUE,
  label_marker = TRUE,
  label_marker_shape = c("rect", "circle", "none"),
  label_radius = 12,
  label_text_size = 11,
  label_width = 64,
  label_height = 30,
  label_box_width = 150,
  label_box_height = 72,
  connector_color = "#334155",
  connector_linewidth = 1.3,
  region_offsets = NULL,
  label_offsets = NULL,
  region_palette = NULL,
  show_legend = FALSE,
  max_legend_keys = 25L,
  legend_position = c("bottom", "top", "left", "right", "none"),
  legend_title = "Region",
  legend_values = NULL,
  label_values = NULL,
  legend_reflects_bloom = FALSE,
  map_background = c("white", "transparent", "light_grid", "dark"),
  connector_linetype = c("solid", "dashed", "dotted"),
  connector_endpoint = c("none", "arrow"),
  connector_smart = FALSE,
  show_origin_outlines = FALSE,
  show_movement_connectors = FALSE,
  show_movement_band = FALSE,
  movement_connector_color = "#64748b",
  movement_connector_opacity = 0.72,
  movement_connector_linewidth = 1.4,
  movement_connector_linetype = c("solid", "dashed", "dotted"),
  movement_connector_endpoint = c("closed", "open", "none"),
  show_drag_trail = FALSE,
  side_panel = TRUE,
  transition = NULL,
  file = NULL,
  open = FALSE
)

Arguments

Value

Invisibly returns file.

See Also

render_dragged_map() for the optional static ggplot2 render after dragging (its "Label style mappings" section translates interactive styling options to static arguments); make_region_labels() and as_drag_annotations() to build custom label tables; prepare_dragmapr_sf() to project uploaded geometry.

Examples

poly <- sf::st_sf(
  region = c("A", "B"),
  geometry = sf::st_sfc(
    sf::st_polygon(list(rbind(c(0,1e5),c(1e5,1e5),c(1e5,2e5),c(0,2e5),c(0,1e5)))),
    sf::st_polygon(list(rbind(c(0,0),c(1e5,0),c(1e5,1e5),c(0,1e5),c(0,0)))),
    crs = 3857
  )
)

# Primary usage: open the interactive draggable plot in the browser.
# Drag regions and labels, then copy or download the offset CSVs.
if(interactive()){
drag_map_prototype(poly, region_col = "region", open = interactive())
}

# Write to a specific path without opening (e.g. for Shiny or CI).
drag_map_prototype(poly, region_col = "region",
                  file = tempfile(fileext = ".html"))

Description

Shiny bindings for dragmapr widgets

Usage

dragmaprOutput(outputId, width = "100%", height = "650px")

renderDragmapr(expr, env = parent.frame(), quoted = FALSE)

Arguments

Value

Shiny output/render functions.

Description

This copies the HHS region membership, names, colors, and published display offsets used by the explodemap paper workflow into a lightweight fixture that does not depend on the explodemap package or its generated paper outputs. See the explodemap vignette "Reproducing the paper examples", section 6: https://CRAN.R-project.org/package=explodemap.

Usage

example_hhs_layout()

Value

A list with states, labels, region_offsets, label_offsets, region_names, and region_colors.

Examples

hhs <- example_hhs_layout()
names(hhs)

Description

This creates simple projected rectangles that behave like plot panels, dashboard tiles, or diagram cards. It is useful for checking that dragmapr's offset workflow is not tied to administrative map boundaries.

Usage

example_panel_layout()

Value

A list with panels, labels, region_offsets, label_offsets, region_names, and region_colors.

Examples

panels <- example_panel_layout()
names(panels)

Description

Inherit drag offsets between hierarchy levels

Usage

inherit_drag_offsets(state, from, to, relation)

Arguments

Value

A dragmapr_state at level to.

Description

When switching from a parent grouping (e.g., county) to a child grouping (e.g., municipality), inherit_layout() maps the parent's drag offsets to every child region that belongs to each parent. Each child inherits the mean offset of the parent group it belongs to.

Usage

inherit_layout(x, from, to, parent_offsets)

Arguments

Details

When child names repeat across parents (e.g., "Fairfield" exists in both Essex and Morris counties), pass both columns in to so that composite keys are used: to = c("county", "mun"). The resulting region values will be composite strings like "county=Essex | mun=Fairfield", which can be passed directly to drag_map_prototype() or render_dragged_map() via make_hierarchy_key().

Value

A data frame with region, dx_m, and dy_m columns. Rows whose parent has no offset entry receive zero movement.

See Also

make_hierarchy_key() for composite key construction, create_layout_snapshot() for capturing and restoring layouts.

Examples

poly <- sf::st_sf(
  county = c("Essex", "Essex", "Morris", "Morris"),
  mun    = c("Fairfield", "Caldwell", "Fairfield", "Roxbury"),
  geometry = sf::st_sfc(
    sf::st_polygon(list(rbind(c(0,1e5),c(1e5,1e5),c(1e5,2e5),c(0,2e5),c(0,1e5)))),
    sf::st_polygon(list(rbind(c(0,0),c(1e5,0),c(1e5,1e5),c(0,1e5),c(0,0)))),
    sf::st_polygon(list(rbind(c(1e5,1e5),c(2e5,1e5),c(2e5,2e5),c(1e5,2e5),c(1e5,1e5)))),
    sf::st_polygon(list(rbind(c(1e5,0),c(2e5,0),c(2e5,1e5),c(1e5,1e5),c(1e5,0)))),
    crs = 3857
  )
)
county_offsets <- data.frame(
  region = c("Essex", "Morris"),
  dx_m   = c(50000, -50000),
  dy_m   = c(0, 0)
)
# "Fairfield" repeats, so use composite to= key
mun_offsets <- inherit_layout(
  poly,
  from           = "county",
  to             = c("county", "mun"),
  parent_offsets = county_offsets
)
mun_offsets

Description

Builds renderer-neutral connector rows from label anchors and label offsets.

Usage

label_connectors(
  labels,
  state,
  threshold_m = 1,
  connector_type = NULL,
  include_unmoved = FALSE,
  as_sf = FALSE,
  crs = NA
)

Arguments

Value

A data frame or sf object.

Description

Compares region centroids before and after a transition and reports how far regions drifted. Use it to confirm that expanding one branch left the rest of the map stable: pass the non-expanded (sibling) regions as before and after. Lower drift means the user's mental map survived.

Usage

layout_metrics(before, after, id_col)

Arguments

Value

A named list with mean_drift and max_drift (map units), stability (0-100; 100 means no drift, 0 means mean drift of one third of the before bounding-box diagonal or more), and n_matched (regions compared). Regions missing from after are dropped with a warning.

See Also

build_elastic_transition().

Examples

rect <- function(x0, x1, y0, y1) {
  sf::st_polygon(list(cbind(c(x0, x1, x1, x0, x0), c(y0, y0, y1, y1, y0))))
}
before <- sf::st_sf(
  region = c("A", "B"),
  geometry = sf::st_sfc(rect(0, 1, 0, 1), rect(2, 3, 0, 1), crs = 3857)
)
after <- before
sf::st_geometry(after)[2] <- sf::st_geometry(after)[[2]] + c(0.5, 0)
layout_metrics(before, after, id_col = "region")

Description

Creates the dual-label table understood by the branch-bloom browser helper. Parent labels are safe for normal use. Child labels are optional and mainly useful for testing because many child labels can make branch animation feel busy or slow.

Usage

make_branch_bloom_labels(
  x,
  parent_key_col = "..dragmapr_parent_key..",
  child_key_col = "..dragmapr_child_key..",
  shell_col = "..dragmapr_parent_shell..",
  parent_label_col = parent_key_col,
  child_label_col = child_key_col,
  show_parent_labels = TRUE,
  show_child_labels = FALSE,
  max_label_chars = 36,
  connector = FALSE,
  label_type = "label"
)

Arguments

Value

A data frame suitable for the labels argument of drag_map_prototype(). Returns a zero-row label table when both label levels are disabled.

Description

Computes one padded rectangular boundary per group. The boundary is returned as real geometry with the group's id so it can be drawn inside the same container as the children and therefore moves with the group when dragged. In Spatial Studio this boundary is a drag handle, not a collapse control.

Usage

make_group_boundaries(sf_obj, group_col, padding = NULL)

Arguments

Value

An sf object with one row per group and columns group_id, xmin, xmax, ymin, ymax (padded bounds), plus the rectangle geometry.

See Also

build_elastic_transition(), which calls this automatically when group_drag_frame = TRUE.

Examples

rect <- function(x0, x1, y0, y1) {
  sf::st_polygon(list(cbind(c(x0, x1, x1, x0, x0), c(y0, y0, y1, y1, y0))))
}
children <- sf::st_sf(
  county = c("A", "A", "B"),
  geometry = sf::st_sfc(
    rect(0, 1, 0, 1), rect(2, 3, 0, 1), rect(5, 6, 0, 1),
    crs = 3857
  )
)
make_group_boundaries(children, group_col = "county")

Description

Creates a character vector of composite group identifiers by combining values from two or more columns of a data frame or sf object. The result is suitable as the region column of an offset data frame, and is the key building block for parent-to-child layout inheritance in hierarchical spatial datasets where child names repeat across parents.

Usage

make_hierarchy_key(x, cols)

Arguments

Details

When length(cols) == 1, the values of that column are returned directly (after whitespace trimming and NA replacement). When length(cols) > 1, values are joined as "col1=val1 | col2=val2 | ...".

Value

A character vector of length nrow(x).

See Also

inherit_layout() to propagate parent offsets to child groups, create_layout_snapshot() to capture a layout for later restoration.

Examples

df <- data.frame(
  county = c("Essex", "Essex", "Morris"),
  mun    = c("Fairfield", "Caldwell", "Fairfield")
)
# Single column: values returned as-is
make_hierarchy_key(df, "county")

# Two columns: composite key disambiguates repeated child names
make_hierarchy_key(df, c("county", "mun"))

Description

make_labels() is deprecated. Use make_region_labels() instead.

Usage

make_labels(
  x,
  region_col,
  label_col = region_col,
  point = c("point_on_surface", "centroid")
)

Arguments

Value

A drag label table.

Description

Derive one default label per draggable region

Missing or empty region_col values are dropped before anchors are derived; an error is raised when no valid region values remain.

Usage

make_region_labels(
  x,
  region_col,
  label_col = region_col,
  point = c("point_on_surface", "centroid")
)

Arguments

Value

A drag label table with label_id, region, label, x, and y.

See Also

as_drag_labels() for user-supplied labels; as_drag_annotations() for draggable info boxes; apply_label_state() to restore saved positions; drag_map_prototype() which accepts the result as its labels argument.

Examples

poly <- sf::st_sf(
  region = c("North", "South"),
  geometry = sf::st_sfc(
    sf::st_polygon(list(rbind(c(0,1e5),c(1e5,1e5),c(1e5,2e5),c(0,2e5),c(0,1e5)))),
    sf::st_polygon(list(rbind(c(0,0),c(1e5,0),c(1e5,1e5),c(0,1e5),c(0,0)))),
    crs = 3857
  )
)
make_region_labels(poly, region_col = "region")

Description

Merge dragmapr state updates

Usage

merge_dragmapr_state(state, update)

Arguments

Value

A merged dragmapr_state. Its version is one greater than the higher of the two input revisions, so the merged state always sorts after both of its inputs.

Description

Merge keyed feature styles

Usage

merge_dragmapr_styles(base, update)

Arguments

Value

A dragmapr_styles table.

Description

Repairs invalid geometry, filters to polygon types, assigns a fallback CRS when none is present, and reprojects geographic (longitude/latitude) data to a projected CRS so metre offsets work correctly. CRS-less inputs trigger a warning because the fallback is an assumption; pass target_crs explicitly when your data uses a different projected CRS.

Usage

prepare_dragmapr_sf(x, target_crs = 3857)

Arguments

Value

A projected sf object containing only polygon or multipolygon features with valid geometry.

See Also

read_dragmapr_sf_upload() and read_dragmapr_sf_url() to read spatial files before passing them to this function; drag_map_prototype() which requires a projected sf object.

Examples

poly <- sf::st_sf(
  region = "A",
  geometry = sf::st_sfc(
    sf::st_polygon(list(rbind(c(-1,0),c(1,0),c(1,1),c(-1,1),c(-1,0)))),
    crs = 4326
  )
)
out <- prepare_dragmapr_sf(poly)
sf::st_is_longlat(out)  # FALSE

Description

Combines CRS information, geometry counts, candidate hierarchies, and a recommended parent-child bloom setup.

Usage

profile_spatial_upload(x, parent_col = NULL)

Arguments

Value

A list with crs, geometry_type, n_features, hierarchy, and animation.

Description

Reads a Spatial Studio project ZIP or extracted project directory and returns its components as a named list. This is the low-level companion to render_dragmapr_project(): use it when you want to access the raw source geometry, offsets, labels, or palette programmatically before rendering.

Usage

read_dragmapr_project(project)

Arguments

Value

A named list with elements:

source

The source sf object read from source.gpkg.

region_offsets

Data frame from drag_region_offsets.csv, or NULL if not present.

label_offsets

Data frame from drag_label_offsets.csv, or NULL if not present.

labels

Label table from labels.csv (as returned by as_drag_labels()), or NULL.

region_palette

Named character vector of colors from palette.csv, or NULL.

metadata

Named list parsed from metadata.json.

path

Path to the extracted project directory.

See Also

render_dragmapr_project() to render a project bundle directly; write_dragmapr_project() to create a project bundle from R objects.

Examples

if(interactive()){
bundle <- read_dragmapr_project("dragmapr-project.zip")
names(bundle)
nrow(bundle$source)
}

Description

Handles the data frame returned by shiny::fileInput(), including multi-file uploads of shapefile sidecars (.shp, .dbf, .shx, .prj) and zipped archives containing any supported format. When upload is NULL or empty the function returns NULL so callers can fall back to demo data.

Usage

read_dragmapr_sf_upload(upload)

Arguments

Value

An sf object, or NULL if upload is NULL or empty.

Examples

# Typical Shiny server usage:
if(interactive()){
observeEvent(input$spatial_upload, {
  x <- read_dragmapr_sf_upload(input$spatial_upload)
  if (!is.null(x)) {
    state$source <- x
  }
})
}

Description

Downloads a spatial file from url into a temporary directory and reads it with sf::st_read(). Supported direct formats are .geojson, .json, and .gpkg. A .zip URL is extracted first and the first supported file inside is read. For ambiguous extensions the function assumes a zip archive.

Usage

read_dragmapr_sf_url(url, timeout = 60)

Arguments

Value

An sf object.

Examples

if(interactive()){
x <- read_dragmapr_sf_url("https://example.com/regions.geojson")
}

Description

read_label_offsets() is deprecated. Use read_label_state() instead.

Usage

read_label_offsets(path)

Arguments

Value

A normalized label state data frame.

Description

Read draggable label state from CSV

Usage

read_label_state(path)

Arguments

Value

A normalized label state data frame.

Examples

path <- tempfile(fileext = ".csv")
writeLines(c("label_id,region,dx_m,dy_m", "North,North,500,200"), path)
read_label_state(path)

Description

Read region offsets from CSV

Usage

read_offsets(path)

Arguments

Value

A data frame with normalized region, dx_m, and dy_m columns.

Examples

path <- tempfile(fileext = ".csv")
writeLines(c("region,dx_m,dy_m", "North,1000,-500", "South,0,0"), path)
read_offsets(path)

Description

Picks a parent column and, when available, a child column suitable for bloom/leaf-flip animation.

Usage

recommend_dragmapr_hierarchy(x, parent_col = NULL, max_child_groups = 600L)

Arguments

Value

A list with parent, child, confidence, reason, and pairs.

Description

Builds renderer-neutral movement connector rows from source geometry and a dragmapr_state. Each row describes the line from a region's original anchor to its state-adjusted anchor.

Usage

region_connectors(
  x,
  state,
  region_col = NULL,
  threshold_m = 1,
  include_unmoved = FALSE,
  as_sf = FALSE
)

Arguments

Value

A data frame or sf object.

Description

Remove or keep spatial features

Usage

remove_spatial_features(
  x,
  ids,
  key_col = NULL,
  invert = FALSE,
  prune_empty = TRUE
)

delete_spatial_features(
  x,
  ids,
  key_col = NULL,
  invert = FALSE,
  prune_empty = TRUE
)

keep_spatial_features(x, ids, key_col = NULL, prune_empty = TRUE)

Arguments

Value

An sf object with the same CRS and geometry column as x.

Description

Takes the offset CSVs you downloaded from drag_map_prototype() and produces a ggplot2 image with regions and labels in the positions you dragged them to. If you used Spatial Studio, use render_dragmapr_project() instead - it reads everything from the project ZIP in one call.

Usage

render_dragged_map(
  x,
  region_offsets = NULL,
  region_col,
  label_col = region_col,
  label_offsets = NULL,
  state = NULL,
  styles = NULL,
  labels = NULL,
  label_values = NULL,
  max_labels = Inf,
  label_prefer = NULL,
  region_palette = NULL,
  region_labels = NULL,
  show_legend = TRUE,
  max_legend_keys = 25L,
  legend_position = c("bottom", "top", "left", "right", "none"),
  legend_title = "Region",
  legend_values = NULL,
  title = NULL,
  label_size = 3.4,
  show_label_marker = TRUE,
  label_marker_shape = c("circle", "rect", "none"),
  marker_size = 3.2,
  marker_fill = "white",
  marker_color = "black",
  marker_stroke = 0.8,
  box_label_size = 3,
  box_fill = "white",
  box_color = "black",
  box_wrap = 24,
  connector_color = "#334155",
  connector_linewidth = 0.35,
  connector_linetype = "solid",
  connector_endpoint = c("none", "arrow"),
  connector_curvature = 0.18,
  connector_squiggle_amplitude = 12000,
  connector_squiggle_waves = 4,
  connector_end_gap = NULL,
  show_origin_outlines = FALSE,
  show_movement_connectors = FALSE,
  show_movement_band = FALSE,
  movement_connector_color = "#64748b",
  movement_connector_opacity = 0.72,
  movement_connector_linewidth = 0.45,
  movement_connector_linetype = c("solid", "dashed", "dotted"),
  movement_connector_endpoint = c("closed", "open", "none"),
  label_padding = 0.08,
  map_background = c("white", "transparent", "light_grid", "dark"),
  file = NULL,
  width = 8,
  height = 6,
  dpi = 300
)

Arguments

Details

Label style mappings

The interactive drag_map_prototype() helper and this static renderer expose the same label styling concepts under slightly different argument names and units. Use this mapping to carry a styled interactive layout into a matching static export:

Value

A ggplot object.

See Also

drag_map_prototype() for the interactive draggable browser helper that produces the offset CSVs; read_offsets() and read_label_state() to load saved offsets from disk; as_drag_annotations() for info-box labels.

Examples

# render_dragged_map() is an optional static-export step.
# The primary workflow is drag_map_prototype(open = interactive()): open the
# interactive HTML, drag regions and labels to your liking, then
# copy or download the offset CSVs.  Only call render_dragged_map()
# if you also need a reproducible ggplot2 image from those offsets.
if(interactive()){
# Step 1 (always): open the interactive draggable plot.
drag_map_prototype(poly, region_col = "region", open = interactive())

# Step 2 (optional): after dragging, reconstruct as a static image.
region_offsets <- read_offsets("my_region_offsets.csv")
render_dragged_map(poly, region_col = "region",
                  region_offsets = region_offsets)
}

# Minimal runnable example (no prior dragging session needed).
poly <- sf::st_sf(
  region = c("A", "B"),
  geometry = sf::st_sfc(
    sf::st_polygon(list(rbind(c(0,1e5),c(1e5,1e5),c(1e5,2e5),c(0,2e5),c(0,1e5)))),
    sf::st_polygon(list(rbind(c(0,0),c(1e5,0),c(1e5,1e5),c(0,1e5),c(0,0)))),
    crs = 3857
  )
)
render_dragged_map(poly, region_col = "region")

Description

render_dragmapr_project() turns a Spatial Studio project ZIP, or an extracted project directory, into the same ggplot2 image produced by render_dragged_map(). It reads the saved source geometry, region offsets, label offsets, label table, palette, and metadata, then validates that the pieces still match before rendering.

Usage

render_dragmapr_project(
  project,
  file = NULL,
  width = 10,
  height = 8,
  dpi = 300,
  title = NULL,
  quiet = FALSE,
  ...
)

Arguments

Value

A ggplot object.

Examples

if(interactive()){
render_dragmapr_project("dragmapr-project.zip", file = "map.png")
}

Description

Reset offsets in a dragmapr state

Usage

reset_region(state, region)

reset_regions(state, region)

reset_label(state, label_id)

reset_labels(state)

reset_all(state)

Arguments

Value

An updated dragmapr_state with a bumped version.

Description

Extracts the offset data frame from a snapshot created by create_layout_snapshot().

Usage

restore_layout_snapshot(snapshot)

Arguments

Value

A data frame with region, dx_m, and dy_m columns, or NULL if the snapshot was created with offsets = NULL.

See Also

create_layout_snapshot().

Examples

offsets <- data.frame(region = c("A", "B"), dx_m = c(10000, -10000), dy_m = 0)
snap <- create_layout_snapshot(
  data.frame(county = c("A", "B")),
  group   = "county",
  offsets = offsets
)
restore_layout_snapshot(snap)

Description

This helper is useful for interfaces that should keep all label state, but show only a manageable subset by default. It returns label IDs only; callers can pass the result to label_values in drag_map_prototype() or render_dragged_map().

Usage

select_label_ids(labels, max_labels = 25, label_prefer = NULL, prefer = NULL)

Arguments

Value

A character vector of label IDs.

Examples

labels <- as_drag_labels(data.frame(
  label_id = c("A", "B", "C"), region = c("A", "B", "C"),
  label = c("A", "B", "C"), x = 1:3, y = 1:3
))
select_label_ids(labels, max_labels = 2)

Description

Snapshot or restore hierarchy state

Usage

snapshot_dragmapr_hierarchy_state(hierarchy)

restore_dragmapr_hierarchy_state(snapshot)

Arguments

Value

A plain list or restored hierarchy state.

Description

Snapshot or restore dragmapr state

Usage

snapshot_dragmapr_state(state)

migrate_dragmapr_state(snapshot, target_schema_version = "1.2.0")

restore_dragmapr_state(snapshot)

Arguments

Value

snapshot_dragmapr_state() returns a plain list. restore_dragmapr_state() returns a dragmapr_state. migrate_dragmapr_state() returns a migrated plain list.

Description

Builds a plain data frame for Shiny tables, review screens, and scripted edit workflows. Geometry is summarized instead of expanded so users can decide which features to remove without accidentally dropping the active geometry column.

Usage

spatial_feature_table(x, key_col = NULL, include_geometry = FALSE)

view_spatial_features(x, key_col = NULL, include_geometry = FALSE)

Arguments

Value

A data frame with .feature_id, .row, .geometry_type, bbox columns, and the non-geometry attributes from x.

Description

Computes a starting layout for drag_map_prototype() or render_dragged_map() without manual dragging. The result is a data frame of offsets that can be refined interactively in the browser.

Usage

suggest_offsets(
  x,
  region_col,
  method = c("radial", "horizontal", "vertical", "grid", "none"),
  scale = 1
)

Arguments

Details

Available layout methods:

"radial"

Each region is pushed outward from the collective centroid in the direction of its own centroid. Regions that are already spread out are pushed further than regions near the centre.

"horizontal"

Regions are ranked by centroid x-coordinate and spread evenly along the x-axis. Useful for left-to-right layouts.

"vertical"

Regions are ranked by centroid y-coordinate and spread evenly along the y-axis.

"grid"

Regions are arranged in a rectangular grid ordered by centroid position (top-to-bottom, left-to-right).

"none"

Returns zero offsets for every region. Useful as a placeholder when you want to start from an undisplaced state.

The scale argument multiplies all computed offsets uniformly. Increase it to spread regions further apart; decrease it for a tighter layout.

Value

A data frame with region, dx_m, and dy_m columns, one row per unique region value. Suitable for use as region_offsets in drag_map_prototype() or render_dragged_map().

See Also

drag_map_prototype() to open the interactive helper with the suggested layout as a starting point; apply_offsets() to apply offsets directly to an sf object.

Examples

poly <- sf::st_sf(
  region = c("A", "B", "C", "D"),
  geometry = sf::st_sfc(
    sf::st_polygon(list(rbind(c(0,1e5),c(1e5,1e5),c(1e5,2e5),c(0,2e5),c(0,1e5)))),
    sf::st_polygon(list(rbind(c(0,0),c(1e5,0),c(1e5,1e5),c(0,1e5),c(0,0)))),
    sf::st_polygon(list(rbind(c(1e5,1e5),c(2e5,1e5),c(2e5,2e5),c(1e5,2e5),c(1e5,1e5)))),
    sf::st_polygon(list(rbind(c(1e5,0),c(2e5,0),c(2e5,1e5),c(1e5,1e5),c(1e5,0)))),
    crs = 3857
  )
)
suggest_offsets(poly, region_col = "region", method = "radial")
suggest_offsets(poly, region_col = "region", method = "horizontal")
suggest_offsets(poly, region_col = "region", method = "grid")

Description

Returns plain-language CRS metadata and what the units mean for drag offsets.

Usage

summarise_spatial_crs(x)

Arguments

Value

A list with CRS id, name, type, units, bounds, and message.

Description

Summarise a dragmapr state

Usage

## S3 method for class 'dragmapr_state'
summary(object, ...)

Arguments

Value

A summary.dragmapr_state object.

Description

Builds a validated list of animation and behaviour settings for build_elastic_transition(). Defaults follow the user-tested values from the dragmapr transition prototype: a 400 ms branch bloom, a dotted group-drag boundary around the expanded group, and a stable parent skeleton.

Usage

transition_options(
  mode = c("local_elastic", "local_insert"),
  duration_ms = 400,
  overshoot = 0,
  max_stretch = 0.35,
  n_frames = 30,
  preserve_skeleton = TRUE,
  global_relayout = FALSE,
  show_ghost = TRUE,
  show_trails = FALSE,
  reset_boundary = NULL,
  group_drag_frame = TRUE,
  boundary_behavior = c("drag", "none"),
  boundary_drag_threshold = 8,
  boundary_label = "Drag to",
  boundary_padding = 0.025,
  drag_boundary_with_group = TRUE
)

Arguments

Details

The transition model is always stable skeleton + local branch bloom: the parent layout is preserved and children expand locally from the parent centroid. global_relayout exists only as an explicit guard rail; setting it to TRUE is an error because recomputing the whole layout on every expansion destroys the user's mental map.

Value

A named list of class "dragmapr_transition_options".

See Also

build_elastic_transition(), make_group_boundaries().

Examples

transition_options()
transition_options(duration_ms = 800, overshoot = 0)
try(transition_options(global_relayout = TRUE))

Description

Safely update label offsets in a dragmapr state

Usage

update_label_offset(
  state,
  label_id,
  dx_m = NULL,
  dy_m = NULL,
  mode = c("replace", "increment"),
  region = NULL
)

Arguments

Value

An updated dragmapr_state with a bumped version.

Description

Safely update region offsets in a dragmapr state

Usage

update_region_offset(
  state,
  region,
  dx_m = NULL,
  dy_m = NULL,
  mode = c("replace", "increment")
)

Arguments

Value

An updated dragmapr_state with a bumped version.

Description

Update a dragmapr widget in place

Usage

updateDragmapr(session, outputId, ..., generation = NULL, revision = NULL)

Arguments

Value

Invisibly returns the sent message.

Description

Checks whether child_col can subdivide parent_col for leaf-flip bloom.