simulate_edge_list: Simulate a tidy network edge list

In simulab: Simulates a Wide Variety of Data Shapes, Sizes and Distributions

Simulate a tidy network edge list

Description

Simulate a tidy network edge list

Usage

simulate_edge_list(
  nodes,
  edges = NULL,
  probability = 0.1,
  directed = TRUE,
  loops = FALSE,
  weight = c("binary", "uniform", "normal", "poisson"),
  weight_mean = 1,
  weight_sd = 1,
  weight_range = c(0.1, 1),
  node_type = NULL,
  edge_classes = NULL,
  class_probabilities = NULL,
  seed = NULL,
  batch = NULL
)

Arguments

nodes	Number of nodes or unique node labels.
edges	Optional exact number of edges.
probability	Edge probability when edges is NULL.
directed	Generate directed edges.
loops	Permit self-loops.
weight	Edge-weight distribution.
weight_mean, weight_sd, weight_range	Weight parameters.
node_type	Optional node type for each node.
edge_classes	Optional number or labels of edge classes.
class_probabilities	Optional edge-class probabilities.
seed	Optional seed.
batch	Optional single positive whole number. When given, the simulator runs batch times and returns a plain list of batch results, each exactly what the same call without batch returns. With a seed, every dataset gets its own seed drawn from seed, so the whole batch is reproducible; without one the datasets are consecutive draws from the session's random-number stream. The default NULL returns a single result.

Value

A tidy simulab_sim base data.frame with one row per edge and columns from, to, and weight (plus edge_class when edge_classes is supplied). as.data.frame(x, what = ) also returns nodes (node, type), adjacency (a long row/column/weight table over all ordered node pairs), and a one-row settings table.

Examples

result <- simulate_edge_list(nodes = 40, probability = 0.08, seed = 1)
head(result)
components(result)

simulab documentation built on Oct. 15, 2026, 5:08 p.m.