org.deeplearning4j.models.word2vec

Class StaticWord2Vec

java.lang.Object

org.deeplearning4j.models.word2vec.StaticWord2Vec

All Implemented Interfaces:

java.io.Serializable, WordVectors

public class StaticWord2Vec
extends java.lang.Object
implements WordVectors

This is special limited Word2Vec implementation, suited for serving as lookup table in concurrent multi-gpu environment This implementation DOES NOT load all vectors onto any of gpus, instead of that it holds vectors in, optionally, compressed state in host memory. This implementation DOES NOT provide some of original Word2Vec methods, such as wordsNearest or wordsNearestSum.

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	StaticWord2Vec.Builder

Method Summary

Modifier and Type	Method and Description
java.util.Map<java.lang.String,java.lang.Double>	accuracy(java.util.List<java.lang.String> questions) Accuracy based on questions which are a space separated list of strings where the first word is the query word, the next 2 words are negative, and the last word is the predicted word to be nearest PLEASE NOTE: This method is not available in this implementation.
java.lang.String	getUNK()
double[]	getWordVector(java.lang.String word) Get the word vector for a given matrix
org.nd4j.linalg.api.ndarray.INDArray	getWordVectorMatrix(java.lang.String word) Get the word vector for a given matrix
org.nd4j.linalg.api.ndarray.INDArray	getWordVectorMatrixNormalized(java.lang.String word) Returns the word vector divided by the norm2 of the array
org.nd4j.linalg.api.ndarray.INDArray	getWordVectors(java.util.Collection<java.lang.String> labels) This method returns 2D array, where each row represents corresponding word/label
org.nd4j.linalg.api.ndarray.INDArray	getWordVectorsMean(java.util.Collection<java.lang.String> labels) This method returns mean vector, built from words/labels passed in
boolean	hasWord(java.lang.String word) Returns true if the model has this word in the vocab
int	indexOf(java.lang.String word)
protected void	init() Init method validates configuration defined using
WeightLookupTable	lookupTable() Lookup table for the vectors PLEASE NOTE: This method is not available in this implementation.
void	setModelUtils(ModelUtils utils) Specifies ModelUtils to be used to access model PLEASE NOTE: This method has no effect in this implementation.
void	setUNK(java.lang.String newUNK)
double	similarity(java.lang.String label1, java.lang.String label2) Returns the similarity of 2 words
java.util.List<java.lang.String>	similarWordsInVocabTo(java.lang.String word, double accuracy) Find all words with a similar characters in the vocab PLEASE NOTE: This method is not available in this implementation.
VocabCache	vocab() Vocab for the vectors
java.util.Collection<java.lang.String>	wordsNearest(java.util.Collection<java.lang.String> positive, java.util.Collection<java.lang.String> negative, int top) Words nearest based on positive and negative words PLEASE NOTE: This method is not available in this implementation.
java.util.Collection<java.lang.String>	wordsNearest(org.nd4j.linalg.api.ndarray.INDArray words, int top)
java.util.Collection<java.lang.String>	wordsNearest(java.lang.String word, int n) Get the top n words most similar to the given word PLEASE NOTE: This method is not available in this implementation.
java.util.Collection<java.lang.String>	wordsNearestSum(java.util.Collection<java.lang.String> positive, java.util.Collection<java.lang.String> negative, int top) Words nearest based on positive and negative words PLEASE NOTE: This method is not available in this implementation.
java.util.Collection<java.lang.String>	wordsNearestSum(org.nd4j.linalg.api.ndarray.INDArray words, int top)
java.util.Collection<java.lang.String>	wordsNearestSum(java.lang.String word, int n) Get the top n words most similar to the given word PLEASE NOTE: This method is not available in this implementation.

Methods inherited from class java.lang.Object

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

Method Detail

getUNK

public java.lang.String getUNK()

Specified by:

getUNK in interface WordVectors

setUNK

public void setUNK(java.lang.String newUNK)

Specified by:

setUNK in interface WordVectors

init

protected void init()

Init method validates configuration defined using

hasWord

public boolean hasWord(java.lang.String word)

Returns true if the model has this word in the vocab

Specified by:

hasWord in interface WordVectors

Parameters:

word - the word to test for

Returns:

true if the model has the word in the vocab

wordsNearest

public java.util.Collection<java.lang.String> wordsNearest(org.nd4j.linalg.api.ndarray.INDArray words,
                                                           int top)

Specified by:

wordsNearest in interface WordVectors

wordsNearestSum

public java.util.Collection<java.lang.String> wordsNearestSum(org.nd4j.linalg.api.ndarray.INDArray words,
                                                              int top)

Specified by:

wordsNearestSum in interface WordVectors

wordsNearestSum

public java.util.Collection<java.lang.String> wordsNearestSum(java.lang.String word,
                                                              int n)

