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
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
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
NodeViewPropsFilterBuilder

by_state_column(state, col) staticmethod

Build a node filter from a boolean column of an existing node-state result.

Parameters:

Name	Type	Description	Default
state	OutputNodeState	A pre-computed node state (e.g. from an algorithm).	required
col	str	Name of the boolean column on state whose values determine inclusion.	required

Returns:

Type	Description
FilterExpr

degree() staticmethod

Selects total node degree for filtering.

Returns:

Type	Description
	filter.FilterOps

id() staticmethod

Selects the node ID field for filtering.

Returns:

Type	Description
NodeIdFilterBuilder

in_degree() staticmethod

Selects incoming node degree for filtering.

Returns:

Type	Description
	filter.FilterOps

is_active() staticmethod

Matches nodes that have at least one event in the current view.

Returns:

Type	Description
FilterExpr

latest() staticmethod

Evaluates filters against the latest available state of each node.

Returns:

Type	Description
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
NodeViewPropsFilterBuilder

layers(layers) staticmethod

Restricts evaluation to nodes belonging to any of the given layers.

Parameters:

Name	Type	Description	Default
layers	list[str]	Layer names.	required

Returns:

Type	Description
NodeViewPropsFilterBuilder

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
FilterOps

name() staticmethod

Selects the node name field for filtering.

Returns:

Type	Description
NodeNameFilterBuilder

node_type() staticmethod

Selects the node type field for filtering.

Returns:

Type	Description
NodeTypeFilterBuilder

out_degree() staticmethod

Selects outgoing node degree for filtering.

Returns:

Type	Description
	filter.FilterOps

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
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
NodeViewPropsFilterBuilder

snapshot_latest() staticmethod

Evaluates filters against the most recent snapshot of the graph.

Returns:

Type	Description
NodeViewPropsFilterBuilder

window(start, end) staticmethod

Restricts node evaluation to the given time window.

The window is inclusive of start and exclusive of end.

Parameters:

Name	Type	Description	Default
start	int	Start time.	required
end	int	End time.	required

Returns:

Type	Description
NodeViewPropsFilterBuilder