activity.attribute: Activity Attributes for Dynamically Extended Networks

In networkDynamic: Dynamic Extensions for Network Objects

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 [e-mail], Carter T. Butts [e-mail]

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

networkDynamic documentation built on May 29, 2024, 1:16 a.m.