uk.ac.manchester.cs.owlapi.modularity

Class SyntacticLocalityModuleExtractor

java.lang.Object

uk.ac.manchester.cs.owlapi.modularity.SyntacticLocalityModuleExtractor

All Implemented Interfaces:

OntologySegmenter

public class SyntacticLocalityModuleExtractor
extends Object
implements OntologySegmenter

Implementation of module extraction based on syntactic locality.

Author:

Thomas Schneider, School of Computer Science, University of Manchester

Constructor Summary

Constructors

Constructor and Description
SyntacticLocalityModuleExtractor(org.semanticweb.owlapi.model.OWLOntologyManager man, org.semanticweb.owlapi.model.OWLOntology ont, ModuleType moduleType) Creates a new module extractor for a given ontology, its manager, and a specified type of locality.
SyntacticLocalityModuleExtractor(org.semanticweb.owlapi.model.OWLOntologyManager man, org.semanticweb.owlapi.model.OWLOntology ont, Set<org.semanticweb.owlapi.model.OWLAxiom> axs, ModuleType moduleType) Creates a new module extractor for a subset of a given ontology, its manager, and a specified type of locality.

Method Summary

Methods

Modifier and Type	Method and Description
Set<org.semanticweb.owlapi.model.OWLAxiom>	extract(Set<org.semanticweb.owlapi.model.OWLEntity> sig) Returns a set of axioms that is a segment of the ontology associated with this segmenter.
Set<org.semanticweb.owlapi.model.OWLAxiom>	extract(Set<org.semanticweb.owlapi.model.OWLEntity> sig, int superClassLevel, int subClassLevel, org.semanticweb.owlapi.reasoner.OWLReasoner reasoner) Returns a set of axioms that is a segment of the ontology associated with this segmenter.
Set<org.semanticweb.owlapi.model.OWLAxiom>	extract(Set<org.semanticweb.owlapi.model.OWLEntity> sig, int superClassLevel, int subClassLevel, org.semanticweb.owlapi.reasoner.OWLReasoner reasoner, boolean verbose) Extracts a module from the associated ontology for a given signature and the associated module type, and returns the module as a set of axioms.
org.semanticweb.owlapi.model.OWLOntology	extractAsOntology(Set<org.semanticweb.owlapi.model.OWLEntity> signature, org.semanticweb.owlapi.model.IRI iri) Returns an ontology that is a segment of the ontology associated with this segmenter.
org.semanticweb.owlapi.model.OWLOntology	extractAsOntology(Set<org.semanticweb.owlapi.model.OWLEntity> signature, org.semanticweb.owlapi.model.IRI iri, int superClassLevel, int subClassLevel, org.semanticweb.owlapi.reasoner.OWLReasoner reasoner) Returns an ontology that is a segment of the ontology associated with this segmenter.
ModuleType	getModuleType() Returns the module type for this extractor.
void	setModuleType(ModuleType moduleType) Changes the module type for this extractor without deleting the stored referenced entities.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

SyntacticLocalityModuleExtractor

public SyntacticLocalityModuleExtractor(org.semanticweb.owlapi.model.OWLOntologyManager man,
                                org.semanticweb.owlapi.model.OWLOntology ont,
                                Set<org.semanticweb.owlapi.model.OWLAxiom> axs,
                                ModuleType moduleType)

Creates a new module extractor for a subset of a given ontology, its manager, and a specified type of locality.

Parameters:

man - the manager for the associated ontology

ont - the associated ontology

axs - the subset of the ontology as a set of axioms

moduleType - the type of module this extractor will construct

SyntacticLocalityModuleExtractor

public SyntacticLocalityModuleExtractor(org.semanticweb.owlapi.model.OWLOntologyManager man,
                                org.semanticweb.owlapi.model.OWLOntology ont,
                                ModuleType moduleType)

Creates a new module extractor for a given ontology, its manager, and a specified type of locality.

Parameters:

man - the manager for the associated ontology

ont - the associated ontology

moduleType - the type of module this extractor will construct

Method Detail

setModuleType

public void setModuleType(ModuleType moduleType)

Changes the module type for this extractor without deleting the stored referenced entities.

Parameters:

moduleType - the new type of module

getModuleType

public ModuleType getModuleType()

Returns the module type for this extractor.

Returns:

module type for this extractor

extract

public Set<org.semanticweb.owlapi.model.OWLAxiom> extract(Set<org.semanticweb.owlapi.model.OWLEntity> sig)

Description copied from interface: OntologySegmenter

Returns a set of axioms that is a segment of the ontology associated with this segmenter. This segment is determined by the specified seed signature (set of entities).

Specified by:

extract in interface OntologySegmenter

Parameters:

sig - the seed signature

Returns:

the segment as a set of axioms

extract

public Set<org.semanticweb.owlapi.model.OWLAxiom> extract(Set<org.semanticweb.owlapi.model.OWLEntity> sig,
                                                 int superClassLevel,
                                                 int subClassLevel,
                                                 org.semanticweb.owlapi.reasoner.OWLReasoner reasoner)

