ddspL-ergmTerm-c6c3ac1f function

Dyadwise shared partners on layers

Dyadwise shared partners on layers

This term adds one network statistic to the model for each element in d where the ii th such statistic equals the number of dyads in the network with exactly d[i] shared partners. For a directed network, multiple shared partner definitions are possible.

dspL and ddspL are aliases for consistency with ergm.

# binary: ddspL(d, type="OTP", Ls.path=NULL, L.in_order=FALSE) # binary: dspL(d, type="OTP", Ls.path=NULL, L.in_order=FALSE)

Arguments

  • Ls.path, L.in_order: a vector of one or two formulas Ls.path

    provides the Layer Logic (c.f. Layer Logic section in the Layer() documentation) specifications for the ties of the 2-path or the shared partnership. (If only one formula is given the layers are assumed to be the same.) If L.in_order==TRUE , the first tie of the two-path must be the first element of Ls.path and the second must be the second; otherwise, any ordering counts, provided there is exactly one of each. (For types "OSP" and "ISP" , the first tie is considered to be the one incident on the tail of the base tie.)

Note

This term takes an additional term option (see options?ergm), cache.sp, controlling whether the implementation will cache the number of shared partners for each dyad in the network; this is usually enabled by default.

Shared partner types

While there is only one shared partner configuration in the undirected case, nine distinct configurations are possible for directed graphs, selected using the type argument. Currently, terms may be defined with respect to five of these configurations; they are defined here as follows (using terminology from Butts (2008) and the relevent package):

  • Outgoing Two-path ("OTP"): vertex kk is an OTP shared partner of ordered pair (i,j)(i,j) iff ikji-\>k-\>j. Also known as "transitive shared partner".
  • Incoming Two-path ("ITP"): vertex kk is an ITP shared partner of ordered pair (i,j)(i,j) iff jkij-\>k-\>i. Also known as "cyclical shared partner"
  • Reciprocated Two-path ("RTP"): vertex kk is an RTP shared partner of ordered pair (i,j)(i,j) iff i\<k\<ji\<-\>k\<-\>j.
  • Outgoing Shared Partner ("OSP"): vertex kk is an OSP shared partner of ordered pair (i,j)(i,j) iff ik,jki-\>k, j-\>k.
  • Incoming Shared Partner ("ISP"): vertex kk is an ISP shared partner of ordered pair (i,j)(i,j) iff ki,kjk-\>i, k-\>j. By default, outgoing two-paths ("OTP") are calculated. Note that Robins et al. (2009) define closely related statistics to several of the above, using slightly different terminology.

See Also

ergmTerm for index of model terms currently visible to the package.

ergm:::.formatTermKeywords("ergmTerm", "ddspL", "subsection")

  • Maintainer: Pavel N. Krivitsky
  • License: GPL-3 + file LICENSE
  • Last published: 2024-11-05