fr.univnantes.termsuite.alignment

Class BilingualAlignmentService

java.lang.Object

fr.univnantes.termsuite.alignment.BilingualAlignmentService

public class BilingualAlignmentService
extends java.lang.Object

Field Summary

Fields

Modifier and Type	Field and Description
static int	TRANSLATION_STRATEGY_MOST_FREQUENT
static int	TRANSLATION_STRATEGY_MOST_SPECIFIC
static int	TRANSLATION_STRATEGY_PRORATA

Constructor Summary

Constructors

Constructor and Description
BilingualAlignmentService()

Method Summary

Modifier and Type	Method and Description
BilingualAlignmentService	addTranslation(java.lang.String sourceLemma, java.lang.String targetLemma)
BilingualAlignmentService	addTranslation(Term sourceTerm, Term targetTerm)
java.util.List<TranslationCandidate>	align(Term sourceTerm, int nbCandidates, int minCandidateFrequency) Runs bilingual alignment on a source term.
java.util.List<TranslationCandidate>	alignCompositional(TermService sourceTerm, int nbCandidates, int minCandidateFrequency)
java.util.List<TranslationCandidate>	alignCompositionalSize2(TermService lemmaTerm1, TermService lemmaTerm2, int nbCandidates, int minCandidateFrequency, TermService sourceTerm)
java.util.List<TranslationCandidate>	alignDico(TermService sourceTerm, int nbCandidates)
java.util.List<TranslationCandidate>	alignDicoThenDistributional(TermService sourceTerm, int nbCandidates, int minCandidateFrequency) Translates the source term with the help of the dictionary and computes the list of contextSize closest candidate terms in the target terminology.
java.util.List<TranslationCandidate>	alignDistributional(TermService sourceTerm, int nbCandidates, int minCandidateFrequency)
java.util.List<TranslationCandidate>	alignGraphically(AlignmentMethod method, TermService sourceTerm, int nbCandidates, java.util.Collection<TermService> targetTerms)
java.util.List<TranslationCandidate>	alignNeoclassical(Term sourceTerm, int nbCandidates, int minCandidateFrequency)
java.util.List<TranslationCandidate>	alignNeoclassical(TermService sourceTerm, int nbCandidates, int minCandidateFrequency) Align a term using the TermSuite's neoclassical alignment method.
java.util.List<TranslationCandidate>	alignSemiDistributional(TermService sourceTerm, int nbCandidates, int minCandidateFrequency)
java.util.List<TranslationCandidate>	alignSemiDistributionalSize2Syntagmatic(TermService lemmaTerm1, TermService lemmaTerm2, int nbCandidates, int minCandidateFrequency, TermService sourceTerm)
java.util.List<TranslationCandidate>	alignSize2(Term sourceTerm, int nbCandidates, int minCandidateFrequency)
java.util.List<TranslationCandidate>	alignSize2(TermService sourceTerm, int nbCandidates, int minCandidateFrequency) alias for #align(Term, int, int, true)
java.util.List<TranslationCandidate>	alignSize2(TermService sourceTerm, int nbCandidates, int minCandidateFrequency, boolean allowDistributionalAlignment)
boolean	canAlignCompositional(TermService sourceTerm)
boolean	canAlignNeoclassical(TermService sourceTerm)
boolean	canAlignSemiDistributional(TermService sourceTerm)
BilingualDictionary	getDico()
java.util.Collection<Term>	getMorphologicalExtensionsAsTerms(TermIndex lemmaLowerCaseIndex, TermService compound, Component component) E.g.
java.util.List<java.util.List<TermService>>	getSourceSingleLemmaTerms(TermService term) Gives the list of all possible single lemma terms decompositino for a complex term.
static java.util.Set<Term>	getSwtSetFromComponent(TermIndex lemmaLowerCaseIndex, Component c)
ContextVector	translateVector(ContextVector sourceVector, BilingualDictionary dictionary, int translationStrategy, TerminologyService targetTermino) Translates all ContextVector components (i.e. its coTerms) into the target language of this aligner by the mean of one of the available strategy : - TRANSLATION_STRATEGY_MOST_FREQUENT - TRANSLATION_STRATEGY_PRORATA - TRANSLATION_STRATEGY_EQUI_REPARTITION - TRANSLATION_STRATEGY_MOST_SPECIFIC

