net.sf.extjwnl.data.mcr30.alignment

Class InterLingualIndex

java.lang.Object

net.sf.extjwnl.data.mcr30.alignment.InterLingualIndex

public class InterLingualIndex
extends java.lang.Object

Singleton class for loading dictionaries for different languages and mapping word senses between them. This class and the mappers returned by it are safe for access by multiple threads concurrently.

Note that this class loads resource files into memory on demand for mapping purposes, and once loaded, they are never unloaded.

Constructor Summary

Constructors

Constructor and Description
InterLingualIndex()

Method Summary

Modifier and Type	Method and Description
static Dictionary	getDictionary(java.lang.String wordnetSource, java.lang.String languageCode) Gets a dictionary for a language from a known prepackaged source.
static SynsetMapper	loadMapper(Dictionary sourceDictionary, Dictionary targetDictionary) Loads a mapper from one dictionary to another, automatically using the correct interlingual index (if one is available) for word sense alignment.
static Synset	mapSynset(Synset sourceSynset, Dictionary targetDictionary) Maps a synset from one dictionary to another, automatically using the correct interlingual index (if one is available) for word sense alignment.

Methods inherited from class java.lang.Object

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

Constructor Detail

InterLingualIndex

public InterLingualIndex()

Method Detail

getDictionary

public static Dictionary getDictionary(java.lang.String wordnetSource,
                                       java.lang.String languageCode)
                                throws JWNLException

Gets a dictionary for a language from a known prepackaged source.

Parameters:

wordnetSource - one of

• wn31: Princeton WordNet 3.1
• wn31/map: Princeton WordNet 3.1 (via serialized form)
• wn30: Princeton WordNet 3.0
• wn21: Princeton WordNet 2.1
• mcr30: Multilingual Central Repository (MCR) 3.0

languageCode - ISO 639-3 three-letter language code, e.g. eng or spa

Returns:

loaded dictionary

Throws:

JWNLException - if dictionary unknown or resource unavailable

mapSynset

public static Synset mapSynset(Synset sourceSynset,
                               Dictionary targetDictionary)
                        throws JWNLException

Maps a synset from one dictionary to another, automatically using the correct interlingual index (if one is available) for word sense alignment.

Parameters:

sourceSynset - the synset to be mapped from the source dictionary

targetDictionary - the target dictionary into which sourceSynset should be mapped

Returns:

the synset corresponding to sourceSynset in the target dictionary, or null if no mapping is available

Throws:

JWNLException - if mapping or dictionary resources unavailable or could not be accessed

loadMapper

public static SynsetMapper loadMapper(Dictionary sourceDictionary,
                                      Dictionary targetDictionary)
                               throws JWNLException

Loads a mapper from one dictionary to another, automatically using the correct interlingual index (if one is available) for word sense alignment. The mapper can be used over and over to translate different synsets.

Parameters:

sourceDictionary - the source dictionary from which synsets will be mapped

targetDictionary - the target dictionary into which synsets will be mapped

Returns:

the loaded SynsetMapper

Throws:

JWNLException - if mapping or dictionary resources unavailable or could not be accessed