Nodes
A list of nodes that can be iterated over.
Methods
| Method | Description |
|---|---|
after | Create a view of the Nodes including all events after start (exclusive). |
at | Create a view of the Nodes including all events at time. |
before | Create a view of the Nodes including all events before end (exclusive). |
collect | Collect all nodes into a list |
default_layer | Return a view of Nodes containing only the default edge layer |
degree | Returns the number of edges of the nodes. |
edge_history_count | Return the number of edge updates for each node |
exclude_layer | Return a view of Nodes containing all layers except the excluded name |
exclude_layers | Return a view of Nodes containing all layers except the excluded names |
exclude_valid_layer | Return a view of Nodes containing all layers except the excluded name |
exclude_valid_layers | Return a view of Nodes containing all layers except the excluded names |
expanding | Creates a WindowSet with the given step size using an expanding window. |
filter | Return a filtered view that only includes nodes and edges that satisfy the filter |
has_layer | Check if Nodes has the layer "name" |
in_degree | Returns the number of in edges of the nodes. |
latest | Create a view of the Nodes including all events at the latest time. |
layer | Return a view of Nodes containing the layer "name" |
layers | Return a view of Nodes containing all layers names |
out_degree | Returns the number of out edges of the nodes. |
rolling | Creates a WindowSet with the given window size and optional step using a rolling window. |
shrink_end | Set the end of the window to the smaller of end and self.end() |
shrink_start | Set the start of the window to the larger of start and self.start() |
shrink_window | Shrink both the start and end of the window (same as calling shrink_start followed by shrink_end but more efficient) |
snapshot_at | Create a view of the Nodes including all events that have not been explicitly deleted at time. |
snapshot_latest | Create a view of the Nodes including all events that have not been explicitly deleted at the latest time. |
to_df | Converts the graph's nodes into a Pandas DataFrame. |
type_filter | Filter nodes by node type. |
valid_layers | Return a view of Nodes containing all layers names |
window | Create a view of the Nodes including all events between start (inclusive) and end (exclusive) |
Properties
| Property | Description |
|---|---|
earliest_time | The earliest times nodes are active |
edges | Get the edges that are incident to this node. |
end | Gets the latest time that this Nodes is valid. |
history | Returns all history objects of nodes, with information on when a node is added or change to a node is made. |
id | The node ids |
in_edges | Get the edges that point into this node. |
in_neighbours | Get the neighbours of this node that point into this node. |
latest_time | The latest time nodes are active |
metadata | The metadata of the nodes. |
name | The node names |
neighbours | Get the neighbours of this node. |
node_type | The node types |
out_edges | Get the edges that point out of this node. |
out_neighbours | Get the neighbours of this node that point out of this node. |
properties | The properties of the node. |
start | Gets the start time for rolling and expanding windows for this Nodes |
window_size | Get the window size (difference between start and end) for this Nodes. |
Method Details
after
Signature: after(start)
Create a view of the Nodes including all events after start (exclusive).
Parameters
| Name | Type | Default | Description |
|---|---|---|---|
start | TimeInput | - | The start time of the window. |
Returns
| Type | Description |
|---|---|
| Nodes |
at
Signature: at(time)
Create a view of the Nodes including all events at time.
Parameters
| Name | Type | Default | Description |
|---|---|---|---|
time | TimeInput | - | The time of the window. |
Returns
| Type | Description |
|---|---|
| Nodes |
before
Signature: before(end)
Create a view of the Nodes including all events before end (exclusive).
Parameters
| Name | Type | Default | Description |
|---|---|---|---|
end | TimeInput | - | The end time of the window. |
Returns
| Type | Description |
|---|---|
| Nodes |
collect
Collect all nodes into a list
Returns
| Type | Description |
|---|---|
| list[Node] | the list of nodes |
default_layer
Return a view of Nodes containing only the default edge layer
Returns
| Type | Description |
|---|---|
| Nodes | The layered view |
degree
Returns the number of edges of the nodes.
Returns
| Type | Description |
|---|---|
| DegreeView | a view of the undirected node degrees. |
edge_history_count
Return the number of edge updates for each node
Returns
| Type | Description |
|---|---|
| EdgeHistoryCountView | a view of the edge history counts |
exclude_layer
Signature: exclude_layer(name)
Return a view of Nodes containing all layers except the excluded name
Errors if any of the layers do not exist.
Parameters
| Name | Type | Default | Description |
|---|---|---|---|
name | str | - | layer name that is excluded for the new view |
Returns
| Type | Description |
|---|---|
| Nodes | The layered view |
exclude_layers
Signature: exclude_layers(names)
Return a view of Nodes containing all layers except the excluded names
Errors if any of the layers do not exist.
Parameters
| Name | Type | Default | Description |
|---|---|---|---|
names | list[str] | - | list of layer names that are excluded for the new view |
Returns
| Type | Description |
|---|---|
| Nodes | The layered view |
exclude_valid_layer
Signature: exclude_valid_layer(name)
Return a view of Nodes containing all layers except the excluded name
Parameters
| Name | Type | Default | Description |
|---|---|---|---|
name | str | - | layer name that is excluded for the new view |
Returns
| Type | Description |
|---|---|
| Nodes | The layered view |
exclude_valid_layers
Signature: exclude_valid_layers(names)
Return a view of Nodes containing all layers except the excluded names
Parameters
| Name | Type | Default | Description |
|---|---|---|---|
names | list[str] | - | list of layer names that are excluded for the new view |
Returns
| Type | Description |
|---|---|
| Nodes | The layered view |
expanding
Signature: expanding(step, alignment_unit=None)
Creates a WindowSet with the given step size using an expanding window.
An expanding window is a window that grows by step size at each iteration.
Parameters
| Name | Type | Default | Description |
|---|---|---|---|
step | int | str | - | The step size of the window. |
alignment_unit | str | None, optional | None | If no alignment_unit is passed, aligns the start of the first window to the smallest unit of time passed to step. For example, if the step is "1 month and 1 day", the windows will be aligned on days (00:00:00 to 23:59:59). If set to "unaligned", the first window will begin at the first time event. If any other alignment unit is passed, the windows will be aligned to that unit. alignment_unit defaults to None. |
Returns
| Type | Description |
|---|---|
| WindowSet | A WindowSet object. |
filter
Signature: filter(filter)
Return a filtered view that only includes nodes and edges that satisfy the filter
Parameters
| Name | Type | Default | Description |
|---|---|---|---|
filter | filter.FilterExpr | - | The filter to apply to the nodes and edges. |
Returns
| Type | Description |
|---|---|
| Nodes | The filtered view |
has_layer
Signature: has_layer(name)
Check if Nodes has the layer "name"
Parameters
| Name | Type | Default | Description |
|---|---|---|---|
name | str | - | the name of the layer to check |
Returns
| Type | Description |
|---|---|
| bool |
in_degree
Returns the number of in edges of the nodes.
Returns
| Type | Description |
|---|---|
| DegreeView | a view of the in-degrees of the nodes |
latest
Create a view of the Nodes including all events at the latest time.
Returns
| Type | Description |
|---|---|
| Nodes |
layer
Signature: layer(name)
Return a view of Nodes containing the layer "name"
Errors if the layer does not exist
Parameters
| Name | Type | Default | Description |
|---|---|---|---|
name | str | - | then name of the layer. |
Returns
| Type | Description |
|---|---|
| Nodes | The layered view |
layers
Signature: layers(names)
Return a view of Nodes containing all layers names
Errors if any of the layers do not exist.
Parameters
| Name | Type | Default | Description |
|---|---|---|---|
names | list[str] | - | list of layer names for the new view |
Returns
| Type | Description |
|---|---|
| Nodes | The layered view |
out_degree
Returns the number of out edges of the nodes.
Returns
| Type | Description |
|---|---|
| DegreeView | a view of the out-degrees of the nodes. |
rolling
Signature: rolling(window, step=None, alignment_unit=None)
Creates a WindowSet with the given window size and optional step using a rolling window.
If alignment_unit is not "unaligned" and a step larger than window is provided, some time entries
may appear before the start of the first window and/or after the end of the last window (i.e. not included in any window).
A rolling window is a window that moves forward by step size at each iteration.
Parameters
| Name | Type | Default | Description |
|---|---|---|---|
window | int | str | - | The size of the window. |
step | int | str | None, optional | None | The step size of the window. step defaults to window. |
alignment_unit | str | None, optional | None | If no alignment_unit is passed, aligns the start of the first window to the smallest unit of time passed to step (or window if no step is passed). For example, if the step is "1 month and 1 day", the first window will begin at the start of the day of the first time event. If set to "unaligned", the first window will begin at the first time event. If any other alignment unit is passed, the windows will be aligned to that unit. alignment_unit defaults to None. |
Returns
| Type | Description |
|---|---|
| WindowSet | A WindowSet object. |
shrink_end
Signature: shrink_end(end)
Set the end of the window to the smaller of end and self.end()
Parameters
| Name | Type | Default | Description |
|---|---|---|---|
end | TimeInput | - | the new end time of the window |
Returns
| Type | Description |
|---|---|
| Nodes |
shrink_start
Signature: shrink_start(start)
Set the start of the window to the larger of start and self.start()
Parameters
| Name | Type | Default | Description |
|---|---|---|---|
start | TimeInput | - | the new start time of the window |
Returns
| Type | Description |
|---|---|
| Nodes |
shrink_window
Signature: shrink_window(start, end)
Shrink both the start and end of the window (same as calling shrink_start followed by shrink_end but more efficient)
Parameters
| Name | Type | Default | Description |
|---|---|---|---|
start | TimeInput | - | the new start time for the window |
end | TimeInput | - | the new end time for the window |
Returns
| Type | Description |
|---|---|
| Nodes |
snapshot_at
Signature: snapshot_at(time)
Create a view of the Nodes including all events that have not been explicitly deleted at time.
This is equivalent to before(time + 1) for Graph and at(time) for PersistentGraph
Parameters
| Name | Type | Default | Description |
|---|---|---|---|
time | TimeInput | - | The time of the window. |
Returns
| Type | Description |
|---|---|
| Nodes |
snapshot_latest
Create a view of the Nodes including all events that have not been explicitly deleted at the latest time.
This is equivalent to a no-op for Graph and latest() for PersistentGraph
Returns
| Type | Description |
|---|---|
| Nodes |
to_df
Signature: to_df(include_property_history=False, convert_datetime=False)
Converts the graph's nodes into a Pandas DataFrame.
This method will create a DataFrame with the following columns:
- "name": The name of the node.
- "properties": The properties of the node.
- "update_history": The update history of the node.
Parameters
| Name | Type | Default | Description |
|---|---|---|---|
include_property_history | bool, optional | False | A boolean, if set to True, the history of each property is included, if False, only the latest value is shown. Defaults to False. |
convert_datetime | bool, optional | False | A boolean, if set to True will convert the timestamp to python datetimes. Defaults to False. |
Returns
| Type | Description |
|---|---|
| DataFrame | the view of the node data as a pandas Dataframe. |
type_filter
Signature: type_filter(node_types)
Filter nodes by node type.
Parameters
| Name | Type | Default | Description |
|---|---|---|---|
node_types | list[str] | - | the list of node types to keep. |
Returns
| Type | Description |
|---|---|
| Nodes | the filtered view of the nodes |
valid_layers
Signature: valid_layers(names)
Return a view of Nodes containing all layers names
Any layers that do not exist are ignored
Parameters
| Name | Type | Default | Description |
|---|---|---|---|
names | list[str] | - | list of layer names for the new view |
Returns
| Type | Description |
|---|---|
| Nodes | The layered view |
window
Signature: window(start, end)
Create a view of the Nodes including all events between start (inclusive) and end (exclusive)
Parameters
| Name | Type | Default | Description |
|---|---|---|---|
start | TimeInput | - | The start time of the window. |
end | TimeInput | - | The end time of the window. |
Returns
| Type | Description |
|---|---|
| Nodes |
Property Details
earliest_time
The earliest times nodes are active
Returns
| Type | Description |
|---|---|
| EarliestTimeView | a view of the earliest active times |
edges
Get the edges that are incident to this node.
Returns
| Type | Description |
|---|---|
| NestedEdges | The incident edges. |
end
Gets the latest time that this Nodes is valid.
Returns
| Type | Description |
|---|---|
| OptionalEventTime | The latest time that this Nodes is valid or None if the Nodes is valid for all times. |
history
Returns all history objects of nodes, with information on when a node is added or change to a node is made.
Returns
| Type | Description |
|---|---|
| HistoryView | a view of the node histories |
id
The node ids
Returns
| Type | Description |
|---|---|
| IdView | a view of the node ids |
in_edges
Get the edges that point into this node.
Returns
| Type | Description |
|---|---|
| NestedEdges | The inbound edges. |
in_neighbours
Get the neighbours of this node that point into this node.
Returns
| Type | Description |
|---|---|
| PathFromGraph | The in-neighbours. |
latest_time
The latest time nodes are active
Returns
| Type | Description |
|---|---|
| LatestTimeView | a view of the latest active times |
metadata
The metadata of the nodes.
Returns
| Type | Description |
|---|---|
| MetadataView | A view of the node properties. |
name
The node names
Returns
| Type | Description |
|---|---|
| NameView | a view of the node names |
neighbours
Get the neighbours of this node.
Returns
| Type | Description |
|---|---|
| PathFromGraph | The neighbours (both inbound and outbound). |
node_type
The node types
Returns
| Type | Description |
|---|---|
| NodeTypeView | a view of the node types |
out_edges
Get the edges that point out of this node.
Returns
| Type | Description |
|---|---|
| NestedEdges | The outbound edges. |
out_neighbours
Get the neighbours of this node that point out of this node.
Returns
| Type | Description |
|---|---|
| PathFromGraph | The out-neighbours. |
properties
The properties of the node.
Returns
| Type | Description |
|---|---|
| PropertiesView | A view of the node properties. |
start
Gets the start time for rolling and expanding windows for this Nodes
Returns
| Type | Description |
|---|---|
| OptionalEventTime | The earliest time that this Nodes is valid or None if the Nodes is valid for all times. |
window_size
Get the window size (difference between start and end) for this Nodes.
Returns
| Type | Description |
|---|---|
| int, optional |