org.aksw.simba.bengal.triple2nl

Class TripleConverter

java.lang.Object

org.aksw.simba.bengal.triple2nl.TripleConverter

public class TripleConverter
extends Object

Convert triple(s) into natural language.

Author:

Lorenz Buehmann

Field Summary

Fields

Modifier and Type	Field and Description
private boolean	considerLiteralLanguage
private static String	DEFAULT_CACHE_BASE_DIR
private static String	DEFAULT_CACHE_DIR
private boolean	determinePluralForm
private boolean	encapsulateStringLiterals
private GenderDetector	genderDetector
private LiteralConverter	literalConverter
private static org.slf4j.Logger	logger
private simplenlg.framework.NLGFactory	nlgFactory
private PropertyVerbalizer	pp
private simplenlg.realiser.english.Realiser	realiser
private org.dllearner.reasoning.SPARQLReasoner	reasoner
private boolean	returnAsSentence
private IRIConverter	uriConverter
private boolean	useAsWellAsCoordination
private boolean	useGenderInformation

Constructor Summary

Constructors

Constructor and Description
TripleConverter()
TripleConverter(org.aksw.jena_sparql_api.core.QueryExecutionFactory qef, IRIConverter uriConverter, String cacheDirectory, net.sf.extjwnl.dictionary.Dictionary wordnetDirectory)
TripleConverter(org.aksw.jena_sparql_api.core.QueryExecutionFactory qef, PropertyVerbalizer propertyVerbalizer, IRIConverter uriConverter, String cacheDirectory, net.sf.extjwnl.dictionary.Dictionary wordnetDirectory, simplenlg.lexicon.Lexicon lexicon)
TripleConverter(org.aksw.jena_sparql_api.core.QueryExecutionFactory qef, String cacheDirectory, net.sf.extjwnl.dictionary.Dictionary wordnetDirectory)
TripleConverter(org.aksw.jena_sparql_api.core.QueryExecutionFactory qef, String cacheDirectory, simplenlg.lexicon.Lexicon lexicon)
TripleConverter(org.dllearner.kb.sparql.SparqlEndpoint endpoint)
TripleConverter(org.dllearner.kb.sparql.SparqlEndpoint endpoint, String cacheDirectory)
TripleConverter(org.dllearner.kb.sparql.SparqlEndpoint endpoint, String cacheDirectory, net.sf.extjwnl.dictionary.Dictionary wordnetDirectory)
TripleConverter(org.dllearner.kb.sparql.SparqlEndpoint endpoint, String cacheDirectory, net.sf.extjwnl.dictionary.Dictionary wordnetDirectory, simplenlg.lexicon.Lexicon lexicon)

Method Summary

Modifier and Type	Method and Description
private void	asPronoun(simplenlg.framework.NLGElement el)
String	convert(List<org.apache.jena.graph.Triple> triples) Return a textual representation for the given triples.
String	convert(org.apache.jena.graph.Triple t) Return a textual representation for the given triple.
String	convert(org.apache.jena.graph.Triple t, boolean negated) Return a textual representation for the given triple.
simplenlg.phrasespec.SPhraseSpec	convertToPhrase(org.apache.jena.graph.Triple t) Convert a triple into a phrase object
simplenlg.phrasespec.SPhraseSpec	convertToPhrase(org.apache.jena.graph.Triple t, boolean negated) Convert a triple into a phrase object
simplenlg.phrasespec.SPhraseSpec	convertToPhrase(org.apache.jena.graph.Triple t, boolean negated, boolean reverse) Convert a triple into a phrase object
List<simplenlg.phrasespec.SPhraseSpec>	convertToPhrases(Collection<org.apache.jena.graph.Triple> triples) Converts a collection of triples into a list of phrases.
simplenlg.phrasespec.NPPhraseSpec	getNPPhrase(String uri, boolean plural, boolean isClass) Takes a URI and returns a noun phrase for it
simplenlg.phrasespec.NPPhraseSpec	processClassNode(org.apache.jena.graph.Node node, boolean plural) Converts the node that is supposed to represent a class in the knowledge base into an NL phrase.
simplenlg.phrasespec.NPPhraseSpec	processLiteralNode(org.apache.jena.graph.Node node)
simplenlg.framework.NLGElement	processNode(org.apache.jena.graph.Node node) Process the node and return an NLG element that contains the textual representation.
private simplenlg.phrasespec.NPPhraseSpec	processObject(org.apache.jena.graph.Node object, boolean isClass)
simplenlg.phrasespec.NPPhraseSpec	processResourceNode(org.apache.jena.graph.Node node)
private simplenlg.framework.NLGElement	processSubject(org.apache.jena.graph.Node subject)
simplenlg.phrasespec.NPPhraseSpec	processVarNode(org.apache.jena.graph.Node varNode)
void	setConsiderLiteralLanguage(boolean considerLiteralLanguage)
void	setDeterminePluralForm(boolean determinePluralForm)
void	setEncapsulateStringLiterals(boolean encapsulateStringLiterals) Whether to encapsulate the value of string literals in "".
void	setGenderDetector(GenderDetector genderDetector)
void	setReturnAsSentence(boolean returnAsSentence)
void	setUseGenderInformation(boolean useGenderInformation)
private boolean	usePluralForm(org.apache.jena.graph.Triple triple)

