build_cna() estimates an undirected co-occurrence network (CNA): for
every pair of positions in a sequence where both are observed, the two
states count as co-occurring once, in either order. It is
build_network() with method = "co_occurrence", and takes sequences in
a wide table, an event log, one-hot codes (declared with codes or
format = "onehot", and counted in windows as wtna() does) or a square
matrix of counts.
An edge counts how often two states occur together within sequences
(over pairs of positions, so a sequence can add to one edge several
times), not which came first; for order, use build_tna(). Check how
far the counts move under resampling with bootstrap_network().
Usage
build_cna(
data,
start = FALSE,
end = FALSE,
actor = NULL,
action = NULL,
time = NULL,
session = NULL,
...
)Arguments
- data
The sequences: a data frame with one row per sequence and one column per position, an event log (one row per event, with
actionset), one-hot code columns, or a square matrix of co-occurrence counts (non-negative whole numbers). Column roles are declared as inbuild_network().- start
A start state put before every sequence, so the network shows where sequences begin.
FALSE(default) adds none,TRUEadds one labelled"Start", a single string adds one with that label.- end
An end state put after each sequence's last observed state, so the network shows where sequences stop; it has no outgoing edges.
FALSE(default),TRUE("End") or a single string, asstart.- actor
The column naming who each row belongs to (a person, a team). In an event log, each actor's events form a sequence, split further by
sessionortime_threshold. DefaultNULL.- action
The column holding each event's state; setting it declares the data an event log. Column names give no role:
action,actor,timeandsessionare read only when set. A column calledActionwith nothing declared raises an error of classnestimate_bad_input, and an undeclared time or session column besideactionis named in a message of classnestimate_column_role. DefaultNULL.- time
The timestamp column of an event log. Events are ordered by it, and a gap longer than
time_thresholdstarts a new sequence. DefaultNULL.- session
The column identifying sessions in an event log; each session is its own sequence, also without
actor. DefaultNULL.- ...
Further arguments for
build_network(), such asgroup,params,scaling,thresholdorstate_cols.methodcannot be given: it is always"co_occurrence"(error of classnestimate_bad_input).
Value
A netobject (a netobject_group with group), exactly as
build_network() returns it: print it for an overview, read the edges
with extract_edges() and the weights with
extract_transition_matrix(), and draw it with cograph::splot().
See also
build_network, cooccurrence for
delimited-field, bipartite, and other non-sequence co-occurrence formats.