to_cograph: Prepare network for cograph::splot()

In bibnets: Importing, Constructing, and Exporting Bibliometric Networks

Prepare network for cograph::splot()

Description

Converts a bibnets edge list to a cograph_network object by calling cograph::as_cograph(). Optionally merges node metadata (e.g., from local_citations()) into the network's node table so attributes like lcs or year can be used directly in splot() aesthetic parameters (e.g., node_size = "lcs").

Usage

to_cograph(edges, nodes = NULL, directed = FALSE)

Arguments

edges	A data frame with at least from, to, weight columns.
nodes	Optional data frame of node attributes with an id column (e.g., output of local_citations()). All columns are merged into the cograph_network$nodes table and become available as aesthetic mappings.
directed	Logical. Default FALSE.

Details

Note: bibnets edge lists (from, to, weight) are accepted directly by cograph::splot() without conversion. This function is only needed when you want to attach node-level metadata.

Value

A cograph_network object (S3 list with ⁠$nodes⁠ and ⁠$edges⁠).

Examples

data(biblio_data)

# Without metadata: splot() accepts bibnets edges directly
edges <- author_network(biblio_data, "collaboration")

# With metadata: document network + local citation scores as node size
edges <- document_network(biblio_data, type = "coupling")
nodes <- local_citations(biblio_data)   # keyed by document id
net   <- to_cograph(edges, nodes = nodes)

bibnets documentation built on June 19, 2026, 1:06 a.m.