Skip to contents

Creates a static cograph network from the exact observed, endpoint-valid activity in a requested time range. Every collapsed edge retains all common duration summaries, so choosing one weighting does not discard the others.

Usage

collapse_network(
  dn,
  start = NULL,
  end = NULL,
  weight = c("binary", "union_duration", "total_duration", "duration_fraction",
    "spell_count", "weight_sum", "weighted_duration", "latest_weight"),
  sessions = c("bounded", "collapse", "separate"),
  censored = c("include", "exclude")
)

Arguments

dn

A temporal network from dynet() or as_dynet().

start, end

Collapse bounds. Default to the observed range. Positive intervals are clipped to [start, end]; genuine points at either bound are retained. An end before start raises a dynet_bad_input error.

weight

Edge field used as the cograph weight: "binary" (the default), "union_duration", "total_duration", "duration_fraction", "spell_count", "weight_sum", "weighted_duration", or "latest_weight". Every field is present in the edge table whichever one is chosen; this names only the one cograph draws with.

sessions

Session handling. "bounded", the default, respects session-specific endpoint activity before pooling, "collapse" erases session labels, and "separate" returns one collapsed cograph network per session.

censored

Whether raw edge and vertex identities carrying an explicit censor flag are "include"d, the default, or "exclude"d. Exclusion drops the whole raw identity, never one observed fragment alone.

Value

A dynet_collapsed cograph netobject, whose two tidy tables are reached with as.data.frame(x, what = "edges") and as.data.frame(x, what = "nodes"). With sessions = "separate", a named dynet_collapsed_list of such objects, one per session.

The edge table carries one row per collapsed pair and every weighting at once, so choosing one does not discard the others: from, to, binary (1 for a pair that was ever active), union_duration (time the pair was active, overlaps counted once), total_duration (summed spell lengths, overlaps counted twice), duration_fraction (union_duration over the pair's joint activity opportunity, NA when that opportunity is zero), spell_count (raw spells touching the range), weight_sum (the full weight of every such spell, summed, however little of the spell falls inside the range, as networkDynamic::network.collapse() keeps an attribute whole), weighted_duration (each spell's weight times the part of its duration inside the range, summed; this is the only field that shares a weight out by time), latest_weight (the weight of the last spell to end), first and last (the pair's earliest onset and latest terminus inside the range), and two columns named as networkDynamic::network.collapse(rm.time.info = FALSE) names them: activity.duration, equal to union_duration, and activity.count, the number of activity runs after merging spells that overlap or abut and absorbing a point that falls inside a spell. activity.count therefore equals spell_count only when no two spells of the pair touch.

A spell that only touches a bound, to within the package's time tolerance, contributes nothing: it leaves no edge of zero width behind.

The node table carries one row per vertex, with name, any static vertex attributes the network was built with, activity_duration (time the vertex was active, overlaps counted once) and its activity.duration alias.

Examples

dn <- dynet(data.frame(
  from = c("A", "A"), to = c("B", "B"),
  start = c(0, 1), end = c(2, 3)
))
flat <- collapse_network(dn, weight = "union_duration")
as.data.frame(flat)
#>   from to binary union_duration total_duration duration_fraction spell_count
#> 1    A  B      1              3              4                 1           2
#>   weight_sum weighted_duration latest_weight first last activity.duration
#> 1          2                 4             1     0    3                 3
#>   activity.count
#> 1              1