Update declared vertex-activity components
Arguments
- dn
A temporal network.
- spells
Integer positions or a logical mask over canonical vertex activity, as returned by
as.data.frame(dn, what = "vertex_spells").- data
A data frame with one row, or one row per selected component, containing the fields to replace:
node,start,end,session,onset_censoredorterminus_censored. Any other column name raisesdynet_unknown_column, so a misspelled field is refused rather than quietly doing nothing.
Value
A new dynet object, class
c("dynet", "netobject", "cograph_network"). Updated components are
canonicalised with the retained components, so overlaps can merge and
spell identifiers can change. start and end may be given on the
network's own clock, Date or POSIXct for a calendar network. Raises
dynet_vertex_spell_not_found when spells selects no component, and
dynet_bad_input when spells is not a valid selection, when data is
malformed or of the wrong height, or when it names the read-only derived
columns vertex_spell, duration or instant.
Examples
dn <- dynet(school_contacts)
present <- data.frame(node = c("Ana", "Ben"), start = 0, end = 10)
enrolled <- set_vertex_spells(dn, present)
extended <- update_vertex_spells(enrolled, spells = 1,
data = data.frame(end = 12))
as.data.frame(extended, what = "vertex_spells")
#> vertex_spell node start end duration instant session onset_censored
#> 1 1 Ana 0 12 12 FALSE <NA> FALSE
#> 2 2 Ben 0 10 10 FALSE <NA> FALSE
#> terminus_censored
#> 1 FALSE
#> 2 FALSE