walk_compute_access: Compute Cumulative Walkable Accessibility to Points of...

View source: R/access.R

walk_compute_accessR Documentation

Compute Cumulative Walkable Accessibility to Points of Interest (POIs)

Description

Computes cumulative pedestrian accessibility from each network junction to urban facilities (e.g. schools, health centers, pharmacies, public transit stops) within a walking time budget (default 10 minutes at 4.5 km/h). Uses parallel compiled Rust to evaluate hundreds of thousands of shortest paths across CPU cores.

Usage

walk_compute_access(
  network,
  pois,
  time_min = 10,
  category_col = NULL,
  weight_col = NULL,
  target = c("largest_component", "all"),
  n_threads = 2L,
  verbose = TRUE
)

Arguments

network

A walk_network object produced by walk_build_network().

pois

An sf points collection containing destination facilities/POIs.

time_min

Walking time threshold in minutes (default 10.0 minutes).

category_col

Optional column name in pois indicating facility category (e.g. "amenity", "category", or "type"). If provided, calculates separate accessibility counts for each unique category.

weight_col

Optional column name in pois indicating facility weight/capacity. Default is NULL (each POI counts as 1.0).

target

Character string: "largest_component" (default) to evaluate nodes in the primary connected component, or "all".

n_threads

Number of CPU threads to use in parallel, from 1 to 2. The default is 2, the maximum permitted during CRAN checks.

verbose

Logical. If TRUE, prints execution progress and summary.

Value

A walk_access S3 object containing:

nodes

sf points table augmented with columns for cumulative counts and minimum walking times.

summary

Summary statistics table per category.

time_min

The evaluated walking budget in minutes.

pois

The original POI points mapped to network nodes.

network

The input walk_network.

Examples

data(streets_cusco)
net <- walk_build_network(streets_cusco, verbose = FALSE)
sample_pois <- net$nodes[net$nodes$is_giant, ][seq(1, 100, by = 20), ]
acc <- walk_compute_access(net, pois = sample_pois, time_min = 5, verbose = FALSE)
print(acc)

walkability documentation built on Nov. 17, 2026, 5:09 p.m.