com.articulate.sigma

Class WordNetUtilities

java.lang.Object

com.articulate.sigma.WordNetUtilities

public class WordNetUtilities
extends java.lang.Object

Author:

Adam Pease

Field Summary

Fields

Modifier and Type	Field and Description
static int	TPTPidCounter
protected static java.util.ArrayList<java.lang.String>	WordNetRelations

Constructor Summary

Constructors

Constructor and Description
WordNetUtilities()

Method Summary

Modifier and Type	Method and Description
static void	commentSentiment(java.lang.String fileWithPath) Take a file of tabtab and calculate the average Levenshtein distance for each ID.
static java.util.ArrayList<java.lang.String>	convertTermList(java.lang.String termList) Convert a list of Terms in the format "&%term1 &%term2" to an ArrayList of bare term Strings
static java.lang.String	convertWordNetPointer(java.lang.String ptr)
static void	deduceMissingLinks() Use the WordNet hyper-/hypo-nym links to deduce a likely link for a SUMO term that has not yet been manually linked.
static void	extractMeronyms() A utility to extract meronym relations as relations between SUMO terms.
static java.lang.String	formatWords(java.util.TreeMap<java.lang.String,java.lang.String> words, java.lang.String kbName) HTML format a TreeMap of word senses and their associated synset
static java.lang.String	formatWordsList(java.util.TreeMap<java.lang.String,java.util.ArrayList<java.lang.String>> words, java.lang.String kbName) HTML format a TreeMap of ArrayLists word senses
static java.lang.String	getBareSUMOTerm(java.lang.String term) Get a SUMO term minus its &% prefix and one character mapping suffix.
static java.lang.String	getPOSfromKey(java.lang.String senseKey) Extract the POS from a word_POS_num sense key.
static char	getSUMOMappingSuffix(java.lang.String term) Get a SUMO term mapping suffix.
static java.lang.String	getWordFromKey(java.lang.String senseKey) Extract the POS from a word_POS_num sense key
void	imageNetLinks() Import links from www.image-net.org that are linked to WordNet and links them to SUMO terms when the synset has a directly equivalent SUMO term
static void	main(java.lang.String[] args) A main method, used only for testing.
static java.lang.String	mappingCharToName(char mappingType)
static void	mergeUpdates() Read in a file with a nine-digit synset number followed by a space and a SUMO term.
static java.lang.String	posLettersToNumber(java.lang.String pos) Convert a part of speech number to the two letter format used by the WordNet sense index code.
static char	posLetterToNumber(char POS)
static char	posNumberToLetter(char POS)
static java.lang.String	posNumberToLetters(java.lang.String pos) Convert a part of speech number to the two letter format used by the WordNet sense index code.
static java.lang.String	printStatistics()
static void	processMissingLinks(java.lang.String fileName, java.lang.String pattern, java.lang.String posNum) This is a utility routine that should not be called during normal Sigma operation.
static java.lang.String	removeTermPrefixes(java.lang.String formula)
static void	searchCoherence(java.lang.String fileWithPath) Take a file of tabtab and calculate the average Levenshtein distance for each ID.
static int	sensePOS(java.lang.String sense) Take a WordNet sense identifier, and return the integer part of speech code.
static java.lang.String	subst(java.lang.String result, java.lang.String match, java.lang.String subst) A utility function that mimics the functionality of the perl substitution feature (s/match/replacement/).
static boolean	substTest(java.lang.String result, java.lang.String match, java.lang.String subst, java.util.Hashtable<java.lang.String,java.lang.String> hash) A utility function that mimics the functionality of the perl substitution feature (s/match/replacement/) but rather than returning the result of the substitution, just tests whether the result is a key in a hashtable.
void	updateWNversion() Port the mappings from one version of WordNet to another.
void	updateWNversionProcess(java.lang.String fileName, java.lang.String pattern, java.lang.String posNum) This is a utility routine that should not be called during normal Sigma operation.
void	updateWNversionReading(java.lang.String fileName, java.lang.String pattern, java.lang.String posNum) Read the version mapping files and store in the HashMap called "mappings".
static java.lang.String	verbPlural(java.lang.String verb) Return the plural form of the verb.
static void	writeTPTPWordNet(java.io.PrintWriter pw) Write TPTP format for WordNet

Methods inherited from class java.lang.Object

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

Field Detail

TPTPidCounter

public static int TPTPidCounter

WordNetRelations

protected static java.util.ArrayList<java.lang.String> WordNetRelations

Constructor Detail

WordNetUtilities

public WordNetUtilities()

Method Detail

getBareSUMOTerm

public static java.lang.String getBareSUMOTerm(java.lang.String term)

Get a SUMO term minus its &% prefix and one character mapping suffix.

getPOSfromKey

public static java.lang.String getPOSfromKey(java.lang.String senseKey)

Extract the POS from a word_POS_num sense key. Should be an alpha key, such as "VB".

getWordFromKey

public static java.lang.String getWordFromKey(java.lang.String senseKey)

Extract the POS from a word_POS_num sense key

removeTermPrefixes

public static java.lang.String removeTermPrefixes(java.lang.String formula)

convertTermList

public static java.util.ArrayList<java.lang.String> convertTermList(java.lang.String termList)

Convert a list of Terms in the format "&%term1 &%term2" to an ArrayList of bare term Strings

getSUMOMappingSuffix

public static char getSUMOMappingSuffix(java.lang.String term)

Get a SUMO term mapping suffix.

convertWordNetPointer

public static java.lang.String convertWordNetPointer(java.lang.String ptr)

posLetterToNumber

public static char posLetterToNumber(char POS)

