R: Geometrically weighted non-edgewise shared partner...

dgwnsp-ergmTerm {ergm} | R Documentation

## Geometrically weighted non-edgewise shared partner distribution

### Description

This term is just like gwesp and gwdsp except it adds a statistic equal to the geometrically weighted nonedgewise (that is, over dyads that do not have an edge) shared partner distribution with decay parameter `decay` parameter.

### Usage

    # binary: dgwnsp(decay, fixed=FALSE, cutoff=30, type="OTP")

### Arguments

`decay` | nonnegative decay parameter for the shared partner or selected directed analogue count; required if `fixed=TRUE` and ignored with a warning otherwise.
`fixed` | optional argument indicating whether the `decay` parameter is fixed at the given value, or is to be fit as a curved exponential-family model (see Hunter and Handcock, 2006). The default is `FALSE` , which means the scale parameter is not fixed and thus the model is a curved exponential family.
`cutoff` | This optional argument sets the number of underlying NSP terms to use in computing the statistics when `fixed=FALSE`, in order to reduce the computational burden. Its default value can also be controlled by the `gw.cutoff` term option control parameter. (See `?control.ergm`.)
`type` | one of `c("OTP", "ITP", "RTP", "OSP", "ISP")`

### Note

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 k is an OTP shared partner of ordered pair (i,j) iff i->k->j. Also known as "transitive shared partner".

- Incoming Two-path (`"ITP"`): vertex k is an ITP shared partner of ordered pair (i,j) iff j->k->i. Also known as "cyclical shared partner"

- Reciprocated Two-path (`"RTP"`): vertex k is an RTP shared partner of ordered pair (i,j) iff i<->k<->j.

- Outgoing Shared Partner (`"OSP"`): vertex k is an OSP shared partner of ordered pair (i,j) iff i->k, j->k.

- Incoming Shared Partner (`"ISP"`): vertex k is an ISP shared partner of ordered pair (i,j) iff k->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.

The `decay` parameter was called `alpha` prior to `ergm` 3.7.

### See Also

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

[Package ergm version 4.2.2 Index]