org.semanticweb.HermiT.debugger.Debugger 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
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 m_commandsByName;
protected final Prefixes m_prefixes;
protected final DerivationHistory m_derivationHistory;
protected final ConsoleTextArea m_consoleTextArea;
protected final JFrame m_mainFrame;
protected final PrintWriter m_output;
protected final BufferedReader m_input;
protected final Set m_waitOptions;
protected final Map m_nodeCreationInfos;
protected Node m_lastExistentialNode;
protected ExistentialConcept m_lastExistentialConcept;
protected Tableau m_tableau;
protected String m_lastCommand;
protected boolean m_forever;
protected long m_lastStatusMark;
protected boolean m_singlestep;
protected boolean m_inMainLoop;
protected int m_breakpointTime;
protected int m_currentIteration;
/**
* @param prefixes prefixes
* @param historyOn historyOn
*/
public Debugger(Prefixes prefixes,boolean historyOn) {
super(new DerivationHistory());
m_commandsByName=new TreeMap<>();
registerCommands();
m_prefixes=prefixes;
m_derivationHistory=(DerivationHistory)m_forwardingTargetMonitor;
m_consoleTextArea=new ConsoleTextArea();
m_consoleTextArea.setFont(s_monospacedFont);
m_output=new PrintWriter(m_consoleTextArea.getWriter());
m_input=new BufferedReader(m_consoleTextArea.getReader());
JScrollPane scrollPane=new JScrollPane(m_consoleTextArea);
scrollPane.setPreferredSize(new Dimension(800,300));
m_mainFrame=new JFrame("HermiT Debugger");
m_mainFrame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
m_mainFrame.setContentPane(scrollPane);
m_mainFrame.pack();
Dimension screenSize=Toolkit.getDefaultToolkit().getScreenSize();
Dimension preferredSize=m_mainFrame.getPreferredSize();
m_mainFrame.setLocation((screenSize.width-preferredSize.width)/2,screenSize.height-100-preferredSize.height);
m_forwardingOn=historyOn;
m_waitOptions=new HashSet<>();
m_nodeCreationInfos=new HashMap<>();
m_forever=false;
m_singlestep=false;
m_breakpointTime=30000;
m_mainFrame.setVisible(true);
m_output.println("Good morning Dr. Chandra. This is HAL. I'm ready for my first lesson.");
m_output.println("Derivation history is "+(m_forwardingOn ? "on" : "off")+".");
}
protected void registerCommands() {
registerCommand(new ActiveNodesCommand(this));
registerCommand(new AgainCommand(this));
registerCommand(new BreakpointTimeCommand(this));
registerCommand(new ClearCommand(this));
registerCommand(new ContinueCommand(this));
registerCommand(new DerivationTreeCommand(this));
registerCommand(new ExitCommand(this));
registerCommand(new ForeverCommand(this));
registerCommand(new HelpCommand(this));
registerCommand(new HistoryCommand(this));
registerCommand(new IsAncestorOfCommand(this));
registerCommand(new ModelStatsCommand(this));
registerCommand(new NodesForCommand(this));
registerCommand(new OriginStatsCommand(this));
registerCommand(new QueryCommand(this));
registerCommand(new ReuseNodeForCommand(this));
registerCommand(new ShowDescriptionGraphCommand(this));
registerCommand(new ShowDLClausesCommand(this));
registerCommand(new ShowExistsCommand(this));
registerCommand(new ShowModelCommand(this));
registerCommand(new ShowNodeCommand(this));
registerCommand(new ShowSubtreeCommand(this));
registerCommand(new SingleStepCommand(this));
registerCommand(new UnprocessedDisjunctionsCommand(this));
registerCommand(new WaitForCommand(this));
}
protected void registerCommand(DebuggerCommand command) {
m_commandsByName.put(command.getCommandName().toLowerCase(),command);
}
/**
* @return debugger commands
*/
public Map getDebuggerCommands() {
return Collections.unmodifiableMap(m_commandsByName);
}
/**
* @return tableau
*/
public Tableau getTableau() {
return m_tableau;
}
/**
* @return output
*/
public PrintWriter getOutput() {
return m_output;
}
/**
* @return mainframe
*/
public JFrame getMainFrame() {
return m_mainFrame;
}
/**
* @return last command
*/
public String getLastCommand() {
return m_lastCommand;
}
/**
* @return text area
*/
public ConsoleTextArea getConsoleTextArea() {
return m_consoleTextArea;
}
/**
* @return prefixes
*/
public Prefixes getPrefixes() {
return m_prefixes;
}
/**
* @return derivation history
*/
public DerivationHistory getDerivationHistory() {
return m_derivationHistory;
}
/**
* @param node node
* @return creation info
*/
public NodeCreationInfo getNodeCreationInfo(Node node) {
return m_nodeCreationInfos.get(node);
}
/**
* @param time time
*/
public void setBreakpointTime(int time) {
m_breakpointTime=time;
}
/**
* @param inMainLoop inMainLoop
*/
public void setInMainLoop(boolean inMainLoop) {
m_inMainLoop=inMainLoop;
}
/**
* @param forever forever
*/
public void setForever(boolean forever) {
m_forever=forever;
}
/**
* @param singlestep singlestep
*/
public void setSinglestep(boolean singlestep) {
m_singlestep=singlestep;
}
/**
* @param option option
* @return true if option added
*/
public boolean addWaitOption(WaitOption option) {
return m_waitOptions.add(option);
}
/**
* @param option option
* @return true if option removed
*/
public boolean removeWaitOption(WaitOption option) {
return m_waitOptions.remove(option);
}
/**
* @param commandName commandName
* @return debugger command
*/
public DebuggerCommand getCommand(String commandName) {
return m_commandsByName.get(commandName.toLowerCase());
}
/**
* Main loop.
*/
public void mainLoop() {
try {
m_inMainLoop=true;
while (m_inMainLoop) {
m_output.print("> ");
String commandLine=m_input.readLine();
if (commandLine!=null) {
commandLine=commandLine.trim();
processCommandLine(commandLine);
}
}
m_output.flush();
}
catch (@SuppressWarnings("unused") IOException e) {
}
m_lastStatusMark=System.currentTimeMillis();
}
/**
* @param commandLine commandLine
*/
public void processCommandLine(String commandLine) {
String[] parsedCommand=parse(commandLine);
String commandName=parsedCommand[0];
DebuggerCommand command=getCommand(commandName);
if (command==null)
m_output.println("Unknown command '"+commandName+"'.");
else {
command.execute(parsedCommand);
if (!(command instanceof AgainCommand))
m_lastCommand=commandLine;
}
}
protected String[] parse(String _command) {
String command=_command.trim();
List arguments=new ArrayList<>();
int firstChar=0;
int nextSpace=command.indexOf(' ');
while (nextSpace!=-1) {
arguments.add(command.substring(firstChar,nextSpace));
firstChar=nextSpace;
while (firstCharm_breakpointTime) {
printState();
if (!m_forever)
mainLoop();
m_lastStatusMark=System.currentTimeMillis();
}
}
@Override
public void clashDetected() {
super.clashDetected();
if (m_waitOptions.contains(WaitOption.CLASH)) {
m_forever=false;
m_output.println("Clash detected.");
mainLoop();
}
}
@Override
public void mergeStarted(Node mergeFrom,Node mergeInto) {
super.mergeStarted(mergeFrom,mergeInto);
if (m_waitOptions.contains(WaitOption.MERGE)) {
m_forever=false;
m_output.println("Node '"+mergeFrom.getNodeID()+"' will be merged into node '"+mergeInto.getNodeID()+"'.");
mainLoop();
}
}
@Override
public void existentialExpansionStarted(ExistentialConcept existentialConcept,Node forNode) {
super.existentialExpansionStarted(existentialConcept,forNode);
m_lastExistentialNode=forNode;
m_lastExistentialConcept=existentialConcept;
}
@Override
public void existentialExpansionFinished(ExistentialConcept existentialConcept,Node forNode) {
super.existentialExpansionFinished(existentialConcept,forNode);
m_lastExistentialNode=null;
m_lastExistentialConcept=null;
if ((existentialConcept instanceof ExistsDescriptionGraph && m_waitOptions.contains(WaitOption.GRAPH_EXPANSION)) || (existentialConcept instanceof AtLeastConcept && m_waitOptions.contains(WaitOption.EXISTENTIAL_EXPANSION))) {
m_forever=false;
m_output.println(existentialConcept.toString(m_prefixes)+" expanded for node "+forNode.getNodeID());
mainLoop();
}
}
@Override
public void nodeCreated(Node node) {
super.nodeCreated(node);
m_nodeCreationInfos.put(node,new NodeCreationInfo(m_lastExistentialNode,m_lastExistentialConcept));
if (m_lastExistentialNode!=null)
m_nodeCreationInfos.get(m_lastExistentialNode).m_children.add(node);
}
@Override
public void nodeDestroyed(Node node) {
super.nodeDestroyed(node);
NodeCreationInfo nodeCreationInfo=m_nodeCreationInfos.remove(node);
if (nodeCreationInfo.m_createdByNode!=null)
m_nodeCreationInfos.get(nodeCreationInfo.m_createdByNode).m_children.remove(node);
}
@Override
public void datatypeCheckingStarted() {
super.datatypeCheckingStarted();
if (m_waitOptions.contains(WaitOption.DATATYPE_CHECKING)) {
m_forever=false;
m_output.println("Will check whether the datatype constraints are satisfiable.");
mainLoop();
}
}
@Override
public void blockingValidationStarted() {
super.blockingValidationStarted();
if (m_waitOptions.contains(WaitOption.BLOCKING_VALIDATION_STARTED)) {
m_forever=false;
m_output.println("Will validate blocking.");
mainLoop();
}
}
@Override
public void blockingValidationFinished(int noInvalidlyBlocked) {
super.blockingValidationFinished(noInvalidlyBlocked);
if (m_waitOptions.contains(WaitOption.BLOCKING_VALIDATION_FINISHED)) {
m_forever=false;
m_output.println("Blocking validated.");
mainLoop();
}
}
/**NodeCreationInfo.*/
public static class NodeCreationInfo {
/**created by*/
public final Node m_createdByNode;
/**created by existential*/
public final ExistentialConcept m_createdByExistential;
/**children*/
public final List m_children;
/**
* @param createdByNode createdByNode
* @param createdByExistential createdByExistential
*/
public NodeCreationInfo(Node createdByNode,ExistentialConcept createdByExistential) {
m_createdByNode=createdByNode;
m_createdByExistential=createdByExistential;
m_children=new ArrayList<>(4);
}
}
}