Description copied from interface: OntologySegmenter

Returns a set of axioms that is a segment of the ontology associated with this segmenter. This segment is determined by a seed signature (set of entities), which is the specified signature plus possibly all superclasses and/or subclasses of the classes therein. Sub-/superclasses are determined using the specified reasoner.

Specified by:

extract in interface OntologySegmenter

Parameters:

sig - the seed signature

superClassLevel - determines whether superclasses are added to the signature before segment extraction, see below for admissible values

subClassLevel - determines whether subclasses are added to the signature before segment extraction, see below for admissible values

reasoner - the reasoner to determine super-/subclasses

Returns:

the segment as a set of axioms Meaning of the value of superClassLevel, subClassLevel:
Let this value be k. If k > 0, then all classes are included that are (direct or indirect) super-/subclasses of some class in signature, with a distance of at most k to this class in the class hierarchy computed by reasoner. If k = 0, then no super-/subclasses are added. If k < 0, then all direct and indirect super-/subclasses of any class in the signature are added.

extract

public Set<org.semanticweb.owlapi.model.OWLAxiom> extract(Set<org.semanticweb.owlapi.model.OWLEntity> sig,
                                                 int superClassLevel,
                                                 int subClassLevel,
                                                 org.semanticweb.owlapi.reasoner.OWLReasoner reasoner,
                                                 boolean verbose)

Extracts a module from the associated ontology for a given signature and the associated module type, and returns the module as a set of axioms. The seed signature (set of entities) which determines the module is the specified signature plus possibly all superclasses and/or subclasses of the classes therein. Sub-/superclasses are determined using the specified reasoner. The module will include annotation and declaration axioms for all entities and axioms in it.

Parameters:

sig - the seed signature (set of entities) for the module

superClassLevel - determines whether superclasses are added to the signature before segment extraction, see below for admissible values

subClassLevel - determines whether subclasses are added to the signature before segment extraction
Admissible values for superClassLevel (analogously for subClassLevel):

• If superClassLevel > 0, then all classes C are included for which the class hierarchy computed by the reasoner contains a path of length at most superClassLevel downwards from C to some class from the signature.
• If superClassLevel = 0, then no super-/subclasses are added.
• If superClassLevel < 0, then all direct and indirect super-/subclasses of any class in the signature are added.

reasoner - the reasoner to determine super-/subclasses. This can be an arbitrary reasoner, including a ToldClassHierarchyReasoner. It must have loaded the ontology.

verbose - true if verbose output is required

Returns:

the module

extractAsOntology

public org.semanticweb.owlapi.model.OWLOntology extractAsOntology(Set<org.semanticweb.owlapi.model.OWLEntity> signature,
                                                         org.semanticweb.owlapi.model.IRI iri)
                                                           throws org.semanticweb.owlapi.model.OWLOntologyCreationException

Description copied from interface: OntologySegmenter

Returns an ontology that is a segment of the ontology associated with this segmenter.

Specified by:

extractAsOntology in interface OntologySegmenter

Parameters:

signature - the seed signature (set of entities) for the module

iri - the URI for the module

Returns:

the module, having the specified URI

Throws:

org.semanticweb.owlapi.model.OWLOntologyCreationException - if the module cannot be created

extractAsOntology

public org.semanticweb.owlapi.model.OWLOntology extractAsOntology(Set<org.semanticweb.owlapi.model.OWLEntity> signature,
                                                         org.semanticweb.owlapi.model.IRI iri,
                                                         int superClassLevel,
                                                         int subClassLevel,
                                                         org.semanticweb.owlapi.reasoner.OWLReasoner reasoner)
                                                           throws org.semanticweb.owlapi.model.OWLOntologyCreationException

Description copied from interface: OntologySegmenter

Returns an ontology that is a segment of the ontology associated with this segmenter. This segment is determined by a seed signature (set of entities), which is the specified signature plus possibly all superclasses and/or subclasses of the classes therein. Sub-/superclasses are determined using the specified reasoner.

Specified by:

extractAsOntology in interface OntologySegmenter

Parameters:

signature - the seed signature

iri - the URI for the module

superClassLevel - determines whether superclasses are added to the signature before segment extraction, see below for admissible values

subClassLevel - determines whether subclasses are added to the signature before segment extraction, see below for admissible values

reasoner - the reasoner to determine super-/subclasses

Returns:

the segment as a set of axioms

Throws:

org.semanticweb.owlapi.model.OWLOntologyCreationException - if the module cannot be created Meaning of the value of superClassLevel, subClassLevel:
Let this value be k. If k > 0, then all classes are included that are (direct or indirect) super-/subclasses of some class in signature, with a distance of at most k to this class in the class hierarchy computed by reasoner. If k = 0, then no super-/subclasses are added. If k < 0, then all direct and indirect super-/subclasses of any class in the signature are added.