build_ftna() estimates a frequency transition network (FTNA): how many
times each state is followed by each state, itself included, as raw
counts. It is
build_network() with method = "frequency", and takes the same input
as build_tna(); a matrix must hold non-negative whole counts.
Counts grow with the number and length of sequences, so they compare
within one network; for transition probabilities use build_tna(). Check
how far the counts move under resampling with bootstrap_network().
Usage
build_ftna(
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 transition 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"frequency"(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().
Examples
net <- build_ftna(trajectories)
net
#> Transition Network (frequency counts) [directed]
#> Weights: [23.000, 459.000] | mean: 192.667
#>
#> Weight matrix:
#> Active Average Disengaged
#> Active 459 176 23
#> Average 153 458 140
#> Disengaged 39 129 157
#>
#> Initial probabilities:
#> Active 0.382 ████████████████████████████████████████
#> Average 0.368 ██████████████████████████████████████
#> Disengaged 0.250 ██████████████████████████