R: Retrieve the timing information present in a networkDynamic.

get.timing.info {networkDynamic} | R Documentation

## Retrieve the timing information present in a networkDynamic.

### Description

These methods return either the activity spells of each vertex or edge or the unique time points at which edges and vertices become active or inactive.

Finds all of the unique time points at which the edges and/or vertices become active or inactive.

### Usage

    get.change.times(x, vertex.activity=TRUE, edge.activity=TRUE, ignore.inf=TRUE,
                 vertex.attribute.activity = TRUE, edge.attribute.activity = TRUE,
                 network.attribute.activity = TRUE)
    get.vertex.activity(x, v=seq_len(network.size(x)),
                       as.spellList=FALSE, active.default=TRUE)
    get.edge.activity(x, e=seq_along(x$mel), as.spellList=FALSE, active.default=TRUE)

### Arguments

`x` | an object, of class `network` or `networkDynamic`.
`vertex.activity` | logical, whether the times at which vertices become active or inactive is to be returned.
`edge.activity` | logical, whether the times at which edges become active or inactive is to be returned.
`vertex.attribute.activity` | logical, whether the times attached to any dynamic vertex attributes should be returned
`edge.attribute.activity` | logical, whether the times attached to any dynamic edge attributes should be returned
`network.attribute.activity` | logical, whether the times attached to any dynamic network attributes should be returned
`ignore.inf` | logical, whether Inf value will be ignored or not.
`e` | IDs for the edges whose activity spells are wanted.
`v` | IDs for the vertices whose activity spells are wanted.
`as.spellList` | should data be returned in spell matrix form? TODO: should this be callsed as.spellmatrix instead?
`active.default` | logical, should edges / vertices with no spell activity defined be treated as always active (`TRUE`) and included in output, or never active (`FALSE`) and skipped.

### Value

For the `get.change.times` function, the default settings return a vector of all of the finite time points at which any edge or any vertex becomes active or inactive, or any of their dynamic attributes change. If only one of the logical arguments, say `vertex.activity`, is set to `FALSE`, then the time points for the corresponding parts of the data structure will not be returned. If both are `FALSE`, numeric(0) is returned.

For the `get.vertex.activity` and `get.edge.activity` functions, a list of activity spells is returned with each list element corresponding to the id of the vertex or edge. Deleted edges will appear as NULL entries, as will any spell marked as inactive with the 'null' (Inf,Inf) spell. If the argument `as.spellList=TRUE` the activity spells are instead formatted as a `data.frame` and include additional columns to indicate possible onset- and terminus-censoring. Any 'null' spells and deleted edges will be omited.

For `get.vertex.activity` the columns are `[onset,terminus,vertex.id,onset.censored,terminus.censored,duration]`.

For `get.edge.activity` the columns are `[onset, terminus, tail, head, onset.censored, terminus.censored, duration, edge.id]` .

The data.frames will be sorted by id, onset, terminus.

If a `net.obs.period` network attribute is set, the range of its `$observations` element is substituted in for the -Inf and Inf values that otherwise indicate the onset- and terminus-censored observations.

### Author(s)

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

### See Also

See also `activity.attribute`,`net.obs.period`,`as.data.frame.networkDynamic`

### Examples

      library(networkDynamic)
      data(flo)
      net1 <- network(flo)
      activate.edges(net1, onset=1:20, terminus=101:120)
      activate.vertices(net1, at=seq(2,32,2))
      get.change.times(net1)
      get.edge.activity(net1)
      get.edge.activity(net1,as.spellList=TRUE)
      get.vertex.activity(net1)

      a <-network.initialize(5)
      activate.vertices(a,onset=0,terminus=Inf)
      get.change.times(a,ignore.inf=FALSE)

[Package networkDynamic version 0.9.0 Index]