fr.lirmm.graphik.integraal.rulesetanalyser.graph.MarkedVariableSet Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of integraal-graal-ruleset-analysis Show documentation
Show all versions of integraal-graal-ruleset-analysis Show documentation
Rule base analysis for InteGraal. This is imported from Graal
The newest version!
/*
* Copyright (C) Inria Sophia Antipolis - Méditerranée / LIRMM
* (Université de Montpellier & CNRS) (2014 - 2017)
*
* Contributors :
*
* Clément SIPIETER
* Mélanie KÖNIG
* Swan ROCHER
* Jean-François BAGET
* Michel LECLÈRE
* Marie-Laure MUGNIER
*
*
* This file is part of Graal .
*
* This software is governed by the CeCILL license under French law and
* abiding by the rules of distribution of free software. You can use,
* modify and/ or redistribute the software under the terms of the CeCILL
* license as circulated by CEA, CNRS and INRIA at the following URL
* "http://www.cecill.info".
*
* As a counterpart to the access to the source code and rights to copy,
* modify and redistribute granted by the license, users are provided only
* with a limited warranty and the software's author, the holder of the
* economic rights, and the successive licensors have only limited
* liability.
*
* In this respect, the user's attention is drawn to the risks associated
* with loading, using, modifying and/or developing or reproducing the
* software by the user in light of its specific status of free software,
* that may mean that it is complicated to manipulate, and that also
* therefore means that it is reserved for developers and experienced
* professionals having in-depth computer knowledge. Users are therefore
* encouraged to load and test the software's suitability as regards their
* requirements in conditions enabling the security of their systems and/or
* data to be ensured and, more generally, to use and operate it in the
* same conditions as regards security.
*
* The fact that you are presently reading this means that you have had
* knowledge of the CeCILL license and that you accept its terms.
*/
/**
*
*/
package fr.lirmm.graphik.integraal.rulesetanalyser.graph;
import java.util.Collection;
import java.util.HashMap;
import java.util.LinkedList;
import java.util.Map;
import java.util.Queue;
import java.util.Set;
import java.util.TreeSet;
import fr.lirmm.graphik.integraal.api.core.Atom;
import fr.lirmm.graphik.integraal.api.core.Predicate;
import fr.lirmm.graphik.integraal.api.core.Rule;
import fr.lirmm.graphik.integraal.api.core.Term;
import fr.lirmm.graphik.integraal.api.core.Variable;
import fr.lirmm.graphik.integraal.rulesetanalyser.util.PredicatePosition;
import fr.lirmm.graphik.util.stream.CloseableIteratorWithoutException;
/**
* The marked variable set is built from a rule set by the following marking
* procedure: (i) for each rule Ri and for each variable v occuring in its body,
* if v does not occur in all atoms of its head, mark (each occurrence of) v in
* its body; (ii) apply until a fixpoint is reached: for each rule Ri, if a
* marked variable v appears at position p[k] in its body, then for each rule Rj
* (including i = j) and for each variable x appearing at position p[k] in the
* head of Rj, mark each occurence of x in the body of Rj.
*
* @author Clément Sipieter (INRIA) {@literal }
* @author Swan Rocher
*
*/
public class MarkedVariableSet {
private LinkedList markedRuleSet;
private Map> map;
private Queue markedPosition;
public static class MarkedRule {
public MarkedRule(Rule rule) {
this.rule = rule;
this.markedVars = new TreeSet();
}
public Rule rule;
public Set markedVars;
}
// /////////////////////////////////////////////////////////////////////////
// CONSTRUCTOR
// /////////////////////////////////////////////////////////////////////////
public MarkedVariableSet(Iterable rules) {
this.markedPosition = new LinkedList();
this.markedRuleSet = new LinkedList();
for (Rule r : rules) {
this.markedRuleSet.add(new MarkedRule(r));
}
map = new HashMap>();
process();
}
// /////////////////////////////////////////////////////////////////////////
// PUBLIC METHODS
// /////////////////////////////////////////////////////////////////////////
public Collection getMarkedRuleCollection() {
return this.markedRuleSet;
}
// /////////////////////////////////////////////////////////////////////////
// PRIVATE METHODS
// /////////////////////////////////////////////////////////////////////////
private void process() {
firstStep();
secondStep();
}
/**
* for each rule Ri and for each variable v occuring in its body, if v does
* not occur in all atoms of its head, mark (each occurrence of) v in its
* body;
*/
private void firstStep() {
for (MarkedRule markedRule : this.markedRuleSet) {
// put rule in the map
CloseableIteratorWithoutException it = markedRule.rule.getHead().iterator();
while (it.hasNext()) {
Atom atom = it.next();
Predicate p = atom.getPredicate();
LinkedList set = map.get(p);
if (set == null) {
set = new LinkedList();
map.put(p, set);
}
set.add(markedRule);
}
// mark the rule
testRule(markedRule);
}
}
private void testRule(MarkedRule mrule) {
Set bodyVars = mrule.rule.getBody().getVariables();
for (Term v : bodyVars) {
CloseableIteratorWithoutException it = mrule.rule.getHead().iterator();
while (it.hasNext()) {
Atom a = it.next();
if (!a.getTerms().contains(v)) {
mark(v, mrule);
}
}
}
}
private void mark(Term v, MarkedRule mrule) {
if (!mrule.markedVars.contains(v)) {
mrule.markedVars.add(v);
CloseableIteratorWithoutException it = mrule.rule.getBody().iterator();
while (it.hasNext()) {
Atom a = it.next();
int i = 0;
for (Term t : a) {
if (v.equals(t)) {
this.markedPosition.add(new PredicatePosition(a
.getPredicate(), i));
}
++i;
}
}
}
}
/**
* apply until a fixpoint is reached: for each rule Ri, if a marked variable
* v appears at position p[k] in its body, then for each rule Rj (including
* i = j) and for each variable x appearing at position p[k] in the head of
* Rj, mark each occurence of x in the body of Rj.
*/
private void secondStep() {
LinkedList mrList;
PredicatePosition mpos;
Term v;
while (!this.markedPosition.isEmpty()) {
mpos = this.markedPosition.poll();
mrList = this.map.get(mpos.predicate);
if (mrList != null) {
for (MarkedRule mr : mrList) {
CloseableIteratorWithoutException it = mr.rule.getHead().iterator();
while (it.hasNext()) {
Atom a = it.next();
if (a.getPredicate().equals(mpos.predicate)) {
v = a.getTerm(mpos.position);
if (v.isVariable()) {
this.mark(v, mr);
}
}
}
}
}
}
}
}