Methods inherited from class java.lang.Object

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

Field Detail

logger

private static final org.slf4j.Logger logger

DEFAULT_CACHE_BASE_DIR

private static String DEFAULT_CACHE_BASE_DIR

DEFAULT_CACHE_DIR

private static String DEFAULT_CACHE_DIR

nlgFactory

private simplenlg.framework.NLGFactory nlgFactory

realiser

private simplenlg.realiser.english.Realiser realiser

uriConverter

private IRIConverter uriConverter

literalConverter

private LiteralConverter literalConverter

pp

private PropertyVerbalizer pp

reasoner

private org.dllearner.reasoning.SPARQLReasoner reasoner

determinePluralForm

private boolean determinePluralForm

considerLiteralLanguage

private boolean considerLiteralLanguage

encapsulateStringLiterals

private boolean encapsulateStringLiterals

useAsWellAsCoordination

private boolean useAsWellAsCoordination

returnAsSentence

private boolean returnAsSentence

useGenderInformation

private boolean useGenderInformation

genderDetector

private GenderDetector genderDetector

Constructor Detail

TripleConverter

public TripleConverter()

TripleConverter

public TripleConverter(org.dllearner.kb.sparql.SparqlEndpoint endpoint)

TripleConverter

public TripleConverter(org.aksw.jena_sparql_api.core.QueryExecutionFactory qef,
                       String cacheDirectory,
                       net.sf.extjwnl.dictionary.Dictionary wordnetDirectory)

TripleConverter

public TripleConverter(org.dllearner.kb.sparql.SparqlEndpoint endpoint,
                       String cacheDirectory)

TripleConverter

public TripleConverter(org.dllearner.kb.sparql.SparqlEndpoint endpoint,
                       String cacheDirectory,
                       net.sf.extjwnl.dictionary.Dictionary wordnetDirectory)

TripleConverter

public TripleConverter(org.dllearner.kb.sparql.SparqlEndpoint endpoint,
                       String cacheDirectory,
                       net.sf.extjwnl.dictionary.Dictionary wordnetDirectory,
                       simplenlg.lexicon.Lexicon lexicon)

TripleConverter

public TripleConverter(org.aksw.jena_sparql_api.core.QueryExecutionFactory qef,
                       IRIConverter uriConverter,
                       String cacheDirectory,
                       net.sf.extjwnl.dictionary.Dictionary wordnetDirectory)

TripleConverter

public TripleConverter(org.aksw.jena_sparql_api.core.QueryExecutionFactory qef,
                       String cacheDirectory,
                       simplenlg.lexicon.Lexicon lexicon)

TripleConverter

public TripleConverter(org.aksw.jena_sparql_api.core.QueryExecutionFactory qef,
                       PropertyVerbalizer propertyVerbalizer,
                       IRIConverter uriConverter,
                       String cacheDirectory,
                       net.sf.extjwnl.dictionary.Dictionary wordnetDirectory,
                       simplenlg.lexicon.Lexicon lexicon)

Method Detail

convert

public String convert(org.apache.jena.graph.Triple t)

Return a textual representation for the given triple.

Parameters:

t - the triple to convert

Returns:

the textual representation

convert

public String convert(org.apache.jena.graph.Triple t,
                      boolean negated)

Return a textual representation for the given triple.

