Slices

Slice management from annnet.core._Slices.

Use G.slices and the AnnNet slice methods for slice workflows. Direct imports from underscore modules follow the internal API policy.

annnet.core._Slices.SliceManager

Namespace for all slice operations, exposed as G.slices.

Attributes

active property writable

active

Currently active slice identifier.

Functions

add

add(slice_id, **attributes)

Create a new empty slice.

Parameters:

Name	Type	Description	Default
slice_id	str		required
**attributes	Any	Slice attributes.	{}

Returns:

Type	Description
str

remove

remove(slice_id)

Remove a non-default slice and its per-slice attributes.

Parameters:

Name	Type	Description	Default
slice_id	str		required

Raises:

Type	Description
ValueError	If attempting to remove the internal default slice.
KeyError	If the slice does not exist.

add_edge_to_slice

add_edge_to_slice(lid, eid)

Attach an existing edge to a slice (no weight changes).

Parameters:

Name	Type	Description	Default
lid	str		required
eid	str		required

Raises:

Type	Description
KeyError	If the slice or edge does not exist.

add_edges

add_edges(slice_id, edge_ids)

Attach many existing edges to a slice and include their incident nodes.

attach_edges

attach_edges(slice_id, edge_ids)

Attach every edge the graph holds to a slice, and derive no nodes.

Unlike :meth:add_edges, this keeps an edge that occupies no column, so a placeholder edge survives a round trip. It also leaves the node memberships alone. A reader that restores the node memberships from the file itself needs both, and deriving them again is the dearest loop of a load.

get_slices_dict

get_slices_dict(include_default=True)

Return the raw slice_id → SliceRecord mapping (distinct from list).

list

list(include_default=True)

Slice IDs as a list.

exists

exists(slice_id)

Return True if a slice exists.

count

count()

Return the number of registered slices.

info

info(slice_id)

Nodes, edges, and attributes of a slice.

attrs

attrs(slice_id)

Return every attribute of one slice.

A slice is a level of its own, so its attributes are held apart from the attributes of the nodes and the edges it holds.

nodes

nodes(slice_id)

Return a copy of the node IDs in a slice.

edges

edges(slice_id)

Return a copy of the edge IDs in a slice.

union

union(slice_ids)

Return the union of nodes and edges across multiple slices.

intersect

intersect(slice_ids)

Return the intersection of nodes and edges across multiple slices.

difference

difference(slice_a, slice_b)

Return the nodes and edges present in one slice but not another.

create_slice_from_operation

create_slice_from_operation(
    result_slice_id, operation_result, **attributes
)

Create a new slice from a precomputed membership result.

add_node_to_slice

add_node_to_slice(lid, vid)

Attach an existing node to a slice.

Raises:

Type	Description
KeyError	If the slice or node does not exist.

union_create

union_create(slice_ids, name, **attributes)

Create a slice from the union of existing slices.

intersect_create

intersect_create(slice_ids, name, **attributes)

Create a slice from the intersection of existing slices.

difference_create

difference_create(slice_a, slice_b, name, **attributes)

Create a slice from the difference of two slices.

aggregate

aggregate(
    source_slice_ids,
    target_slice_id,
    method="union",
    weight_func=None,
    **attributes
)

Build a target slice from sources via 'union' or 'intersection'.

stats

stats(include_default=True)

Return per-slice counts and attributes.

node_presence

node_presence(node_id, include_default=False)

List slices that contain a given node.

edge_presence

edge_presence(
    edge_id=None,
    source=None,
    target=None,
    *,
    include_default=False,
    undirected_match=None
)

Slices containing an edge by id, or by (source, target) endpoint pair.

hyperedge_presence

hyperedge_presence(
    *,
    members=None,
    head=None,
    tail=None,
    include_default=False
)

Slices containing a hyperedge by undirected members or directed head+tail.

conserved_edges

conserved_edges(min_slices=2, include_default=False)

Count edges that appear in at least min_slices slices.

specific_edges

specific_edges(slice_id)

Return edges that appear only in the given slice.

temporal_dynamics

temporal_dynamics(ordered_slices, metric='edge_change')

Summarize added and removed members across an ordered slice sequence.

summary

summary()

Return a compact human-readable summary of all slices.