Get the top n words most similar to the given word PLEASE NOTE: This method is not available in this implementation.

Specified by:

wordsNearestSum in interface WordVectors

Parameters:

word - the word to compare

n - the n to get

Returns:

the top n words

wordsNearestSum

public java.util.Collection<java.lang.String> wordsNearestSum(java.util.Collection<java.lang.String> positive,
                                                              java.util.Collection<java.lang.String> negative,
                                                              int top)

Words nearest based on positive and negative words PLEASE NOTE: This method is not available in this implementation.

Specified by:

wordsNearestSum in interface WordVectors

Parameters:

positive - the positive words

negative - the negative words

top - the top n words

Returns:

the words nearest the mean of the words

accuracy

public java.util.Map<java.lang.String,java.lang.Double> accuracy(java.util.List<java.lang.String> questions)

Accuracy based on questions which are a space separated list of strings where the first word is the query word, the next 2 words are negative, and the last word is the predicted word to be nearest PLEASE NOTE: This method is not available in this implementation.

Specified by:

accuracy in interface WordVectors

Parameters:

questions - the questions to ask

Returns:

the accuracy based on these questions

indexOf

public int indexOf(java.lang.String word)

Specified by:

indexOf in interface WordVectors

similarWordsInVocabTo

public java.util.List<java.lang.String> similarWordsInVocabTo(java.lang.String word,
                                                              double accuracy)

Find all words with a similar characters in the vocab PLEASE NOTE: This method is not available in this implementation.

Specified by:

similarWordsInVocabTo in interface WordVectors

Parameters:

word - the word to compare

accuracy - the accuracy: 0 to 1

Returns:

the list of words that are similar in the vocab

getWordVector

public double[] getWordVector(java.lang.String word)

Get the word vector for a given matrix

Specified by:

getWordVector in interface WordVectors

Parameters:

word - the word to get the matrix for

Returns:

the ndarray for this word

getWordVectorMatrixNormalized

public org.nd4j.linalg.api.ndarray.INDArray getWordVectorMatrixNormalized(java.lang.String word)

Returns the word vector divided by the norm2 of the array

Specified by:

getWordVectorMatrixNormalized in interface WordVectors

Parameters:

word - the word to get the matrix for

Returns:

the looked up matrix

getWordVectorMatrix

public org.nd4j.linalg.api.ndarray.INDArray getWordVectorMatrix(java.lang.String word)

Get the word vector for a given matrix

Specified by:

getWordVectorMatrix in interface WordVectors

Parameters:

word - the word to get the matrix for

Returns:

the ndarray for this word

getWordVectors

public org.nd4j.linalg.api.ndarray.INDArray getWordVectors(java.util.Collection<java.lang.String> labels)

This method returns 2D array, where each row represents corresponding word/label

Specified by:

getWordVectors in interface WordVectors

Parameters:

labels -

Returns:

getWordVectorsMean

public org.nd4j.linalg.api.ndarray.INDArray getWordVectorsMean(java.util.Collection<java.lang.String> labels)

This method returns mean vector, built from words/labels passed in

Specified by:

getWordVectorsMean in interface WordVectors

Parameters:

labels -

Returns:

wordsNearest

public java.util.Collection<java.lang.String> wordsNearest(java.util.Collection<java.lang.String> positive,
                                                           java.util.Collection<java.lang.String> negative,
                                                           int top)

Words nearest based on positive and negative words PLEASE NOTE: This method is not available in this implementation.

Specified by:

wordsNearest in interface WordVectors

Parameters:

positive - the positive words

negative - the negative words

top - the top n words

Returns:

the words nearest the mean of the words

wordsNearest

public java.util.Collection<java.lang.String> wordsNearest(java.lang.String word,
                                                           int n)

Get the top n words most similar to the given word PLEASE NOTE: This method is not available in this implementation.

Specified by:

wordsNearest in interface WordVectors

Parameters:

word - the word to compare

n - the n to get

Returns:

the top n words

similarity

public double similarity(java.lang.String label1,
                         java.lang.String label2)

Returns the similarity of 2 words

Specified by:

similarity in interface WordVectors

Parameters:

label1 - the first word

label2 - the second word

Returns:

a normalized similarity (cosine similarity)

vocab

public VocabCache vocab()

Vocab for the vectors

Specified by:

vocab in interface WordVectors

Returns:

lookupTable

public WeightLookupTable lookupTable()

Lookup table for the vectors PLEASE NOTE: This method is not available in this implementation.

Specified by:

lookupTable in interface WordVectors

Returns:

setModelUtils

public void setModelUtils(ModelUtils utils)

Specifies ModelUtils to be used to access model PLEASE NOTE: This method has no effect in this implementation.

Specified by:

setModelUtils in interface WordVectors

Parameters:

utils -