Parameters:

t - the triple to convert

negated - if phrase is negated

Returns:

the textual representation

convert

public String convert(List<org.apache.jena.graph.Triple> triples)

Return a textual representation for the given triples. Currently we assume that all triples have the same subject!

Parameters:

triples - the triples to convert

Returns:

the textual representation

asPronoun

private void asPronoun(simplenlg.framework.NLGElement el)

convertToPhrase

public simplenlg.phrasespec.SPhraseSpec convertToPhrase(org.apache.jena.graph.Triple t)

Convert a triple into a phrase object

Parameters:

t - the triple

Returns:

the phrase

convertToPhrase

public simplenlg.phrasespec.SPhraseSpec convertToPhrase(org.apache.jena.graph.Triple t,
                                                        boolean negated)

Convert a triple into a phrase object

Parameters:

t - the triple

Returns:

the phrase

convertToPhrase

public simplenlg.phrasespec.SPhraseSpec convertToPhrase(org.apache.jena.graph.Triple t,
                                                        boolean negated,
                                                        boolean reverse)

Convert a triple into a phrase object

Parameters:

t - the triple

negated - if phrase is negated

reverse - whether subject and object should be changed during verbalization

Returns:

the phrase

convertToPhrases

public List<simplenlg.phrasespec.SPhraseSpec> convertToPhrases(Collection<org.apache.jena.graph.Triple> triples)

Converts a collection of triples into a list of phrases.

Parameters:

triples - the triples

Returns:

a list of phrases

setEncapsulateStringLiterals

public void setEncapsulateStringLiterals(boolean encapsulateStringLiterals)

Whether to encapsulate the value of string literals in "". See: LiteralConverter.setEncapsulateStringLiterals(boolean)

Parameters:

encapsulateStringLiterals - TRUE if string has to be wrapped in "", otherwise FALSE

setDeterminePluralForm

public void setDeterminePluralForm(boolean determinePluralForm)

Parameters:

determinePluralForm - the determinePluralForm to set

setConsiderLiteralLanguage

public void setConsiderLiteralLanguage(boolean considerLiteralLanguage)

Parameters:

considerLiteralLanguage - the considerLiteralLanguage to set

usePluralForm

private boolean usePluralForm(org.apache.jena.graph.Triple triple)

setReturnAsSentence

public void setReturnAsSentence(boolean returnAsSentence)

Parameters:

returnAsSentence - whether the style of the returned result is a proper English sentence or just a phrase

setUseGenderInformation

public void setUseGenderInformation(boolean useGenderInformation)

Parameters:

useGenderInformation - whether to use the gender information about a resource

setGenderDetector

public void setGenderDetector(GenderDetector genderDetector)

processNode

public simplenlg.framework.NLGElement processNode(org.apache.jena.graph.Node node)

Process the node and return an NLG element that contains the textual representation. The output depends on the node type, i.e. variable, URI or literal.

Parameters:

node - the node to process

Returns:

the NLG element containing the textual representation of the node

processClassNode

public simplenlg.phrasespec.NPPhraseSpec processClassNode(org.apache.jena.graph.Node node,
                                                          boolean plural)

Converts the node that is supposed to represent a class in the knowledge base into an NL phrase.

Parameters:

node - the node

plural - whether the plural form should be used

Returns:

the NL phrase

processVarNode

public simplenlg.phrasespec.NPPhraseSpec processVarNode(org.apache.jena.graph.Node varNode)

processLiteralNode

public simplenlg.phrasespec.NPPhraseSpec processLiteralNode(org.apache.jena.graph.Node node)

processResourceNode

public simplenlg.phrasespec.NPPhraseSpec processResourceNode(org.apache.jena.graph.Node node)

processSubject

private simplenlg.framework.NLGElement processSubject(org.apache.jena.graph.Node subject)

processObject

private simplenlg.phrasespec.NPPhraseSpec processObject(org.apache.jena.graph.Node object,
                                                        boolean isClass)

getNPPhrase

public simplenlg.phrasespec.NPPhraseSpec getNPPhrase(String uri,
                                                     boolean plural,
                                                     boolean isClass)

Takes a URI and returns a noun phrase for it

Parameters:

uri - the URI to convert

plural - whether it is in plural form

isClass - if URI is supposed to be a class

Returns:

the noun phrase