Methods inherited from class java.lang.Object

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

Field Detail

TRANSLATION_STRATEGY_PRORATA

public static final int TRANSLATION_STRATEGY_PRORATA

See Also:

Constant Field Values

TRANSLATION_STRATEGY_MOST_FREQUENT

public static final int TRANSLATION_STRATEGY_MOST_FREQUENT

See Also:

Constant Field Values

TRANSLATION_STRATEGY_MOST_SPECIFIC

public static final int TRANSLATION_STRATEGY_MOST_SPECIFIC

See Also:

Constant Field Values

Constructor Detail

BilingualAlignmentService

public BilingualAlignmentService()

Method Detail

addTranslation

public BilingualAlignmentService addTranslation(Term sourceTerm,
                                                Term targetTerm)

addTranslation

public BilingualAlignmentService addTranslation(java.lang.String sourceLemma,
                                                java.lang.String targetLemma)

Parameters:

sourceLemma -

targetLemmas -

Returns:

alignDicoThenDistributional

public java.util.List<TranslationCandidate> alignDicoThenDistributional(TermService sourceTerm,
                                                                        int nbCandidates,
                                                                        int minCandidateFrequency)

Translates the source term with the help of the dictionary and computes the list of contextSize closest candidate terms in the target terminology. sourceTerm's context vector must be computed and normalized, as well as all terms' context vectors in the target term index.

Parameters:

sourceTerm - the term to align with target term index

nbCandidates - the number of TranslationCandidate to return in the returned list

minCandidateFrequency - the minimum frequency of a target candidate

Returns:

A sorted list of TranslationCandidate sorted by distance desc. Each TranslationCandidate is a container for a target term index's term and its translation score.

canAlignNeoclassical

public boolean canAlignNeoclassical(TermService sourceTerm)

alignNeoclassical

public java.util.List<TranslationCandidate> alignNeoclassical(Term sourceTerm,
                                                              int nbCandidates,
                                                              int minCandidateFrequency)

alignNeoclassical

public java.util.List<TranslationCandidate> alignNeoclassical(TermService sourceTerm,
                                                              int nbCandidates,
                                                              int minCandidateFrequency)

Align a term using the TermSuite's neoclassical alignment method. This method behaves as follows:

Parameters:

sourceTerm - the source term to align

nbCandidates - the maximum number of TranslationCandidate returned

minCandidateFrequency - the minimum frequency of returned translation candidates

Returns:

the sorted list TranslationCandidate produced by this method or an empty list if the term could not be aligned using the neoclassical method.

See Also:

#canAlignNeoclassical(Term), CompoundType.NEOCLASSICAL

getMorphologicalExtensionsAsTerms

public java.util.Collection<Term> getMorphologicalExtensionsAsTerms(TermIndex lemmaLowerCaseIndex,
                                                                    TermService compound,
                                                                    Component component)

E.g. Given the compound [hydro|électricité] and the component [hydro], the method should return the term [électricité]

Parameters:

termino -

compound -

component -

Returns:

alignGraphically

public java.util.List<TranslationCandidate> alignGraphically(AlignmentMethod method,
                                                             TermService sourceTerm,
                                                             int nbCandidates,
                                                             java.util.Collection<TermService> targetTerms)

alignDistributional

public java.util.List<TranslationCandidate> alignDistributional(TermService sourceTerm,
                                                                int nbCandidates,
                                                                int minCandidateFrequency)

align

public java.util.List<TranslationCandidate> align(Term sourceTerm,
                                                  int nbCandidates,
                                                  int minCandidateFrequency)

