R: Activity Attributes for Dynamically Extended Networks

activity.attribute {networkDynamic} | R Documentation

## Activity Attributes for Dynamically Extended Networks

### Description

Dynamically extended networks are `networkDynamic` class objects (extensions of network objects) whose vertex and edge elements include timing information. This page describes the types of timing information currently available, and the general syntax for setting or querying this information.

### Details

Currently, each edge and vertex in a dynamically extended network is presumed to be in one of two states at any given point in time: (“active” or “inactive”). The state of a network element (i.e., edge or vertex) is governed by an attribute with the name “active”, which is considered a reserved term for purposes of this package.

The activity attribute consists of a two-column numeric matrix. Each row contains an activity spell, and the two columns encode onset and terminus times respectively. Elements are presumed inactive until the onset of their first activity spell, and are likewise presumed inactive after the termination of their last active spell.

Spells are taken to span the period from the onset (inclusive) to the terminus (exclusive), so [onset,terminus). They must be consecutive, ordered forward in time, and strictly non-overlapping.

The syntax for defining or querying spells can specify either an instantaneous time point or an interval. The commands for this include `at=`, `onset=`, `terminus=` and `length=`. Any numeric values may be used in the interval specifications, including `Inf` and `-Inf`, (with some restrictions, see below). A spell with `onset=-Inf` represents onset censoring. A spell with `terminus=Inf` represents terminus censoring. `Inf` and `-Inf` cannot be used with the `at` specification. Similarly, `onset` can not be `Inf` and `terminus` can not be -Inf.

The general syntax rules for specifying spells are as follows:

To specify a spell as a single time point:

- use the `at` argument, or

- use `onset=terminus`.

To specify a spell as a particular interval, one of the following combinations of `onset`, `terminus` and `length` is required:

- `onset` and `terminus`

- `onset` and `length`

- `terminus` and `length`

The special “null” spell is used to designate elements that are never active (i.e., have no valid activity spells). These can only be set by the `deactivate` function (see `activity.attribute`) and by convention are stored as `c(Inf,Inf)`. “Null” spells are incompatible with other spells, and should be replaced whenever an activation enters the element's event history.

Although it is possible to access and modify the activity spells using network attribute methods (e.g., `get.edge.attribute`) it is not recommended, and extreme care should be taken to preserve the structure of the spell matrix. The preferred way to modify the spells of a network element is with the `activate` related methods. Vertices and edges with specific activity ranges can be selected using `network.extensions`.

In addition, a number of special functions are also provided to simplify common tasks related to the `active` attribute (noted below).

### Author(s)

Ayn Leslie-Cook aynlc3@uw.edu, Carter T. Butts buttsc@uci.edu

### See Also

`is.active`, `activate`, `activate.vertices`,`activate.edges`, `deactivate.vertices`,`deactivate.edges`,`network.extensions`

### Examples

    triangle <- network.initialize(3)  # create a toy network

    activate.vertices(triangle,onset=1,terminus=5,v=1)
    activate.vertices(triangle,onset=1,terminus=10,v=2)
    activate.vertices(triangle,onset=4,terminus=10,v=3)
    deactivate.vertices(triangle,onset=2, length=2, v=1)

    get.vertex.activity(triangle) # vertex spells

[Package networkDynamic version 0.9.0 Index]