org.semanticweb.elk.reasoner.saturation.rules.subsumers.EquivalentClassFirstFromSecondRule Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of elk-reasoner Show documentation
Show all versions of elk-reasoner Show documentation
The core ELK Reasoner package
package org.semanticweb.elk.reasoner.saturation.rules.subsumers;
/*
* #%L
* ELK Reasoner
* $Id:$
* $HeadURL:$
* %%
* Copyright (C) 2011 - 2013 Department of Computer Science, University of Oxford
* %%
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
* #L%
*/
import java.util.ArrayList;
import java.util.Collection;
import java.util.List;
import org.semanticweb.elk.owl.interfaces.ElkAxiom;
import org.semanticweb.elk.reasoner.indexing.model.IndexedClassExpression;
import org.semanticweb.elk.reasoner.indexing.model.IndexedEquivalentClassesAxiom;
import org.semanticweb.elk.reasoner.indexing.model.ModifiableIndexedEquivalentClassesAxiom;
import org.semanticweb.elk.reasoner.indexing.model.ModifiableOntologyIndex;
import org.semanticweb.elk.reasoner.saturation.conclusions.model.SubClassInclusion;
import org.semanticweb.elk.reasoner.saturation.context.ContextPremises;
import org.semanticweb.elk.reasoner.saturation.inferences.SubClassInclusionExpandedSecondEquivalentClass;
import org.semanticweb.elk.reasoner.saturation.rules.ClassInferenceProducer;
import org.semanticweb.elk.util.collections.chains.Chain;
import org.semanticweb.elk.util.collections.chains.Matcher;
import org.semanticweb.elk.util.collections.chains.ReferenceFactory;
import org.semanticweb.elk.util.collections.chains.SimpleTypeBasedMatcher;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
/**
*
* A {@link ChainableSubsumerRule} producing {@link SubClassInclusion} for the first
* member of {@link IndexedEquivalentClassesAxiom} when processing its second member
*
* @see IndexedEquivalentClassesAxiom#getFirstMember()
* @see IndexedEquivalentClassesAxiom#getSecondMember()
*
* @author "Yevgeny Kazakov"
*
*/
public class EquivalentClassFirstFromSecondRule extends AbstractChainableSubsumerRule {
// logger for events
private static final Logger LOGGER_ = LoggerFactory
.getLogger(EquivalentClassFirstFromSecondRule.class);
public static final String NAME = "EquivalentClasses First from Second";
private final List firstEquivalentMembers_;
private final List reasons_;
EquivalentClassFirstFromSecondRule(ChainableSubsumerRule tail) {
super(tail);
this.firstEquivalentMembers_ = new ArrayList(1);
this.reasons_ = new ArrayList(1);
}
EquivalentClassFirstFromSecondRule(IndexedClassExpression ice, ElkAxiom reason) {
this(null);
this.firstEquivalentMembers_.add(ice);
this.reasons_.add(reason);
}
public static boolean addRuleFor(ModifiableIndexedEquivalentClassesAxiom axiom,
ModifiableOntologyIndex index, ElkAxiom reason) {
return index.add(axiom.getSecondMember(), new EquivalentClassFirstFromSecondRule(
axiom.getFirstMember(), reason));
}
public static boolean removeRuleFor(ModifiableIndexedEquivalentClassesAxiom axiom,
ModifiableOntologyIndex index, ElkAxiom reason) {
return index.remove(axiom.getSecondMember(),
new EquivalentClassFirstFromSecondRule(axiom.getFirstMember(), reason));
}
@Deprecated
public Collection getFirstEquivalentMembers() {
return firstEquivalentMembers_;
}
/**
*
* @param firstMember
* the {@link IndexedClassExpression} for which to find the
* {@link ElkAxiom}
* @return the {@link ElkAxiom} that is responsible for the given first
* equivalent member or {@code null} if such an axiom does not exist
*/
public ElkAxiom getReasonForEquivalentMember(IndexedClassExpression firstMember) {
for (int i = 0; i < firstEquivalentMembers_.size(); i++) {
if (firstMember == firstEquivalentMembers_.get(i)) {
return reasons_.get(i);
}
}
// not found
return null;
}
@Override
public String toString() {
return NAME;
}
@Override
public void apply(IndexedClassExpression premise, ContextPremises premises,
ClassInferenceProducer producer) {
for (int i = 0; i < firstEquivalentMembers_.size(); i++) {
producer.produce(new SubClassInclusionExpandedSecondEquivalentClass(premises.getRoot(),
premise, firstEquivalentMembers_.get(i), reasons_.get(i)));
}
}
@Override
public boolean isTracingRule() {
return true;
}
@Override
public boolean addTo(Chain ruleChain) {
if (isEmpty())
return true;
EquivalentClassFirstFromSecondRule rule = ruleChain.getCreate(
EquivalentClassFirstFromSecondRule.MATCHER_,
EquivalentClassFirstFromSecondRule.FACTORY_);
boolean success = true;
int added = 0;
for (int i = 0; i < firstEquivalentMembers_.size(); i++) {
IndexedClassExpression subsumer = firstEquivalentMembers_.get(i);
ElkAxiom reason = reasons_.get(i);
if (LOGGER_.isTraceEnabled()) {
LOGGER_.trace("{}: adding to {} reason: {}", subsumer, NAME,
reason);
}
if (rule.firstEquivalentMembers_.add(subsumer)) {
rule.reasons_.add(reason);
added++;
} else {
success = false;
break;
}
}
if (success) {
return true;
}
// else revert all changes
for (int i = 0; i < firstEquivalentMembers_.size(); i++) {
if (added == 0)
break;
added--;
IndexedClassExpression subsumer = firstEquivalentMembers_.get(i);
ElkAxiom reason = reasons_.get(i);
if (LOGGER_.isTraceEnabled()) {
LOGGER_.trace("{}: removing from {} reason: {} [revert]", subsumer,
NAME, reason);
}
int j = rule.indexOf(subsumer, reason);
rule.firstEquivalentMembers_.remove(j);
rule.reasons_.remove(j);
}
return false;
}
@Override
public boolean removeFrom(Chain ruleChain) {
if (isEmpty())
return true;
EquivalentClassFirstFromSecondRule rule = ruleChain
.find(EquivalentClassFirstFromSecondRule.MATCHER_);
if (rule == null)
return false;
// else
boolean success = true;
int removed = 0;
for (int i = 0; i < firstEquivalentMembers_.size(); i++) {
IndexedClassExpression subsumer = firstEquivalentMembers_.get(i);
ElkAxiom reason = reasons_.get(i);
if (LOGGER_.isTraceEnabled()) {
LOGGER_.trace("{}: removing from {} reason: {}", subsumer,
NAME, reason);
}
int j = rule.indexOf(subsumer, reason);
if (j >= 0) {
rule.firstEquivalentMembers_.remove(j);
rule.reasons_.remove(j);
removed++;
} else {
success = false;
break;
}
}
if (success) {
if (rule.isEmpty()) {
ruleChain.remove(EquivalentClassFirstFromSecondRule.MATCHER_);
LOGGER_.trace("{}: removed ", NAME);
}
return true;
}
// else revert all changes
for (int i = 0; i < firstEquivalentMembers_.size(); i++) {
if (removed == 0)
break;
removed--;
IndexedClassExpression subsumer = firstEquivalentMembers_.get(i);
ElkAxiom reason = reasons_.get(i);
if (LOGGER_.isTraceEnabled()) {
LOGGER_.trace("{}: adding to {} reason: {} [revert]", subsumer,
NAME, reason);
}
rule.firstEquivalentMembers_.add(subsumer);
rule.reasons_.add(reason);
}
return false;
}
private int indexOf(IndexedClassExpression subsumer, ElkAxiom reason) {
for (int i = 0; i < firstEquivalentMembers_.size(); i++) {
if (firstEquivalentMembers_.get(i).equals(subsumer)
&& reasons_.get(i).equals(reason))
return i;
}
// else not found
return -1;
}
@Override
public void accept(LinkedSubsumerRuleVisitor visitor,
IndexedClassExpression premise, ContextPremises premises,
ClassInferenceProducer producer) {
visitor.visit(this, premise, premises, producer);
}
/**
* @return {@code true} if this rule never does anything
*/
protected boolean isEmpty() {
return firstEquivalentMembers_.isEmpty();
}
private static final Matcher MATCHER_ = new SimpleTypeBasedMatcher(
EquivalentClassFirstFromSecondRule.class);
private static final ReferenceFactory FACTORY_ = new ReferenceFactory() {
@Override
public EquivalentClassFirstFromSecondRule create(ChainableSubsumerRule tail) {
return new EquivalentClassFirstFromSecondRule(tail);
}
};
}