Node
#
Bases: object
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.
after(time)
staticmethod
#
Restricts node evaluation to times strictly after the given time.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
time
|
int
|
Lower time bound. |
required |
Returns:
| Type | Description |
|---|---|
|
filter.NodeViewPropsFilterBuilder |
at(time)
staticmethod
#
Restricts node evaluation to a single point in time.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
time
|
int
|
Event time. |
required |
Returns:
| Type | Description |
|---|---|
|
filter.NodeViewPropsFilterBuilder |
before(time)
staticmethod
#
Restricts node evaluation to times strictly before the given time.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
time
|
int
|
Upper time bound. |
required |
Returns:
| Type | Description |
|---|---|
|
filter.NodeViewPropsFilterBuilder |
by_state_column(state, col)
staticmethod
#
id()
staticmethod
#
Selects the node ID field for filtering.
Returns:
| Type | Description |
|---|---|
|
filter.NodeIdFilterBuilder |
is_active()
staticmethod
#
Matches nodes that have at least one event in the current view.
Returns:
| Type | Description |
|---|---|
|
filter.FilterExpr |
latest()
staticmethod
#
Evaluates filters against the latest available state of each node.
Returns:
| Type | Description |
|---|---|
|
filter.NodeViewPropsFilterBuilder |
layer(layer)
staticmethod
#
Restricts evaluation to nodes belonging to the given layer.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
layer
|
str
|
Layer name. |
required |
Returns:
| Type | Description |
|---|---|
|
filter.NodeViewPropsFilterBuilder |
layers(layers)
staticmethod
#
metadata(name)
staticmethod
#
Filters a node metadata field by name.
Metadata is shared across all temporal versions of a node.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
name
|
str
|
Metadata key. |
required |
Returns:
| Type | Description |
|---|---|
|
filter.FilterOps |
name()
staticmethod
#
Selects the node name field for filtering.
Returns:
| Type | Description |
|---|---|
|
filter.NodeNameFilterBuilder |
node_type()
staticmethod
#
Selects the node type field for filtering.
Returns:
| Type | Description |
|---|---|
|
filter.NodeTypeFilterBuilder |
property(name)
staticmethod
#
Filters a node property by name.
The property may be static or temporal depending on the query context.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
name
|
str
|
Property key. |
required |
Returns:
| Type | Description |
|---|---|
|
filter.PropertyFilterOps |
snapshot_at(time)
staticmethod
#
Evaluates filters against a snapshot of the graph at a given time.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
time
|
int
|
Snapshot time. |
required |
Returns:
| Type | Description |
|---|---|
|
filter.NodeViewPropsFilterBuilder |
snapshot_latest()
staticmethod
#
Evaluates filters against the most recent snapshot of the graph.
Returns:
| Type | Description |
|---|---|
|
filter.NodeViewPropsFilterBuilder |