org.semanticweb.HermiT.existentials.ExistentialExpansionStrategy Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of org.semanticweb.hermit Show documentation

HermiT is reasoner for ontologies written using the Web Ontology Language (OWL). Given an OWL file, HermiT can determine whether or not the ontology is consistent, identify subsumption relationships between classes, and much more. This is the maven build of HermiT and is designed for people who wish to use HermiT from within the OWL API. It is now versioned in the main HermiT version repository, although not officially supported by the HermiT developers. The version number of this package is a composite of the HermiT version and a value representing the OWLAPI release it is compatible with. Note that the group id for the upstream HermiT is com.hermit-reasoner, while this fork is released under net.sourceforge.owlapi. This fork exists to allow HermiT users to use newer OWLAPI versions than the ones supported by the original HermiT codebase. This package includes the Jautomata library (http://jautomata.sourceforge.net/), and builds with it directly. This library appears to be no longer under active development, and so a "fork" seems appropriate. No development is intended or anticipated on this code base.

The newest version!

/* Copyright 2008, 2009, 2010 by the Oxford University Computing Laboratory

   This file is part of HermiT.

   HermiT is free software: you can redistribute it and/or modify
   it under the terms of the GNU Lesser General Public License as published by
   the Free Software Foundation, either version 3 of the License, or
   (at your option) any later version.

   HermiT is distributed in the hope that it will be useful,
   but WITHOUT ANY WARRANTY; without even the implied warranty of
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
   GNU Lesser General Public License for more details.

   You should have received a copy of the GNU Lesser General Public License
   along with HermiT.  If not, see .
*/
package org.semanticweb.HermiT.existentials;

import java.util.List;

import org.semanticweb.HermiT.model.AtomicRole;
import org.semanticweb.HermiT.model.Concept;
import org.semanticweb.HermiT.model.DLClause;
import org.semanticweb.HermiT.model.DLOntology;
import org.semanticweb.HermiT.model.DataRange;
import org.semanticweb.HermiT.model.Variable;
import org.semanticweb.HermiT.tableau.DLClauseEvaluator;
import org.semanticweb.HermiT.tableau.Node;
import org.semanticweb.HermiT.tableau.Tableau;

/**
 * Strategy objects are responsible for selecting which existentials should be
 * expanded first, as well as how the new nodes are introduced. The latter is
 * usually delegated to tableau.ExistentialExpansionManager, but strategies
 * are free to provide their own node-introduction implementations
 * (but be careful---it's tough to get right!)
 */
public interface ExistentialExpansionStrategy {
    /**
     * @param tableau tableau
     */
    void initialize(Tableau tableau);
    /**
     * @param additionalDLOntology additionalDLOntology
     */
    void additionalDLOntologySet(DLOntology additionalDLOntology);
    /**
     * 
     */
    void additionalDLOntologyCleared();
    /**
     * Clear.
     */
    void clear();
    /**
     * @param finalChance finalChance
     * @return true if expanded
     */
    boolean expandExistentials(boolean finalChance);
    /**
     * @param concept concept
     * @param node node
     * @param isCore isCore
     */
    void assertionAdded(Concept concept,Node node,boolean isCore);
    /**
     * @param dataRange data range
     * @param node node
     * @param isCore is core
     */
    void assertionAdded(DataRange dataRange,Node node,boolean isCore);
    /**
     * @param concept concept
     * @param node node
     */
    void assertionCoreSet(Concept concept,Node node);
    /**
     * @param dataRange data range
     * @param node node
     */
    void assertionCoreSet(DataRange dataRange,Node node);
    /**
     * @param concept concept
     * @param node node
     * @param isCore isCore
     */
    void assertionRemoved(Concept concept,Node node,boolean isCore);
    /**
     * @param dataRange data range
     * @param node node
     * @param isCore is core
     */
    void assertionRemoved(DataRange dataRange,Node node,boolean isCore);
    /**
     * @param atomicRole atomicRole
     * @param nodeFrom nodeFrom
     * @param nodeTo nodeTo
     * @param isCore isCore
     */
    void assertionAdded(AtomicRole atomicRole,Node nodeFrom,Node nodeTo,boolean isCore);
    /**
     * @param atomicRole atomicRole
     * @param nodeFrom nodeFrom
     * @param nodeTo nodeTo
     */
    void assertionCoreSet(AtomicRole atomicRole,Node nodeFrom,Node nodeTo);
    /**
     * @param atomicRole atomicRole
     * @param nodeFrom nodeFrom
     * @param nodeTo nodeTo
     * @param isCore isCore
     */
    void assertionRemoved(AtomicRole atomicRole,Node nodeFrom,Node nodeTo,boolean isCore);
    /**
     * @param mergeFrom mergeFrom
     * @param mergeInto mergeInto
     */
    void nodesMerged(Node mergeFrom,Node mergeInto);
    /**
     * @param mergeFrom mergeFrom
     * @param mergeInto mergeInto
     */
    void nodesUnmerged(Node mergeFrom,Node mergeInto);
    /**
     * @param node node
     */
    void nodeStatusChanged(Node node);
    /**
     * @param node node
     */
    void nodeInitialized(Node node);
    /**
     * @param node node
     */
    void nodeDestroyed(Node node);
    /**
     * Branching point pushed.
     */
    void branchingPointPushed();
    /**
     * Backtrack.
     */
    void backtrack();
    /**
     * Model found.
     */
    void modelFound();
    /**
     * @return true if deterministic
     */
    boolean isDeterministic();
    /**
     * @return true if exact
     */
    boolean isExact();
    /**
     * @param workers workers
     * @param dlClause dlClause
     * @param variables variables
     * @param valuesBuffer valuesBuffer
     * @param coreVariables coreVariables
     */
    void dlClauseBodyCompiled(List workers,DLClause dlClause,List variables,Object[] valuesBuffer,boolean[] coreVariables);
}