it.uniroma2.sag.kelp.data.representation.structure.similarity.compositional

Class CompositionalNodeSimilarity

java.lang.Object

it.uniroma2.sag.kelp.data.representation.structure.similarity.VectorBasedStructureElementSimilarity

it.uniroma2.sag.kelp.data.representation.structure.similarity.LexicalStructureElementSimilarity

it.uniroma2.sag.kelp.data.representation.structure.similarity.compositional.CompositionalNodeSimilarity

All Implemented Interfaces:

StructureElementSimilarityI

Direct Known Subclasses:

CompositionalNodeSimilarityDilation, CompositionalNodeSimilarityProduct, CompositionalNodeSimilaritySum

public abstract class CompositionalNodeSimilarity
extends LexicalStructureElementSimilarity

This class implements a specific node similarity that computes the similarity between compositional nodes, by applying the "sum" operator.

For more details:
[Annesi et al(2014)] Paolo Annesi, Danilo Croce, Roberto Basili (2014) Semantic Compositionality in Tree Kernels. In: Proceedings of the 23rd ACM International Conference on Conference on Information and Knowledge Management

Author:

Giuseppe Castellucci

Field Summary

Fields

Modifier and Type	Field and Description
protected String	enrichmentName

Fields inherited from class it.uniroma2.sag.kelp.data.representation.structure.similarity.VectorBasedStructureElementSimilarity

VECTOR_NAME

Constructor Summary

Constructors

Constructor and Description
CompositionalNodeSimilarity() Default constructor, used only for JSON serialization/deserialization purposes.
CompositionalNodeSimilarity(WordspaceI wordspace) Constructor that enable to specify the wordspace path.
CompositionalNodeSimilarity(WordspaceI wordspace, boolean posRestriction, boolean syntacticRestriction) Constructor that enable to specify the wordspace path.

Method Summary

Methods

Modifier and Type	Method and Description
abstract Vector	getCompositionalInformationFor(LexicalStructureElement head, LexicalStructureElement modifier) This method takes in input two LexicalStructureElement representing a head and a modifier.
String	getEnrichmentName() Returns the identifier of the vectors associated to a StructureElement during the manipulation operation performed by a Manipulator (i.e.
protected abstract float	getScore(CompositionalStructureElement csx, CompositionalStructureElement csz)
boolean	isPosRestriction()
boolean	isSyntacticRestriction()
void	setEnrichmentName(String enrichmentName) Sets the identifier of the vectors associated to a StructureElement during the manipulation operation performed by a Manipulator (i.e.
void	setPosRestriction(boolean posRestriction)
void	setSyntacticRestriction(boolean syntacticRestriction)
float	sim(StructureElement sx, StructureElement sz) This method computes the similarity between two compositional nodes by applying the "sum" operator.

Methods inherited from class it.uniroma2.sag.kelp.data.representation.structure.similarity.LexicalStructureElementSimilarity

getAllowDifferentPOS, getIgnorePosInLemmaMatches, setAllowDifferentPOS, setIgnorePosInLemmaMatches

Methods inherited from class it.uniroma2.sag.kelp.data.representation.structure.similarity.VectorBasedStructureElementSimilarity

getCorrespondingVector, getKernel, getSimilarity, getWordspace, setKernel, setWordspace

Methods inherited from class java.lang.Object

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

Field Detail

enrichmentName

protected String enrichmentName

Constructor Detail

CompositionalNodeSimilarity

public CompositionalNodeSimilarity()

Default constructor, used only for JSON serialization/deserialization purposes.

CompositionalNodeSimilarity

public CompositionalNodeSimilarity(WordspaceI wordspace)
                            throws NumberFormatException,
                                   IOException

Constructor that enable to specify the wordspace path. The kernel applied to compute the inner product is the one obtained through the getDefaultKernel method. posRestriction parameter is set to true. syntacticRestriction parameter is set to false.

Parameters:

matrixPath - The path of the Word Space to be loaded

Throws:

NumberFormatException

IOException

CompositionalNodeSimilarity

public CompositionalNodeSimilarity(WordspaceI wordspace,
                           boolean posRestriction,
                           boolean syntacticRestriction)
                            throws NumberFormatException,
                                   IOException

Constructor that enable to specify the wordspace path. The kernel applied to compute the inner product is the one obtained through the getDefaultKernel method.

Parameters:

matrixPath - The path of the Word Space to be loaded.

posRestriction - if true, two nodes will be compared only if heads and modifiers of these nodes will match.

syntacticRestriction - if true, two nodes will be compared only if the dependency relation of these will match.

Throws:

FileNotFoundException

IOException

NumberFormatException

Method Detail

setEnrichmentName

public void setEnrichmentName(String enrichmentName)

Description copied from class: VectorBasedStructureElementSimilarity

Sets the identifier of the vectors associated to a StructureElement during the manipulation operation performed by a Manipulator (i.e. LexicalStructureElementEnricher) This manipulation optimize the similarity evaluation cause it avoids retrieving vectors from the wordspaces

Overrides:

setEnrichmentName in class VectorBasedStructureElementSimilarity

Parameters:

enrichmentName - the enrichmentName to set

getEnrichmentName

public String getEnrichmentName()

Description copied from class: VectorBasedStructureElementSimilarity

Returns the identifier of the vectors associated to a StructureElement during the manipulation operation performed by a Manipulator (i.e. LexicalStructureElementEnricher)

Overrides:

getEnrichmentName in class VectorBasedStructureElementSimilarity

Returns:

the enrichmentName

isPosRestriction

public boolean isPosRestriction()

Returns:

the posRestriction

setPosRestriction

public void setPosRestriction(boolean posRestriction)

Parameters:

posRestriction - the posRestriction to set

isSyntacticRestriction

public boolean isSyntacticRestriction()

Returns:

the syntacticRestriction

setSyntacticRestriction

public void setSyntacticRestriction(boolean syntacticRestriction)

Parameters:

syntacticRestriction - the syntacticRestriction to set

sim

public float sim(StructureElement sx,
        StructureElement sz)

This method computes the similarity between two compositional nodes by applying the "sum" operator.

Specified by:

sim in interface StructureElementSimilarityI

Overrides:

sim in class LexicalStructureElementSimilarity

Parameters:

sx - the first structure element

sz - the second structure element

Returns:

the similarity between two structure elements

getScore

protected abstract float getScore(CompositionalStructureElement csx,
             CompositionalStructureElement csz)

getCompositionalInformationFor

public abstract Vector getCompositionalInformationFor(LexicalStructureElement head,
                                    LexicalStructureElement modifier)

This method takes in input two LexicalStructureElement representing a head and a modifier. It returns an Example that contains a representation, whose name is VECTOR_NAME, containing the sum of the two vector representations of the head and modifier. In case of missing head, the resulting composition is obtained by copying the modifier in the head. In case of missing modifier, the resulting composition is obtained by copying the head in the modifier. In case of missing head and modifier, the method returns null.

Parameters:

head -

modifier -

ws - the StructureElementSimilarityWordSpace used to retrieve the vector representations of head and modifiers.

Returns:

the compositional Vector