def merge_nodes(self, n1, n2, node_id=None):
"""Merge two nodes of the graph."""
# Update graphs
new_name = None
p_keys_1 = keys_by_value(self.p_lhs, n1)
p_keys_2 = keys_by_value(self.p_lhs, n2)
nodes_to_merge = set()
for k1 in p_keys_1:
if k1 not in self.p.nodes():
raise RuleError(
"Node with the id '%s' does not exist in the "
"preserved part of the rule" % k1
)
for k2 in p_keys_2:
if k2 not in self.p.nodes():
raise RuleError(
"Node with the id '%s' does not exist in "
"the preserved part of the rule" % k2
)
nodes_to_merge.add(self.p_rhs[k1])
nodes_to_merge.add(self.p_rhs[k2])
new_name = primitives.merge_nodes(
self.rhs,
list(nodes_to_merge),
node_id=node_id
)
# Update mappings
keys = p_keys_1 + p_keys_2
for k in keys:
self.p_rhs[k] = new_name
return new_name
def inject_add_edge(self, n1, n2, attrs=None):
"""Inject addition of a new edge to the rule.
This method adds an edge between two nodes of the
`rhs`.
Parameters
----------
n1 : hashable
Id of an edge's source node in `rhs`.
n2 : hashable
Id of an edge's target node in `rhs`.
Raises
------
RuleError
If some of the nodes (`n1` or `n2`) do not exist
or if there is already an edge between them in `rhs`.
"""
if n1 not in self.rhs.nodes():
raise RuleError(
"Node with the id '%s' does not exist in the "
"right-hand side of the rule" % n1)
if n2 not in self.rhs.nodes():
raise RuleError(
"Node with the id '%s' does not exist in the "
"right-hand side of the rule" % n2)
if (n1, n2) in self.rhs.edges():
raise RuleError(
"Edge '%s->%s' already exists in the right-"
"hand side of the rule" %
(n1, n2)
)
primitives.add_edge(self.rhs, n1, n2, attrs)
return
def inject_update_node_attrs(self, n, attrs):
"""Inject an update of node attrs by the rule.
Parameters
----------
n : hashable
Id of a node from the left-hand side whose attrs
should be updated
attrs : dict
Dictionary of new attrs that will replace the old ones
Raises
------
RuleError
If node `n` does not exist in the left-hand side or
is being removed by the rule.
"""
if n not in self.lhs.nodes():
raise RuleError(
"Node '%s' does not exist in the left hand "
"side of the rule" % n)
p_keys = keys_by_value(self.p_lhs, n)
if len(p_keys) == 0:
raise RuleError(
"Node '%s' is being removed by the rule, "
"cannot update attributes" % n)
for k in p_keys:
self.p.node[k] = None
primitives.update_node_attrs(self.rhs, self.p_rhs[k], attrs)
return
def add_node(self, node_id, attrs=None):
"""Add node to the graph.
Parameters
----------
node_id : hashable
Id of a node to add
attrs : dict, optional
Attributes of the node.
Raises
------
RuleError
If node with this id already exists in the `rhs`.
"""
if node_id not in self.rhs.nodes():
p_keys = keys_by_value(self.p_rhs, node_id)
# here we check for the nodes with the same name in the lhs
for k in p_keys:
lhs_key = self.p_lhs[k]
if lhs_key == node_id:
raise RuleError(
"Node with the id '%s' already exists in the "
"left hand side of the rule" %
node_id
)
primitives.add_node(self.rhs, node_id, attrs)
else:
raise RuleError(
"Node with the id '%s' already exists in the "
"right hand side of the rule" %
node_id
)
def merge_nodes_rhs(self, n1, n2, new_name):
"""Merge3 nodes in rhs."""
if n1 not in self.rhs.nodes():
raise RuleError("Node '%s' is not a node of the rhs" % n1)
if n2 not in self.rhs.nodes():
raise RuleError("Node '%s' is not a node of the rhs" % n2)
primitives.merge_nodes(self.rhs, [n1, n2], node_id=new_name)
for (source, target) in self.p_rhs.items():
if target == n1 or target == n2:
self.p_rhs[source] = new_name
def add_node_attrs(self, n, attrs):
"""Add node attributes to a node in the graph."""
if n not in self.lhs.nodes():
raise RuleError(
"Node '%s' does not exist in the left "
"hand side of the rule" % n)
p_keys = keys_by_value(self.p_lhs, n)
if len(p_keys) == 0:
raise RuleError(
"Node '%s' is being removed by the rule, "
"cannot add attributes" % n)
for k in p_keys:
primitives.add_node_attrs(self.rhs, self.p_rhs[k], attrs)
return
def inject_remove_edge(self, n1, n2):
"""Inject removal of an edge by the rule.
Parameters
----------
n1 : hashable
Id of an edge's source node in `lhs`.
n2 : hashable
Id of an edge's target node in `lhs`.
Raises
------
RuleError
If some of the nodes are not found in neither
`lhs` nor `p`, or if a corresponding edge in
`p` does not exist.
"""
# Find nodes in p mapping to n1 & n2
p_keys_1 = keys_by_value(self.p_lhs, n1)
p_keys_2 = keys_by_value(self.p_lhs, n2)
# n1 is actually a node from `p`
if len(p_keys_1) == 0:
if n1 in self.p.nodes():
p_keys_1 = [n1]
else:
raise RuleError(
"Node '%s' is not found in neither left-hand "
"side nor preserved part" % n2)
if len(p_keys_2) == 0:
if n2 in self.p.nodes():
p_keys_2 = [n2]
else:
raise RuleError(
"Node '%s' is not found in neither left-hand "
"side nor preserved part" % str(n2))
for k1 in p_keys_1:
for k2 in p_keys_2:
if (k1, k2) in self.p.edges():
primitives.remove_edge(self.p, k1, k2)
primitives.remove_edge(self.rhs, self.p_rhs[k1], self.p_rhs[k2])
else:
raise RuleError(
"Edge '%s->%s' does not exist in the preserved part"
% (k1, k2))
return
def add_node_attrs_rhs(self, n, attrs):
"""Add attrs to a node in the rhs."""
if n not in self.rhs.nodes():
raise RuleError(
"Node %s does not exist in the right "
"hand side of the rule" % n)
primitives.add_node_attrs(self.rhs, n, attrs)
def update_node_attrs(self, n, attrs):
"""Update attributes of a node."""
if n not in self.lhs.nodes():
raise RuleError(
"Node '%s' does not exist in the left hand "
"side of the rule" % n)
p_keys = keys_by_value(self.p_lhs, n)
if len(p_keys) == 0:
raise RuleError(
"Node '%s' is being removed by the rule, "
"cannot update attributes" % n)
for k in p_keys:
self.p.node[k] = None
primitives.update_node_attrs(self.rhs, self.p_rhs[k], attrs)
return
def inject_add_node(self, node_id, attrs=None):
"""Inject an addition of a new node by the rule.
This method adds a node with `node_id` (and the specified
attributes `attrs`) to `rhs`.
Parameters
----------
node_id : hashable
Id of a node to add
attrs : dict, optional
Attributes of the node.
Raises
------
RuleError
If node with this id already exists in the `rhs`.
"""
if node_id not in self.rhs.nodes():
primitives.add_node(self.rhs, node_id, attrs)
else:
raise RuleError(
"Node with the id '%s' already exists in the "
"right hand side of the rule" %
node_id
)
def remove_node_attrs_p(self, n, attrs):
"""Remove attrs of a node in the p."""
if n not in self.p.nodes():
raise RuleError(
"Node '%s' does not exist in the preserved "
"part of the rule" % n)
primitives.remove_node_attrs(self.p, n, attrs)
def clone_rhs_node(self, node, new_name=None):
"""Clone an rhs node."""
if node not in self.rhs.nodes():
raise RuleError(
"Node '%s' is not a node of right hand side" %
node
)
p_keys = keys_by_value(self.p_rhs, node)
if len(p_keys) == 0:
primitives.clone_node(self.rhs, node, new_name)
elif len(p_keys) == 1:
primitives.clone_node(self.rhs, node, new_name)
new_p_node = primitives.clone_node(self.p, p_keys[0])
self.p_rhs[new_p_node] = new_name
self.p_lhs[new_p_node] = self.p_lhs[p_keys[0]]
else:
raise RuleError("Cannot clone node that is result of merge!")
def _add_node_attrs_lhs(self, n, attrs):
if n not in self.lhs.nodes():
raise RuleError(
"Node '%s' does not exist in the lhs "
"of the rule" % n)
primitives.add_node_attrs(self.lhs, n, attrs)
p_nodes = keys_by_value(self.p_rhs, n)
for p_node in p_nodes:
primitives.add_node_attrs(self.p, p_node, attrs)
def inject_remove_node_attrs(self, n, attrs):
"""Inject a removal of node attrs by the rule.
First, tries to find a node with the id `n` in the
left-hand side, injects its attrs removal if found,
otherwise, tries to find the corresponding node in
the preserved part (it helps us to implement injection
of the node attrs removal to only one of the clone nodes).
Parameters
----------
n : hashable
Id of a node whose attrs to remove (node from the
left-hand side or the preserved part).
attrs : dict
Dictionary with attributes to remove.
Raises
------
RuleError
If `n` does not exist in neither the left-hand side
nor the preserved part of the rule, or when the node
whose attrs should be removed is itself is being removed
by the rule.
"""
if n not in self.lhs.nodes() and n not in self.p.nodes():
raise RuleError(
"Node '%s' exists in neither the left "
"hand side of the rule nor the preserved part" % n)
if n in self.lhs.nodes():
p_keys = keys_by_value(self.p_lhs, n)
if len(p_keys) == 0:
raise RuleError(
"Node '%s' is being removed by the rule, "
"cannot remove attributes" % n)
else:
p_keys = [n]
for k in p_keys:
primitives.remove_node_attrs(self.p, k, attrs)
primitives.remove_node_attrs(self.rhs, self.p_rhs[k], attrs)
return
def remove_node_attrs_rhs(self, n, attrs):
"""Remove attrs of a node in the rhs."""
if n not in self.rhs.nodes():
raise RuleError(
"Node '%s' does not exist in the right hand "
"side of the rule" % n)
p_keys = keys_by_value(self.p_rhs, n)
for p_node in p_keys:
primitives.remove_node_attrs(self.p, p_node, attrs)
primitives.remove_node_attrs(self.rhs, n, attrs)
def _add_edge_lhs(self, source, target, attrs=None):
if (source, target) not in self.lhs.edges():
if source in self.lhs.nodes() and target in self.rhs.nodes():
primitives.add_edge(self.lhs, source, target, attrs)
p_sources = keys_by_value(self.p_lhs, source)
p_targets = keys_by_value(self.p_lhs, target)
if len(p_sources) > 0 and len(p_targets) > 0:
for p_s in p_sources:
for p_t in p_targets:
primitives.add_edge(self.p, p_s, p_t, attrs)
primitives.add_edge(
self.rhs, self.p_rhs[p_s],
self.p_rhs[p_t], attrs)
else:
raise RuleError(
"Cannot add an edge between nodes '{}' and '{}': "
"one of the nodes does not exist".format(source, target))
else:
raise RuleError(
"Edge '{}'->'{}' already exists in the left-hand side "
"of the rule".format(source, target))
def inject_merge_nodes(self, node_list, node_id=None):
"""Inject merge of a collection of nodes by the rule.
Parameters
----------
node_list : iterable
Collection of ids of nodes from the preserved part or
the rhs to merge.
node_id : hashable
Id of the new node corresponding to the result of merge.
Returns
-------
new_name : hashable
Id of the new node corresponding to the result of merge.
Raises
------
RuleError
If a node with some id specified in `node_lust` does not
exist in the preserved part of the rule.
"""
# Update graphs
new_name = None
nodes_to_merge = set()
for n in node_list:
if n in self.p.nodes():
rhs_node = self.p_rhs[n]
elif n in self.rhs.nodes():
rhs_node = n
else:
raise RuleError(
"Node with the id '%s' does not exist in neither the "
"preserved part of the rule nor its rhs" % n
)
nodes_to_merge.add(rhs_node)
new_name = primitives.merge_nodes(
self.rhs,
list(nodes_to_merge),
node_id=node_id
)
# Update mappings
for n in node_list:
if n in self.p.nodes():
self.p_rhs[n] = new_name
for r_node in nodes_to_merge:
merged_ps = keys_by_value(self.p_rhs, r_node)
for p in merged_ps:
self.p_rhs[p] = new_name
return new_name
def add_edge(self, n1, n2, attrs=None):
"""Add an edge in the graph."""
# Find nodes in p mapping to n1 & n2
p_keys_1 = keys_by_value(self.p_lhs, n1)
p_keys_2 = keys_by_value(self.p_lhs, n2)
for k1 in p_keys_1:
if k1 not in self.p.nodes():
raise RuleError(
"Node with the id '%s' does not exist in the "
"preserved part of the rule" % k1
)
for k2 in p_keys_2:
if k2 not in self.p.nodes():
raise RuleError(
"Node with the id '%s' does not exist in the "
"preserved part of the rule" % k2
)
rhs_key_1 = self.p_rhs[k1]
rhs_key_2 = self.p_rhs[k2]
if self.rhs.is_directed():
if (rhs_key_1, rhs_key_2) in self.rhs.edges():
raise RuleError(
"Edge '%s->%s' already exists in the right "
"hand side of the rule" %
(rhs_key_1, rhs_key_2)
)
primitives.add_edge(self.rhs, rhs_key_1, rhs_key_2, attrs)
else:
if (rhs_key_1, rhs_key_2) in self.rhs.edges() or\
(rhs_key_2, rhs_key_1) in self.rhs.edges():
raise RuleError(
"Edge '%s->%s' already exists in the right "
"hand side of the rule" %
(rhs_key_1, rhs_key_2)
)
primitives.add_edge(self.rhs, rhs_key_1, rhs_key_2, attrs)
return
def _add_node_lhs(self, node_id, attrs=None):
if node_id not in self.lhs.nodes():
primitives.add_node(self.lhs, node_id, attrs)
new_p_node_id = node_id
if new_p_node_id in self.p.nodes():
new_p_node_id = primitives.unique_node_id(new_p_node_id)
primitives.add_node(self.p, new_p_node_id, attrs)
self.p_lhs[new_p_node_id] = node_id
new_rhs_node_id = node_id
if new_rhs_node_id in self.rhs.nodes():
new_rhs_node_id = primitives.unique_node_id(new_rhs_node_id)
primitives.add_node(self.rhs, new_rhs_node_id, attrs)
self.p_rhs[new_p_node_id] = new_rhs_node_id
else:
raise RuleError(
"Node '%s' already exists in the left-hand side "
"of the rule" % node_id)
def inject_add_node_attrs(self, n, attrs):
"""Inject addition of node attributes by the rule.
First, tries to find a node with the id `n` in the
left-hand side, injects its attrs add to all the `rhs` nodes
related to it through l<-p->r, if found,
otherwise, tries to find the corresponding node in
the preserved part and adds attrs to the node to which `n`
maps in p->r, if it is not found in `p`, tries to find it in
the `rhs` (it helps us to implement injection
of the node attrs add to only one of the clone nodes, or to new nodes,
or to merged nodes).
Parameters
----------
n1 : hashable
Id of an edge's source node in `lhs`, `p` or `rhs`.
n2 : hashable
Id of an edge's target node in `lhs`, `p` or `rhs`.
attrs : dict
Dictionary with attrs to add
Raises
------
RuleError
If node `n` does not exist in the rhs of the rule
"""
if n not in self.lhs.nodes() + self.p.nodes() + self.rhs.nodes():
raise RuleError(
"Node '%s' exists in neither lhs, nor p, nor rhs of the rule" %
n)
r_nodes = set()
if n in self.lhs.nodes():
p_keys = keys_by_value(self.p_lhs, n)
for p in p_keys:
r_nodes.add(self.p_rhs[p])
elif n in self.p.nodes():
r_nodes.add(self.p_rhs[n])
elif n in self.rhs.nodes():
r_nodes.add(n)
for r in r_nodes:
primitives.add_node_attrs(self.rhs, r, attrs)
return
def remove_edge(self, n1, n2):
"""Remove edge from the graph."""
# Find nodes in p mapping to n1 & n2
p_keys_1 = keys_by_value(self.p_lhs, n1)
p_keys_2 = keys_by_value(self.p_lhs, n2)
# Remove edge from the preserved part & rhs of the rule
for k1 in p_keys_1:
if k1 not in self.p.nodes():
raise RuleError(
"Node with the id '%s' does not exist in "
"the preserved part" % k1
)
for k2 in p_keys_2:
if k2 not in self.p.nodes():
raise RuleError(
"Node with the id '%s' does not exist in "
"the preserved part" % k2
)
rhs_key_1 = self.p_rhs[k1]
rhs_key_2 = self.p_rhs[k2]
if self.p.is_directed():
if (k1, k2) not in self.p.edges():
raise RuleError(
"Edge '%s->%s' does not exist in the preserved "
"part of the rule " % (k1, k2)
)
if (rhs_key_1, rhs_key_2) not in self.rhs.edges():
raise RuleError(
"Edge '%s->%s' does not exist in the right hand "
"side of the rule " % (rhs_key_1, rhs_key_2)
)
primitives.remove_edge(self.p, k1, k2)
primitives.remove_edge(self.rhs, rhs_key_1, rhs_key_2)
else:
if (k1, k2) not in self.p.edges() and\
(k2, k1) not in self.p.edges():
raise RuleError(
"Edge '%s->%s' does not exist in the "
"preserved part of the rule " % (k1, k2)
)
if (rhs_key_1, rhs_key_2) not in self.rhs.edges() and\
(rhs_key_2, rhs_key_1) not in self.rhs.edges():
raise RuleError(
"Edge '%s->%s' does not exist in the right "
"hand side of the rule " % (rhs_key_1, rhs_key_2)
)
primitives.remove_edge(self.p, k1, k2)
return
def update_edge_attrs(self, n1, n2, attrs):
"""Update the attributes of an edge with a new set `attrs`."""
if n1 not in self.lhs.nodes():
raise RuleError(
"Node '%s' does not exist in the left hand side of the rule" %
n1
)
if n2 not in self.lhs.nodes():
raise RuleError(
"Node '%s' does not exist in the left hand side of the rule" %
n2
)
normalize_attrs(attrs)
if self.lhs.is_directed():
if (n1, n2) not in self.lhs.edges():
raise RuleError(
"Edge '%s->%s' does not exist in the left hand "
"side of the rule" % (n1, n2)
)
p_keys_1 = keys_by_value(self.p_lhs, n1)
p_keys_2 = keys_by_value(self.p_lhs, n2)
if len(p_keys_1) == 0:
raise RuleError(
"Node '%s' is being removed by the rule, cannot update "
"attributes from the incident edge" %
n2
)
if len(p_keys_2) == 0:
raise RuleError(
"Node '%s' is being removed by the rule, cannot update "
"attributes from the incident edge" %
n1
)
for k1 in p_keys_1:
for k2 in p_keys_2:
self.p.edge[k1][k2] = None
primitives.update_edge_attrs(
self.rhs,
self.p_rhs[k1],
self.p_rhs[k2],
attrs
)
else:
if (n1, n2) not in self.lhs.edges() and\
(n2, n1) not in self.lhs.edges():
raise RuleError(
"Edge '%s->%s' does not exist in the "
"left hand side of the rule" %
(n1, n2)
)
p_keys_1 = keys_by_value(self.p_lhs, n1)
p_keys_2 = keys_by_value(self.p_lhs, n2)
if len(p_keys_1) == 0:
raise RuleError(
"Node '%s' is being removed by the rule, cannot update "
"attributes from the incident edge" %
n1
)
if len(p_keys_2) == 0:
raise RuleError(
"Node '%s' is being removed by the rule, cannot update "
"attributes from the incident edge" %
n2
)
for k1 in p_keys_1:
for k2 in p_keys_2:
self.p.edge[k1][k2] = None
primitives.update_edge_attrs(
self.rhs,
self.p_rhs[k1],
self.p_rhs[k2],
attrs
)
return
def remove_edge_attrs(self, n1, n2, attrs):
"""Remove edge attributes from an edge in the graph."""
if n1 not in self.lhs.nodes():
raise RuleError(
"Node '%s' does not exist in the left "
"hand side of the rule" % n1
)
if n2 not in self.lhs.nodes():
raise RuleError(
"Node '%s' does not exist in the left "
"hand side of the rule" % n2
)
normalize_attrs(attrs)
if self.lhs.is_directed():
if (n1, n2) not in self.lhs.edges():
raise RuleError(
"Edge '%s->%s' does not exist in the left "
"hand side of the rule" %
(n1, n2)
)
p_keys_1 = keys_by_value(self.p_lhs, n1)
p_keys_2 = keys_by_value(self.p_lhs, n2)
if len(p_keys_1) == 0:
raise RuleError(
"Node '%s' is being removed by the rule, cannot remove "
"attributes from the incident edge" %
n1
)
if len(p_keys_2) == 0:
raise RuleError(
"Node '%s' is being removed by the rule, cannot remove "
"attributes from the incident edge" %
n2
)
for k1 in p_keys_1:
for k2 in p_keys_2:
primitives.remove_edge_attrs(self.p, k1, k2, attrs)
primitives.remove_edge_attrs(
self.rhs,
self.p_rhs[k1],
self.p_rhs[k2],
attrs
)
else:
if (n1, n2) not in self.lhs.edges() and\
(n2, n1) not in self.lhs.edges():
raise RuleError(
"Edge '%s->%s' does not exist in the left hand "
"side of the rule" % (n1, n2)
)
p_keys_1 = keys_by_value(self.p_lhs, n1)
p_keys_2 = keys_by_value(self.p_lhs, n2)
if len(p_keys_1) == 0:
raise RuleError(
"Node '%s' is being removed by the rule, cannot remove "
"attributes from the incident edge" %
n1
)
if len(p_keys_2) == 0:
raise RuleError(
"Node '%s' is being removed by the rule, cannot remove "
"attributes from the incident edge" %
n2
)
for k1 in p_keys_1:
for k2 in p_keys_2:
primitives.remove_edge_attrs(
self.p,
k1,
k2,
attrs
)
primitives.remove_edge_attrs(
self.rhs,
self.p_rhs[k1],
self.p_rhs[k2],
attrs
)
return
def inject_clone_node(self, n, new_node_id=None):
"""Inject cloning of a node by the rule.
This procedure clones `n` in the preserved part
and the right-hand side.
Parameters
----------
n : hashable
Node from `lhs` to clone
new_node_id : hashable
Id for the clone
Returns
-------
p_new_node_id : hashable
Id of the new clone node in the preserved part
rhs_new_node_id : hashable
Id of the new clone node in the right-hand side
Raises
------
RuleError
If the node to clone is already being removed by the rule
or if node with the specified clone id already exists in p.
"""
p_nodes = keys_by_value(self.p_lhs, n)
if len(p_nodes) == 0:
raise RuleError(
"Cannot inject cloning: node '%s' is already "
"being removed by the rule, revert its removal "
"first" % n)
else:
if new_node_id is not None and new_node_id in self.p.nodes():
raise RuleError(
"Node with id '%s' already exists in the "
"preserved part!")
some_p_node = p_nodes[0]
p_new_node_id = primitives.clone_node(
self.p, some_p_node, new_node_id)
self.p_lhs[p_new_node_id] = n
# add it to the rhs
# generate a new id for rhs
rhs_new_node_id = p_new_node_id
if rhs_new_node_id in self.rhs.nodes():
rhs_new_node_id = primitives.unique_node_id(
self.rhs, rhs_new_node_id)
primitives.add_node(
self.rhs, rhs_new_node_id, self.p.node[p_new_node_id])
self.p_rhs[p_new_node_id] = rhs_new_node_id
# reconnect the new rhs node with necessary edges
for pred in self.p.predecessors(p_new_node_id):
if (self.p_rhs[pred], rhs_new_node_id) not in self.rhs.edges():
primitives.add_edge(
self.rhs,
self.p_rhs[pred], rhs_new_node_id,
self.p.edge[pred][p_new_node_id])
for suc in self.p.successors(p_new_node_id):
if (rhs_new_node_id, self.p_rhs[suc]) not in self.rhs.edges():
primitives.add_edge(
self.rhs,
rhs_new_node_id, self.p_rhs[suc],
self.p.edge[p_new_node_id][suc])
return (p_new_node_id, rhs_new_node_id)
def inject_remove_edge_attrs(self, n1, n2, attrs):
"""Inject a removal of edge attrs by the rule.
For both `n1` and `n2`, first, tries to find
a node with this id in the left-hand side,
injects the removal of the respective edge attrs if found,
otherwise, tries to find the corresponding node in
the preserved part (it helps us to implement injection
of the edge attrs removal to only one of the edges
incident to the clone).
Parameters
----------
n1 : hashable
Id of an edge's source node in `lhs` or `p`.
n2 : hashable
Id of an edge's target node in `lhs` or `p`.
attrs : dict
Dictionary with attributes to remove.
Raises
------
RuleError
"""
if n1 not in self.lhs.nodes() and n1 not in self.p.nodes():
raise RuleError(
"Node '%s' exists in neither the left "
"hand side of the rule nor the preserved part" % n1
)
if n2 not in self.lhs.nodes() and n2 not in self.p.nodes():
raise RuleError(
"Node '%s' exists in neither the left "
"hand side of the rule nor the preserved part" % n2
)
if n1 in self.lhs.nodes():
p_keys_1 = keys_by_value(self.p_lhs, n1)
if len(p_keys_1) == 0:
raise RuleError(
"Node '%s' is being removed by the rule, cannot remove "
"attributes from the incident edge" %
n1
)
else:
p_keys_1 = [n1]
if n2 in self.lhs.nodes():
p_keys_2 = keys_by_value(self.p_lhs, n2)
if len(p_keys_2) == 0:
raise RuleError(
"Node '%s' is being removed by the rule, cannot remove "
"attributes from the incident edge" %
n2
)
else:
p_keys_2 = [n2]
for k1 in p_keys_1:
for k2 in p_keys_2:
if self.p.is_directed():
if (k1, k2) not in self.p.edges():
raise RuleError(
"Edge '%s->%s' does not exist in the preserved "
"part of the rule" %
(k1, k2)
)
else:
if (k1, k2) not in self.p.edges() and\
(k2, k1) not in self.p.edges():
raise RuleError(
"Edge '%s->%s' does not exist in the preserved "
"part of the rule" % (k1, k2)
)
primitives.remove_edge_attrs(self.p, k1, k2, attrs)
primitives.remove_edge_attrs(
self.rhs, self.p_rhs[k1], self.p_rhs[k2], attrs)
return
def inject_add_edge_attrs(self, n1, n2, attrs):
"""Inject addition of edge attributes by the rule.
For `n1` and `n2`, first, tries to find a node with this id in the
left-hand side, finds a node from `rhs` related to it through
l<-p->r, if found, otherwise, tries to find the corresponding node in
the preserved part and finds the node to which `n` maps in p->r,
if it is not found in `p`, tries to find it in
the `rhs` (it helps us to implement injection
of the edge attrs add to only one of the edges incident to clones,
or to new edges, or to edges produced by merges).
Parameters
----------
n1 : hashable
n2 : hashable
attrs : dict
Dictionary with attrs to add
Raises
------
RuleError
If some of the nodes defining an edge are not found in neither
`lhs`, nor `p` nor `rhs`, or if an edge is incident to smth thats
is going to be removed by the rule.
"""
if n1 not in self.lhs.nodes() + self.rhs.nodes() + self.p.nodes():
raise RuleError(
"Node '%s' exists in neither lhs, nor p, nor rhs "
"of the rule" % n1
)
if n2 not in self.lhs.nodes() + self.rhs.nodes() + self.p.nodes():
raise RuleError(
"Node '%s' exists in neither lhs, nor p, nor rhs "
"of the rule" % n2
)
if n1 in self.lhs.nodes():
p_keys = keys_by_value(self.p_lhs, n1)
if len(p_keys) == 0:
raise RuleError(
"Node '%s' is being removed by the rule, cannot add "
"attributes to the incident edge" %
n1
)
rhs_keys_1 = [self.p_rhs[p] for p in p_keys]
elif n1 in self.p.nodes():
rhs_keys_1 = [self.p_rhs[n1]]
elif n1 in self.rhs.nodes():
rhs_keys_1 = [n1]
if n2 in self.lhs.nodes():
p_keys = keys_by_value(self.p_lhs, n2)
if len(p_keys) == 0:
raise RuleError(
"Node '%s' is being removed by the rule, cannot add "
"attributes to the incident edge" %
n2
)
rhs_keys_2 = [self.p_rhs[p] for p in p_keys]
elif n2 in self.p.nodes():
rhs_keys_2 = [self.p_rhs[n2]]
elif n2 in self.rhs.nodes():
rhs_keys_2 = [n2]
for r1 in rhs_keys_1:
for r2 in rhs_keys_2:
if self.rhs.is_directed() and (r1, r2) not in self.rhs.edges():
raise RuleError(
"Edge '%s->%s' does not exist in the right "
"hand side of the rule" %
(r1, r2))
elif (r1, r2) not in self.rhs.edges() and\
(r2, r1) not in self.rhs.edges():
raise RuleError(
"Edge '%s->%s' does not exist in the right "
"hand side of the rule" %
(r1, r2)
)
primitives.add_edge_attrs(
self.rhs, r1, r2, attrs)
return
