remulateTieEffects | R Documentation |
This page lists the effects that are available in the remulate package for the tie oriented relational event model.
remulateTieEffects(endogenous = NULL)
endogenous |
Logical or NULL. If 'TRUE', returns only endogenous effects. If 'FALSE', returns only exogenous effects. If 'NULL' (default), returns both endogenous and exogenous effects. |
The attr_actors object for exogenous effects based on actor covariates (send
, receive
, same
, difference
, average
, max
, min
) contains at least three columns (actor,time,attribute). It should be constructed as follows: Each row refers to the attribute value of actor i at timepoint t. The first column contains the actor names (corresponding to the vector of names in the actors
argument of remulateTie
). The second column contains the time when attr_actors change (set to zero if the attr_actors do not vary over time). At least one of the subsequent columns must contain values for the attr_actors with column name corresponding to variable name specified in the effect specification.
The attribute object for exogenous effect dyad
contains at least three columns (sender_id,receiver_id,attribute). It should be constructed as follows: First column must contain sender id, second column receiver id, at least one of the subsequent columns must contain values for the attr_actors with column name corresponding to variable name specified in the effect specification.
if param is a data frame, it must have three columns: sender, receiver, and value (numeric), representing the parameter value for thay dyadic pair. The data.frame must contain all pairs of actors or dyads corresponding to the riskset.
if param is a function, it's first argument must be 't', corresponding to the time. The function may have additional arguments.
The indices aregument in the interact effect corresponds to the position of the specified effects in the effects
argument of remulateTie
for which the interaction needs to be computed. The individual constitutive effects for an interaction must be specified before the interact term in the effects
argument. To omit the individual constitutive effects in the generation, specify the param
arugment to zero.
Returns a character vector of available effects for the effects
argument for the function remulateTie
.
baseline
Baseline tendency for dyads to create events. The statistic equals to 1 for all dyads (i,j) in the riskset. The parameter for baseline controls the average number of events per unit time.
Endogenous effects (Dyad statistics):
inertia
Inertia is the tendency to create an event i->j if the event i->j occurred in the past. The statistic at timepoint t for dyad (i,j) is
equal to the number of (i,j) events before timepoint t. Note: if scaling
is "prop" for inertia, the statistic for dyad (i,j) at time t is divided by the out degree of the sender i at time t.
reciprocity
Reciprocity is the tendency to create an event i->j if j->i occurred in the past.The statistic at timepoint t for dyad (i,j) is
equal to the number of (j,i) events before timepoint t. Note: if scaling
is "prop" for reciprocity, the statistic for dyad (i,j) at time t is divided by the in degree of the sender i at time t.
tie
Tie effect is the tendency to create an event i->j if the event i->j occurred at least once in the past. The statistic at timepoint t for dyad (i,j) is equal to 1 if a an event i->j occurred before timepoint t
Endogenous effects (Triadic statistics):
otp
Outgoing Two Path effect is the tendency to create an event i->j if they have past outgoing two-paths between them (i->h->j). The statistic for dyad (i,j) at timepoint t is equal to the minimum of past (i,h), (h,j) events, summed over all h.
itp
Incoming Two Path effect is the tendency to create an event i->j if they have past incoming two-paths between them (i<-h<-j). The statistic for dyad (i,j) at timepoint t is equal to the minimum of past (j,h), (h,i) events, summed over all h.
osp
Outgoing Shared Partners effect is the tendency to create an event i->j if they have past outgoing shared partners between them (i->h<-j). The statistic for dyad (i,j) at timepoint t is equal to the minimum of past (i,h), (j,h) events, summed over all h.
isp
Incoming Shared Partners effect is the tendency to create an event i->j if they have past incoming shared partners between them (i<-h->j). The statistic for dyad (i,j) at timepoint t is equal to the minimum of past (h,i), (h,j) events, summed over all h.
Endogenous effects (Node statistics):
indegreeSender
In degree effect of the sender is the tendency
to create an event i->j if i has received more events in the past.
The statistic at timepoint t for dyad (i,j) is equal to the number of events
received by actor i before timepoint t. Note: if scaling
is "prop" for indegreeSender,
the statistic for dyad (i,j) at time t is divided by the number of past events until time t.
indegreeReceiver
In degree effect of receiver is the tendency
to create an event i->j if j has received more events in the past. The statistic at timepoint t for dyad (i,j) is equal to the number of events received by actor j before timepoint t. Note: if scaling
is "prop" for indegreeReceiver, the statistic for dyad (i,j) at time t is divided by the number of past events until time t.
outdegreeSender
Out degree effect of sender is the tendency
to create an event i->j if i has sent more events in the past. Note: if scaling
is "prop" for outdegreeSender, the statistic for dyad (i,j) at time t is divided by by the number of past events until time t.
outdegreeReceiver
Out degree effect of receiver is the tendency to create an event i->j if j has sent more events in the past. Note: if scaling
is "prop" for outdegreeReceiver, the statistic for dyad (i,j) at time t is divided by the number of past events until time t.
totaldegreeSender
Total degree effect of sender is the tendency to create an event i->j if i has sent and received more events in the past.
totaldegreeReceiver
Total degree effect of receiver is the tendency to create an event i->j if j has sent and received more events in the past.
Endogenous effects (Participating Shifts):
psABBA
AB-BA Pacticipating shift (turn receiving) is the tendency to create an event j->i at timepoint t if event i->j occurred at timepoint t-1. The psABBA statistic is equal to one for the dyad (j.i) that will create the participation shift at timepoint t.
psABBY
AB-BY Participating shift (turn receiving) is the tendency to create an event j->h at timepoint t if event i->j occurred at timepoint t-1. The psABBY statistic is equal to one for the dyads (j,h) for all h not equal to i, that will create the participation shift at timepoint t.
PSABAY
AB-AY Participating shifts (turn continuing) is the tendency to create an event i->h at timepoint t if event i->j occurred at timepoint t-1. The PSABAY statistic is equal to one for the dyads (i,h) for all h not equal to j, that will create the participation shift at timepoint t.
psABXA
AB-XA Participating shifts (turn usurping) is the tendency to create an event h->i at timepoint t if event i->j occurred at timepoint t-1. The psABXA statistic is equal to one for the dyads (h,i) for all h not equal to j, that will create the participation shift at timepoint t.
psABXB
AB-XB Participating shifts (turn usurping) is the tendency to create an event h->j at timepoint t if event i->j occurred at timepoint t-1. The psABXB statistic is equal to one for the dyads (h,j) for all h not equal to i, that will create the participation shift at timepoint t.
psABXY
AB-XY Participating shifts (turn usurping) is the tendency to create an event h->k at timepoint t if event i->j occurred at timepoint t-1. The psABXB statistic is equal to one for the dyads (h,k) for all h not equal to i and k not equal to j, that will create the participation shift at timepoint t.
Endogenous effects (Recency statistics):
recencyContinue
The recencyContinue effect refers to a recency statistic similar to what is described in Vu et al. (2017) and Mulder and Leenders (2019). For each timepoint t, for directed dyad (i,j) the statistic is equal to 1/(the time that has past since the dyad was last active + 1).
recencySendSender
The recencySendSender effect refers to a recency statistic similar to what is described in Vu et al. (2017) and Mulder and Leenders (2019). For each timepoint t, for directed dyad (i,j) the statistic is equal to 1/(the time that has past since sender i was last active as sender + 1).
recencySendReceiver
The recencySendReceiver effect refers to a recency statistic similar to what is described in Vu et al. (2017) and Mulder and Leenders (2019). For each timepoint t, for directed dyad (i,j) the statistic is equal to 1/(the time that has past since receiver j was last active as sender + 1).
recencyReceiveSender
The recencyReceiveSender effect refers to a recency statistic similar to what is described in Vu et al. (2017) and Mulder and Leenders (2019). For each timepoint t, for directed dyad (i,j) the statistic is equal to 1/(the time that has past since sender i was last active as receiver + 1).
recencyReceiveReceiver
The recencyReceiveReceiver effect refers to a recency statistic similar to what is described in Vu et al. (2017) and Mulder and Leenders (2019). For each timepoint t, for directed dyad (i,j) the statistic is equal to 1/(the time that has past since receiver j was last active as receiver + 1).
Exogenous effects (Node attr_actors):
send
Sender covariate: The tendency to create an event i->j when i has a high attribute value.
receive
Receiver covariate: The tendency to create an event i->j when j has a high attribute value.
Exogenous effects (Tie Attribute):
dyad
dyad attribute value is the tendency to create an event i -> j when (i,j) has a high attribute value.
same
(Homophily) is the tendency to create an event i->j if actors i and j have the same attribute values
difference
(Heterophily) is the tendency to create an event i->j if actors i and j have a high absolute difference in attribute values
average
average attribute value for dyad (i,j) is the average of the attribute values for actors i, j
minimum
minimum attribute value for dyad (i,j) is the smaller of the attribute values for actors i , j
maximum
maximum attribute value for dyad (i,j) is the bigger of the attribute values for actors i , j
#To specify an endogenous effect (example: inertia)
effects <- ~ inertia(0.1, scaling = "std")
#To specify an exogenous effect (example: same)
cov <- data.frame(
actor = 1:10,
time = rep(0, 10),
gender = sample(c(0, 1), replace = TRUE, 10),
age = sample(20:30, 10, replace = TRUE)
)
effects <- ~ same(0.2, variable = "gender", attr_actors = cov)
#To specify an exogenous dyadic effect (example: dyad)
cov <- expand.grid(1:10, 1:10)
cov <- cov[cov[, 1] != cov[, 2], ]
cov$grade <- runif(90, 1, 10)
effects <- ~ dyad(0.2, variable = "grade", attr_actors = cov)
#If parameter is constant
effects <- ~ inertia(0.3) +
same(0.2, variable = "gender", attr_actors = cov) +
reciprocity(-0.1) +
itp(0.01)
#If parameter varies with time
effects <- ~ inertia(param = function(t) exp(-t)) +
same(0.2, variable = "gender", attr_actors = cov) +
reciprocity(-0.1) +
itp(0.01)
#If parameter varies across dyads or actors
rs <- expand.grid(1:10,1:10)
rs <- rs[rs[,1] != rs[, 2],]
param_df <- as.data.frame(rs)
param_df$beta = runif(nrow(rs),-0.1,0.1)
effects <- ~ remulate::baseline(-3)+
remulate::inertia(param_df) +
remulate::reciprocity(0.1)
#To specify an interaction (example: between inertia and same constitutive effects)
effects <- ~ inertia(0.3) +
same(0.2, variable = "gender", attr_actors = cov) +
reciprocity(-0.1) +
itp(0.01) +
interact(0.1, indices = c(1, 2))
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.