Node
Constructs node filter expressions.
Each method returns either:
- a field-specific filter builder, or
- a view-restricted filter context, or
- a boolean predicate over node state.
Methods
| Method | Description |
|---|---|
after | Restricts node evaluation to times strictly after the given time. |
at | Restricts node evaluation to a single point in time. |
before | Restricts node evaluation to times strictly before the given time. |
by_state_column | |
id | Selects the node ID field for filtering. |
is_active | Matches nodes that have at least one event in the current view. |
latest | Evaluates filters against the latest available state of each node. |
layer | Restricts evaluation to nodes belonging to the given layer. |
layers | Restricts evaluation to nodes belonging to any of the given layers. |
metadata | Filters a node metadata field by name. |
name | Selects the node name field for filtering. |
node_type | Selects the node type field for filtering. |
property | Filters a node property by name. |
snapshot_at | Evaluates filters against a snapshot of the graph at a given time. |
snapshot_latest | Evaluates filters against the most recent snapshot of the graph. |
window | Restricts node evaluation to the given time window. |
Method Details
after
Signature: after(time)
Restricts node evaluation to times strictly after the given time.
Parameters
| Name | Type | Default | Description |
|---|---|---|---|
time | int | - | Lower time bound. |
at
Signature: at(time)
Restricts node evaluation to a single point in time.
Parameters
| Name | Type | Default | Description |
|---|---|---|---|
time | int | - | Event time. |
before
Signature: before(time)
Restricts node evaluation to times strictly before the given time.
Parameters
| Name | Type | Default | Description |
|---|---|---|---|
time | int | - | Upper time bound. |
by_state_column
Signature: by_state_column(state, col)
Parameters
id
Selects the node ID field for filtering.
is_active
Matches nodes that have at least one event in the current view.
latest
Evaluates filters against the latest available state of each node.
layer
Signature: layer(layer)
Restricts evaluation to nodes belonging to the given layer.
Parameters
| Name | Type | Default | Description |
|---|---|---|---|
layer | str | - | Layer name. |
layers
Signature: layers(layers)
Restricts evaluation to nodes belonging to any of the given layers.
Parameters
| Name | Type | Default | Description |
|---|---|---|---|
layers | list[str] | - | Layer names. |
metadata
Signature: metadata(name)
Filters a node metadata field by name.
Metadata is shared across all temporal versions of a node.
Parameters
| Name | Type | Default | Description |
|---|---|---|---|
name | str | - | Metadata key. |
name
Selects the node name field for filtering.
node_type
Selects the node type field for filtering.
property
Signature: property(name)
Filters a node property by name.
The property may be static or temporal depending on the query context.
Parameters
| Name | Type | Default | Description |
|---|---|---|---|
name | str | - | Property key. |
snapshot_at
Signature: snapshot_at(time)
Evaluates filters against a snapshot of the graph at a given time.
Parameters
| Name | Type | Default | Description |
|---|---|---|---|
time | int | - | Snapshot time. |
snapshot_latest
Evaluates filters against the most recent snapshot of the graph.
window
Signature: window(start, end)
Restricts node evaluation to the given time window.
The window is inclusive of start and exclusive of end.