districts: Get districts (c-components) of an ADMG or AG

In caugi: Causal Graph Interface

Get districts (c-components) of an ADMG or AG

Description

Get districts (c-components) for all nodes, or for selected nodes in an ADMG/AG. A district is a maximal set of nodes connected via bidirected edges. If both nodes and index are NULL, returns all districts in the graph.

Usage

districts(cg, nodes = NULL, index = NULL, all = NULL)

Arguments

cg	A caugi object of class ADMG or AG.
nodes	Optional character vector of node names. If supplied, returns district(s) containing these nodes.
index	Optional numeric vector of 1-based node indices. If supplied, returns district(s) containing these indices.
all	DEPRECATED (If TRUE, return all districts explicitly. Cannot be combined with nodes or index.)

Value

If all districts are requested: a list of character vectors, one per district. If nodes/index are supplied: either a character vector (single target) or a named list of character vectors (multiple targets).

See Also

Other queries: ancestors(), anteriors(), children(), components(), descendants(), edge_types(), edges(), exogenous(), is_acyclic(), is_admg(), is_ag(), is_caugi(), is_cpdag(), is_dag(), is_empty_caugi(), is_mag(), is_mpdag(), is_pdag(), is_simple(), is_ug(), m_separated(), markov_blanket(), neighbors(), nodes(), parents(), posteriors(), same_nodes(), spouses(), subgraph(), topological_sort()

Examples

cg <- caugi(
  A %-->% B,
  A %<->% C,
  D %<->% E,
  class = "ADMG"
)
districts(cg)
# Returns list with districts: {A, C}, {B}, {D, E}
districts(cg, nodes = "A") # Returns c("A", "C")
districts(cg, index = c(1, 4))

caugi documentation built on Oct. 28, 2026, 1:07 a.m.