Runs bilingual alignment on a source term.

Parameters:

sourceTerm - The source term to align

nbCandidates - The maximum number of target translation candidates

minCandidateFrequency - The minimum frequency allowed for target translation candidates

Returns:

A ranked list of TranslationCandidate

alignSize2

public java.util.List<TranslationCandidate> alignSize2(Term sourceTerm,
                                                       int nbCandidates,
                                                       int minCandidateFrequency)

alignSize2

public java.util.List<TranslationCandidate> alignSize2(TermService sourceTerm,
                                                       int nbCandidates,
                                                       int minCandidateFrequency)

alias for #align(Term, int, int, true)

Parameters:

sourceTerm -

nbCandidates -

minCandidateFrequency -

Returns:

alignSize2

public java.util.List<TranslationCandidate> alignSize2(TermService sourceTerm,
                                                       int nbCandidates,
                                                       int minCandidateFrequency,
                                                       boolean allowDistributionalAlignment)

Parameters:

sourceTerm -

nbCandidates -

minCandidateFrequency -

allowDistributionalAlignment -

Returns:

alignDico

public java.util.List<TranslationCandidate> alignDico(TermService sourceTerm,
                                                      int nbCandidates)

canAlignCompositional

public boolean canAlignCompositional(TermService sourceTerm)

alignCompositional

public java.util.List<TranslationCandidate> alignCompositional(TermService sourceTerm,
                                                               int nbCandidates,
                                                               int minCandidateFrequency)

canAlignSemiDistributional

public boolean canAlignSemiDistributional(TermService sourceTerm)

alignSemiDistributional

public java.util.List<TranslationCandidate> alignSemiDistributional(TermService sourceTerm,
                                                                    int nbCandidates,
                                                                    int minCandidateFrequency)

alignCompositionalSize2

public java.util.List<TranslationCandidate> alignCompositionalSize2(TermService lemmaTerm1,
                                                                    TermService lemmaTerm2,
                                                                    int nbCandidates,
                                                                    int minCandidateFrequency,
                                                                    TermService sourceTerm)

alignSemiDistributionalSize2Syntagmatic

public java.util.List<TranslationCandidate> alignSemiDistributionalSize2Syntagmatic(TermService lemmaTerm1,
                                                                                    TermService lemmaTerm2,
                                                                                    int nbCandidates,
                                                                                    int minCandidateFrequency,
                                                                                    TermService sourceTerm)

getDico

public BilingualDictionary getDico()

translateVector

public ContextVector translateVector(ContextVector sourceVector,
                                     BilingualDictionary dictionary,
                                     int translationStrategy,
                                     TerminologyService targetTermino)

Translates all ContextVector components (i.e. its coTerms) into the target language of this aligner by the mean of one of the available strategy : - TRANSLATION_STRATEGY_MOST_FREQUENT - TRANSLATION_STRATEGY_PRORATA - TRANSLATION_STRATEGY_EQUI_REPARTITION - TRANSLATION_STRATEGY_MOST_SPECIFIC

Parameters:

sourceVector - The source context vector object to be translated into target language

dictionary - The dico used in the translation process

translationStrategy - The translation strategy of the sourceVector. Two possible values: TRANSLATION_STRATEGY_MOST_FREQUENT TRANSLATION_STRATEGY_PRORATA TRANSLATION_STRATEGY_EQUI_REPARTITION TRANSLATION_STRATEGY_MOST_SPECIFIC

Returns:

The translated context vector

See Also:

BilingualDictionary

getSourceSingleLemmaTerms

public java.util.List<java.util.List<TermService>> getSourceSingleLemmaTerms(TermService term)

Gives the list of all possible single lemma terms decompositino for a complex term.

Parameters:

termino -

term -

Returns:

getSwtSetFromComponent

public static java.util.Set<Term> getSwtSetFromComponent(TermIndex lemmaLowerCaseIndex,
                                                         Component c)