posNumberToLetter

public static char posNumberToLetter(char POS)

posNumberToLetters

public static java.lang.String posNumberToLetters(java.lang.String pos)

Convert a part of speech number to the two letter format used by the WordNet sense index code. Defaults to noun "NN".

posLettersToNumber

public static java.lang.String posLettersToNumber(java.lang.String pos)

Convert a part of speech number to the two letter format used by the WordNet sense index code. Defaults to noun "NN".

sensePOS

public static int sensePOS(java.lang.String sense)

Take a WordNet sense identifier, and return the integer part of speech code.

mappingCharToName

public static java.lang.String mappingCharToName(char mappingType)

subst

public static java.lang.String subst(java.lang.String result,
                                     java.lang.String match,
                                     java.lang.String subst)

A utility function that mimics the functionality of the perl substitution feature (s/match/replacement/). Note that only one replacement is made, not a global replacement.

Parameters:

result - is the string on which the substitution is performed.

match - is the substring to be found and replaced.

subst - is the string replacement for match.

Returns:

is a String containing the result of the substitution.

substTest

public static boolean substTest(java.lang.String result,
                                java.lang.String match,
                                java.lang.String subst,
                                java.util.Hashtable<java.lang.String,java.lang.String> hash)

A utility function that mimics the functionality of the perl substitution feature (s/match/replacement/) but rather than returning the result of the substitution, just tests whether the result is a key in a hashtable. Note that only one replacement is made, not a global replacement.

Parameters:

result - is the string on which the substitution is performed.

match - is the substring to be found and replaced.

subst - is the string replacement for match.

hash - is a hashtable to be checked against the result.

Returns:

is a boolean indicating whether the result of the substitution was found in the hashtable.

verbPlural

public static java.lang.String verbPlural(java.lang.String verb)

Return the plural form of the verb. Handle multi-word phrases to modify only the first word.

formatWords

public static java.lang.String formatWords(java.util.TreeMap<java.lang.String,java.lang.String> words,
                                           java.lang.String kbName)

HTML format a TreeMap of word senses and their associated synset

formatWordsList

public static java.lang.String formatWordsList(java.util.TreeMap<java.lang.String,java.util.ArrayList<java.lang.String>> words,
                                               java.lang.String kbName)

HTML format a TreeMap of ArrayLists word senses

mergeUpdates

public static void mergeUpdates()
                         throws java.io.IOException

Read in a file with a nine-digit synset number followed by a space and a SUMO term. If the term is more specific than the current mapping for that synset, replace the old term. This is a utility that is not normally called from the interactive Sigma system.

Throws:

java.io.IOException

processMissingLinks

public static void processMissingLinks(java.lang.String fileName,
                                       java.lang.String pattern,
                                       java.lang.String posNum)
                                throws java.io.IOException

This is a utility routine that should not be called during normal Sigma operation. It does most of the actual work for deduceMissingLinks()

Throws:

java.io.IOException

deduceMissingLinks

public static void deduceMissingLinks()
                               throws java.io.IOException

Use the WordNet hyper-/hypo-nym links to deduce a likely link for a SUMO term that has not yet been manually linked. This is a utility routine that should not be called during normal Sigma operation.

Throws:

java.io.IOException

updateWNversionProcess

public void updateWNversionProcess(java.lang.String fileName,
                                   java.lang.String pattern,
                                   java.lang.String posNum)
                            throws java.io.IOException

This is a utility routine that should not be called during normal Sigma operation. It does most of the actual work for updateWNversion(). The output is a set of WordNet data files with a "-new" suffix.

Throws:

java.io.IOException

updateWNversionReading

public void updateWNversionReading(java.lang.String fileName,
                                   java.lang.String pattern,
                                   java.lang.String posNum)
                            throws java.io.IOException

Read the version mapping files and store in the HashMap called "mappings".

Throws:

java.io.IOException

updateWNversion

public void updateWNversion()
                     throws java.io.IOException

Port the mappings from one version of WordNet to another. It calls updateWNversionReading to do most of the work. It assumes that the mapping file has the new synset first and the old one second. File names are for the new WordNet version, which will need to have different names from the old version that WordNet.java needs to read in order to get the existing mappings. This is a utility which should not be called during normal Sigma operation. Mapping files are in a simple format produced by University of Catalonia and available at http://www.lsi.upc.edu/~nlp/web/index.php?option=com_content&task=view&id=21&Itemid=57 If that address changes you may also start at http://www.lsi.upc.edu/~nlp/web/ and go to Resources and then an item on WordNet mappings.

Throws:

java.io.IOException

printStatistics

public static java.lang.String printStatistics()

imageNetLinks

public void imageNetLinks()
                   throws java.io.IOException

Import links from www.image-net.org that are linked to WordNet and links them to SUMO terms when the synset has a directly equivalent SUMO term

Throws:

java.io.IOException

extractMeronyms

public static void extractMeronyms()

A utility to extract meronym relations as relations between SUMO terms. Filter out relations between genus and species, which shouldn't be meronyms

searchCoherence

public static void searchCoherence(java.lang.String fileWithPath)

Take a file of tabtab and calculate the average Levenshtein distance for each ID.

commentSentiment

public static void commentSentiment(java.lang.String fileWithPath)

Take a file of tabtab and calculate the average Levenshtein distance for each ID.

writeTPTPWordNet

public static void writeTPTPWordNet(java.io.PrintWriter pw)
                             throws java.io.IOException

Write TPTP format for WordNet

Throws:

java.io.IOException

main

public static void main(java.lang.String[] args)

A main method, used only for testing. It should not be called during normal operation.