org.semanticweb.elk.reasoner.completeness.OccurrencesInOntology 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
The core ELK Reasoner package
The newest version!
package org.semanticweb.elk.reasoner.completeness;

/*-
 * #%L
 * ELK Reasoner Core
 * $Id:$
 * $HeadURL:$
 * %%
 * Copyright (C) 2011 - 2020 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.Collections;
import java.util.EnumMap;
import java.util.Iterator;
import java.util.LinkedHashSet;
import java.util.Map;
import java.util.Set;

import org.semanticweb.elk.owl.interfaces.ElkAxiom;
import org.semanticweb.elk.owl.printers.OwlFunctionalStylePrinter;
import org.semanticweb.elk.owl.visitors.ElkAxiomProcessor;
import org.slf4j.Logger;

/**
 * An {@link OccurrenceManager} that provides information about occurrences of
 * {@link Feature}s in the current ontology of the reasoner.
 * 
 * @author Yevgeny Kazakov
 */
public class OccurrencesInOntology
		implements ElkAxiomProcessor, OccurrenceListener, OccurrenceManager {

	/**
	 * the default maximal number of recent occurrences to keep track of
	 */
	private static int DEFAULT_RECENT_OCCURRENCE_LIMIT_ = 3;

	private final OccurrenceRegistry occurrenceRegistry_ = new OccurrenceRegistry();

	private final Map> recentOccurrences_ = new EnumMap<>(
			Feature.class);

	/**
	 * the maximal number of recent occurrences to keep track of
	 */
	private final int recentOccurrenceLimit_;

	/**
	 * the axiom, changes in occurrences of which are notified by
	 * {@link #occurrenceChanged(Feature, int)}
	 */
	private ElkAxiom currentAxiom_;

	public OccurrencesInOntology() {
		this(DEFAULT_RECENT_OCCURRENCE_LIMIT_);
	}

	OccurrencesInOntology(int recentOccurrenceLimit) {
		this.recentOccurrenceLimit_ = recentOccurrenceLimit;
	}

	@Override
	public void visit(ElkAxiom elkAxiom) {
		currentAxiom_ = elkAxiom;
	}

	@Override
	public void occurrenceChanged(Feature occurrence, int increment) {
		occurrenceRegistry_.occurrenceChanged(occurrence, increment);
		Set recent = recentOccurrences_.get(occurrence);
		if (recent == null) {
			recent = new LinkedHashSet(recentOccurrenceLimit_);
			recentOccurrences_.put(occurrence, recent);
		}
		if (increment > 0) {
			recent.add(currentAxiom_);
			if (recent.size() > recentOccurrenceLimit_) {
				// removing the oldest element
				Iterator i = recent.iterator();
				i.next();
				i.remove();
			}
		} else {
			recent.remove(currentAxiom_);
			if (recent.isEmpty()) {
				recentOccurrences_.remove(occurrence);
			}
		}
	}

	@Override
	public int getOccurrenceCount(Feature occurrence) {
		return occurrenceRegistry_.getOccurrenceCount(occurrence);
	}

	Set getRecentOccurrences(Feature occurrence) {
		Set result = recentOccurrences_.get(occurrence);
		if (result != null) {
			return result;
		}
		// else
		return Collections.emptySet();
	}

	@Override
	public void logOccurrences(Feature occurrence, Logger logger) {
		int count = getOccurrenceCount(occurrence);
		if (count == 0) {
			return;
		}
		String occurrencesString = count == 1 ? "occurrence" : "occurrences";
		String polarityString = "";
		switch (occurrence.getPolarity()) {
		case POSITIVE:
			polarityString = "positive ";
			break;
		case NEGATIVE:
			polarityString = "negative ";
		default:
			break;
		}
		logger.info(
				"{} {}{} of {} found in the current ontology. Enable DEBUG for details",
				count, polarityString, occurrencesString,
				occurrence.getConstructor());
		if (logger.isDebugEnabled()) {
			Set axioms = getRecentOccurrences(occurrence);
			for (ElkAxiom axiom : axioms) {
				logger.debug(OwlFunctionalStylePrinter.toString(axiom));
			}
			if (count > axioms.size()) {
				logger.debug("...");
			}
		}
		recentOccurrences_.remove(occurrence);
	}

	@Override
	public boolean hasNewOccurrencesOf(Feature occurrence) {
		return !getRecentOccurrences(occurrence).isEmpty();
	}

}