Edge
Entry point for constructing edge filter expressions.
The Edge filter provides:
- endpoint filters via
src()anddst(), - property and metadata filters,
- view restrictions (time windows, snapshots, layers),
- and structural predicates over edge state (active/valid/deleted/self-loop).
Methods
| Method | Description |
|---|---|
after | Restricts edge evaluation to times strictly after the given time. |
at | Restricts edge evaluation to a single point in time. |
before | Restricts edge evaluation to times strictly before the given time. |
dst | Selects the edge destination endpoint for filtering. |
is_active | Matches edges that have at least one event in the current view. |
is_deleted | Matches edges that have been deleted. |
is_self_loop | Matches edges that are self-loops (source == destination). |
is_valid | Matches edges that are structurally valid in the current view. |
latest | Evaluates edge predicates against the latest available edge state. |
layer | Restricts evaluation to edges belonging to the given layer. |
layers | Restricts evaluation to edges belonging to any of the given layers. |
metadata | Filters an edge metadata field by name. |
property | Filters an edge property by name. |
snapshot_at | Evaluates edge predicates against a snapshot of the graph at a given time. |
snapshot_latest | Evaluates edge predicates against the most recent snapshot of the graph. |
src | Selects the edge source endpoint for filtering. |
window | Restricts edge evaluation to the given time window. |
Method Details
after
Signature: after(time)
Restricts edge evaluation to times strictly after the given time.
Parameters
| Name | Type | Default | Description |
|---|---|---|---|
time | int | - | Lower time bound. |
at
Signature: at(time)
Restricts edge evaluation to a single point in time.
Parameters
| Name | Type | Default | Description |
|---|---|---|---|
time | int | - | Event time. |
before
Signature: before(time)
Restricts edge evaluation to times strictly before the given time.
Parameters
| Name | Type | Default | Description |
|---|---|---|---|
time | int | - | Upper time bound. |
dst
Selects the edge destination endpoint for filtering.
is_active
Matches edges that have at least one event in the current view.
is_deleted
Matches edges that have been deleted.
is_self_loop
Matches edges that are self-loops (source == destination).
is_valid
Matches edges that are structurally valid in the current view.
latest
Evaluates edge predicates against the latest available edge state.
layer
Signature: layer(layer)
Restricts evaluation to edges belonging to the given layer.
Parameters
| Name | Type | Default | Description |
|---|---|---|---|
layer | str | - | Layer name. |
layers
Signature: layers(layers)
Restricts evaluation to edges belonging to any of the given layers.
Parameters
| Name | Type | Default | Description |
|---|---|---|---|
layers | list[str] | - | Layer names. |
metadata
Signature: metadata(name)
Filters an edge metadata field by name.
Metadata is shared across all temporal versions of an edge.
Parameters
| Name | Type | Default | Description |
|---|---|---|---|
name | str | - | Metadata key. |
property
Signature: property(name)
Filters an edge 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 edge predicates against a snapshot of the graph at a given time.
Parameters
| Name | Type | Default | Description |
|---|---|---|---|
time | int | - | Snapshot time. |
snapshot_latest
Evaluates edge predicates against the most recent snapshot of the graph.
src
Selects the edge source endpoint for filtering.
window
Signature: window(start, end)
Restricts edge evaluation to the given time window.
The window is inclusive of start and exclusive of end.