resolve_canonicals: Resolve edge endpoints through rel=canonical declarations

In pagerankr: Modular Toolkit for PageRank Calculation

Resolve edge endpoints through rel=canonical declarations

Description

Applies declared 'rel=canonical' folds to the source and target columns of an edge list. This is URL **folding** from canonical-link signals, not URL syntax canonicalization such as lower-casing hosts or removing tracking parameters.

Usage

resolve_canonicals(
  edge_list_df,
  canonicals_df,
  edge_from_col = "from",
  edge_to_col = "to",
  canonical_from_col = "from",
  canonical_to_col = "to",
  canonical_duplicate_from_policy = c("strict", "first_wins", "last_wins",
    "most_frequent", "prune_source", "resolve_if_consistent"),
  canonical_loop_handling = c("error", "prune_loop", "break_arrow")
)

Arguments

edge_list_df	A data frame representing the edge list.
canonicals_df	A data frame of declared canonical links.
edge_from_col, edge_to_col	Source/target columns in 'edge_list_df'.
canonical_from_col, canonical_to_col	From/to columns in 'canonicals_df'.
canonical_duplicate_from_policy	How to handle a canonical source with multiple distinct targets. See [build_fold_map()].
canonical_loop_handling	How to handle canonical cycles. See [build_fold_map()].

Value

The edge list with 'edge_from_col' and 'edge_to_col' folded through canonical declarations. The applied fold map is attached as attribute '"fold_map"'.

See Also

Other edge-list resolvers: resolve_links(), resolve_redirects()

Examples

edges <- data.frame(from = "A", to = "B")
canonicals <- data.frame(from = "B", to = "C")
resolve_canonicals(edges, canonicals)

pagerankr documentation built on Oct. 1, 2026, 5:09 p.m.