No description, website, or topics provided.
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


The main goal of the project is extending Ukrainian tonal dictionary. At first, we tried to achieve it by looking at words similar to ones with known tonality. Word2vec and LexVec models are used to find similar words. Then we built NN classifier and used word embeddings and existing tonal dictionary to train it.


split_to_chunks/ - is used to take a piece of files so it can be read with notepad: - has some useful methods and folders paths

Split to sentences:

We have different sources of text: csv, txt and wiki. There are different files to preprocess them.

for csv: (each item is a news or article)
  1. split raw csv data to chunks and save as chunks: split_to_chunks/
    Result items are saved in data\chunks
  2. read chunk items, tokenize text, save list of sentences: split_to_chunks/
    Result items are saved in data\sents
for txt:

run split_to_chunks/txt_to_sentences to tokenize text and save chunks with lists of sentences
Result is saved to data\sents

for wiki

run split_to_chunks/wiki_to_sentences to tokenize text and save chunks with lists of sentences

Cleanup words:

train/ - will read all existing sentences files and clean words

Building word2vec model

train/ - will build word2vec model
train/ - will train word2vec model

Building LexVec model

LexVec was used on the same data with settings identical to Word2Vec to calculate embeddings.

Used word embeddings models

If you don't want to calculate word vectors for yourself, you can obtain them from website or download from Google Drive (,

Using LexVec and word2vec models to predict the tone of the word

predict/ - is used to concatenate two models: LexVec and word2vec
predict/ - predict, save the whole set, save subsample
predict/ - take best negative and positive candidates


Oleksandr Marykovskyi, Vyacheslav Tykhonov provided the seed dictionary
Serhiy Shehovtsov wrote the code and ran numerous experiments
Oles Petriv created and trained neural network model
Vsevolod Dyomkin proof-read the result and prepared it for publishing
Dmitry Chaplinsky led the project :)