org.semanticweb.HermiT.cli.CommandLine 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 prefixMappings=new HashMap<>();
String resultsFileLocation=null;
boolean classifyClasses=false;
boolean classifyOPs=false;
boolean classifyDPs=false;
boolean prettyPrint=false;
Collection actions=new LinkedList<>();
URI base;
IRI conclusionIRI=null;
Configuration config=new Configuration();
boolean doAll=true;
try {
base=new URI("file",System.getProperty("user.dir")+"/",null);
}
catch (java.net.URISyntaxException e) {
throw new RuntimeException("unable to create default IRI base");
}
Collection ontologies=new LinkedList<>();
boolean didSomething=false;
{
Getopt g=new Getopt("java-jar Hermit.jar",argv,Option.formatOptionsString(Option.options),Option.createLongOpts(Option.options));
g.setOpterr(false);
int opt;
while ((opt=g.getopt())!=-1) {
switch (opt) {
// meta:
case 'h': {
System.out.println(usageString);
for (String s : helpHeader)
System.out.println(s);
System.out.println(Option.formatOptionHelp(Option.options));
for (String s : footer)
System.out.println(s);
System.exit(0);
didSomething=true;
}
break;
case 'V': {
System.out.println(versionString);
for (String s : footer)
System.out.println(s);
System.exit(0);
didSomething=true;
}
break;
case 'v': {
String arg=g.getOptarg();
if (arg==null) {
verbosity+=1;
}
else
try {
verbosity+=Integer.parseInt(arg,10);
}
catch (NumberFormatException e) {
throw new UsageException("argument to --verbose must be a number");
}
}
break;
case 'q': {
String arg=g.getOptarg();
if (arg==null) {
verbosity-=1;
}
else
try {
verbosity-=Integer.parseInt(arg,10);
}
catch (NumberFormatException e) {
throw new UsageException("argument to --quiet must be a number");
}
}
break;
case 'o': {
String arg=g.getOptarg();
if (arg==null)
throw new UsageException("--output requires an argument");
if (arg.equals("-"))
output=new PrintWriter(System.out);
else {
try {
File file=new File(arg);
if (!file.exists())
file.createNewFile();
file=file.getAbsoluteFile();
output=new PrintWriter(new BufferedOutputStream(new FileOutputStream(file)),true);
resultsFileLocation=file.getAbsolutePath();
}
catch (FileNotFoundException e) {
throw new IllegalArgumentException("unable to open "+arg+" for writing");
}
catch (SecurityException e) {
throw new IllegalArgumentException("unable to write to "+arg);
}
catch (IOException e) {
throw new IllegalArgumentException("unable to write to "+arg+": "+e.getMessage());
}
}
}
break;
case kPremise: {
String arg=g.getOptarg();
if (arg==null)
throw new UsageException("--premise requires a IRI as argument");
else {
ontologies.add(IRI.create(arg));
}
}
break;
case kConclusion: {
String arg=g.getOptarg();
if (arg==null)
throw new UsageException("--conclusion requires a IRI as argument");
else {
conclusionIRI=IRI.create(arg);
}
}
break;
// actions:
case 'l': {
// load is a no-op; loading happens no matter what the user asks
}
break;
case 'c': {
classifyClasses=true;
}
break;
case 'O': {
classifyOPs=true;
}
break;
case 'D': {
classifyDPs=true;
}
break;
case 'P': {
prettyPrint=true;
}
break;
case 'k': {
String arg=g.getOptarg();
if (arg==null) {
arg="http://www.w3.org/2002/07/owl#Thing";
}
actions.add(new SatisfiabilityAction(arg));
}
break;
case 'd': {
doAll=false;
}
break;
case 's': {
String arg=g.getOptarg();
actions.add(new SubsAction(arg,doAll));
doAll=true;
}
break;
case 'S': {
String arg=g.getOptarg();
actions.add(new SupersAction(arg,doAll));
doAll=true;
}
break;
case 'e': {
String arg=g.getOptarg();
actions.add(new EquivalentsAction(arg));
}
break;
case 'U': {
actions.add(new EquivalentsAction("http://www.w3.org/2002/07/owl#Nothing"));
}
break;
case 'E': {
if (conclusionIRI!=null)
actions.add(new EntailsAction(config, conclusionIRI));
}
break;
case kDumpPrefixes: {
actions.add(new DumpPrefixesAction());
}
break;
case 'N': {
ignoreOntologyPrefixes=true;
}
break;
case 'p': {
String arg=g.getOptarg();
int eqIndex=arg.indexOf('=');
if (eqIndex==-1) {
throw new IllegalArgumentException("the prefix declaration '"+arg+"' is not of the form PN=IRI.");
}
prefixMappings.put(arg.substring(0,eqIndex),arg.substring(eqIndex+1));
}
break;
case kDefaultPrefix: {
String arg=g.getOptarg();
defaultPrefix=arg;
}
break;
case kBase: {
String arg=g.getOptarg();
try {
base=new URI(arg);
}
catch (java.net.URISyntaxException e) {
throw new IllegalArgumentException("'"+arg+"' is not a valid base URI.");
}
}
break;
case kDirectBlock: {
String arg=g.getOptarg();
if (arg.toLowerCase().equals("pairwise")) {
config.directBlockingType=Configuration.DirectBlockingType.PAIR_WISE;
}
else if (arg.toLowerCase().equals("single")) {
config.directBlockingType=Configuration.DirectBlockingType.SINGLE;
}
else if (arg.toLowerCase().equals("optimal")) {
config.directBlockingType=Configuration.DirectBlockingType.OPTIMAL;
}
else
throw new UsageException("unknown direct blocking type '"+arg+"'; supported values are 'pairwise', 'single', and 'optimal'");
}
break;
case kBlockStrategy: {
String arg=g.getOptarg();
if (arg.toLowerCase().equals("anywhere")) {
config.blockingStrategyType=Configuration.BlockingStrategyType.ANYWHERE;
}
else if (arg.toLowerCase().equals("ancestor")) {
config.blockingStrategyType=Configuration.BlockingStrategyType.ANCESTOR;
}
else if (arg.toLowerCase().equals("core")) {
config.blockingStrategyType=Configuration.BlockingStrategyType.SIMPLE_CORE;
}
else if (arg.toLowerCase().equals("optimal")) {
config.blockingStrategyType=Configuration.BlockingStrategyType.OPTIMAL;
}
else
throw new UsageException("unknown blocking strategy type '"+arg+"'; supported values are 'ancestor' and 'anywhere'");
}
break;
case kBlockCache: {
config.blockingSignatureCacheType=Configuration.BlockingSignatureCacheType.CACHED;
}
break;
case kExpansion: {
String arg=g.getOptarg();
if (arg.toLowerCase().equals("creation")) {
config.existentialStrategyType=Configuration.ExistentialStrategyType.CREATION_ORDER;
}
else if (arg.toLowerCase().equals("el")) {
config.existentialStrategyType=Configuration.ExistentialStrategyType.EL;
}
else if (arg.toLowerCase().equals("reuse")) {
config.existentialStrategyType=Configuration.ExistentialStrategyType.INDIVIDUAL_REUSE;
}
else
throw new UsageException("unknown existential strategy type '"+arg+"'; supported values are 'creation', 'el', and 'reuse'");
}
break;
case kIgnoreUnsupportedDatatypes: {
config.ignoreUnsupportedDatatypes=true;
}
break;
case kNoInconsistentException: {
config.throwInconsistentOntologyException=false;
}
break;
case kDumpClauses: {
actions.add(new DumpClausesAction(g.getOptarg()));
}
break;
default: {
if (g.getOptopt()!=0) {
throw new UsageException("invalid option -- "+(char)g.getOptopt());
}
throw new UsageException("invalid option");
}
} // end option switch
} // end loop over options
for (int i=g.getOptind();i3)
config.monitor=new Timer(System.err);
if (classifyClasses || classifyOPs || classifyDPs)
actions.add(new ClassifyAction(classifyClasses, classifyOPs, classifyDPs, prettyPrint, resultsFileLocation));
for (IRI ont : ontologies) {
didSomething=true;
status.log(2,"Processing "+ont.toString());
status.log(2,String.valueOf(actions.size())+" actions");
try {
long startTime=System.currentTimeMillis();
OWLOntologyManager ontologyManager=OWLManager.createOWLOntologyManager();
if (ont.isAbsolute()) {
URI uri=URI.create(ont.getNamespace());
String scheme = uri.getScheme();
if (scheme!=null && scheme.equalsIgnoreCase("file")) {
File file=new File(URI.create(ont.getNamespace()));
if (file.isDirectory()) {
OWLOntologyIRIMapper mapper=new AutoIRIMapper(file, false);
ontologyManager.getIRIMappers().add(mapper);
}
}
}
OWLOntology ontology=ontologyManager.loadOntology(ont);
// if (!ignoreOntologyPrefixes) {
// SimpleRenderer renderer=new SimpleRenderer();
// renderer.setPrefixesFromOntologyFormat(ontology, ontologyManager, true);
// ToStringRenderer.getInstance().setRenderer(renderer);
// }
long parseTime=System.currentTimeMillis()-startTime;
status.log(2,"Ontology parsed in "+String.valueOf(parseTime)+" msec.");
startTime=System.currentTimeMillis();
Reasoner hermit=new Reasoner(config,ontology);
Prefixes prefixes=hermit.getPrefixes();
if (defaultPrefix!=null) {
try {
prefixes.declareDefaultPrefix(defaultPrefix);
}
catch (IllegalArgumentException e) {
status.log(2,"Default prefix "+defaultPrefix+" could not be registered because there is already a registered default prefix. ");
}
}
for (String prefixName : prefixMappings.keySet()) {
try {
prefixes.declarePrefix(prefixName, prefixMappings.get(prefixName));
}
catch (IllegalArgumentException e) {
status.log(2,"Prefixname "+prefixName+" could not be set to "+prefixMappings.get(prefixName)+" because there is already a registered prefix name for the IRI. ");
}
}
long loadTime=System.currentTimeMillis()-startTime;
status.log(2,"Reasoner created in "+String.valueOf(loadTime)+" msec.");
for (Action action : actions) {
status.log(2,"Doing action...");
startTime=System.currentTimeMillis();
action.run(hermit,status,output,ignoreOntologyPrefixes);
long actionTime=System.currentTimeMillis()-startTime;
status.log(2,"...action completed in "+String.valueOf(actionTime)+" msec.");
}
}
catch (org.semanticweb.owlapi.model.OWLException e) {
System.err.println("It all went pear-shaped: "+e.getMessage());
e.printStackTrace(System.err);
}
}
if (!didSomething)
throw new UsageException("No ontologies given.");
}
catch (UsageException e) {
System.err.println(e.getMessage());
System.err.println(usageString);
System.err.println("Try 'hermit --help' for more information.");
}
}
}