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