From 97cef997032c3222645ebdc898c199a7b63e5395 Mon Sep 17 00:00:00 2001
From: Michael Penkov <m@penkov.dev>
Date: Sat, 30 Apr 2022 08:22:46 +0900
Subject: [PATCH 01/34] bump timeout for wheel building step

it seems to occasionally go over 10 minutes, e.g.
https://github.com/RaRe-Technologies/gensim/runs/6231204549
---
 .github/workflows/build-wheels.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/build-wheels.yml b/.github/workflows/build-wheels.yml
index cab6a16641..a9f0fd7ef2 100644
--- a/.github/workflows/build-wheels.yml
+++ b/.github/workflows/build-wheels.yml
@@ -37,7 +37,7 @@ jobs:
       - name: Check Sphinx Gallery cache
         run: python docs/src/check_gallery.py
   build:
-    timeout-minutes: 30
+    timeout-minutes: 35
     runs-on: ${{ matrix.os }}
     defaults:
       run:

From 8e9e09ca32f177dfa0b7d0e6253f0b5374fb37ee Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Radim=20=C5=98eh=C5=AF=C5=99ek?= <radimrehurek@seznam.cz>
Date: Sun, 1 May 2022 18:25:37 +0200
Subject: [PATCH 02/34] bump up dev version

---
 docs/src/conf.py   | 2 +-
 gensim/__init__.py | 2 +-
 setup.py           | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/docs/src/conf.py b/docs/src/conf.py
index 168d4cf58e..1789e7353f 100644
--- a/docs/src/conf.py
+++ b/docs/src/conf.py
@@ -63,7 +63,7 @@
 # The short X.Y version.
 version = '4.2.0'
 # The full version, including alpha/beta/rc tags.
-release = '4.2.0'
+release = '4.2.1.dev0'
 
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.
diff --git a/gensim/__init__.py b/gensim/__init__.py
index b5f915a3ed..2ac8d16b66 100644
--- a/gensim/__init__.py
+++ b/gensim/__init__.py
@@ -4,7 +4,7 @@
 
 """
 
-__version__ = '4.2.0'
+__version__ = '4.2.1.dev0'
 
 import logging
 
diff --git a/setup.py b/setup.py
index e3ee0c3bdb..8091591fe0 100644
--- a/setup.py
+++ b/setup.py
@@ -334,7 +334,7 @@ def run(self):
 
 setup(
     name='gensim',
-    version='4.2.0',
+    version='4.2.1.dev0',
     description='Python framework for fast Vector Space Modelling',
     long_description=LONG_DESCRIPTION,
 

From 9b316bcc113f34350fb8eb5f904b2d9ad9f29486 Mon Sep 17 00:00:00 2001
From: Michael Penkov <m@penkov.dev>
Date: Mon, 2 May 2022 21:30:33 +0900
Subject: [PATCH 03/34] disable py3.6 builds in travis.yml

---
 .travis.yml | 8 --------
 1 file changed, 8 deletions(-)

diff --git a/.travis.yml b/.travis.yml
index f1c9f05e99..11e06f2f63 100644
--- a/.travis.yml
+++ b/.travis.yml
@@ -33,14 +33,6 @@ matrix:
       # See .github/workflows/build-wheels.yml for a discussion of why we
       # handle numpy versions explicitly.
       #
-    - os: linux
-      env:
-        - MB_PYTHON_VERSION=3.6
-        #
-        # scipy 1.7.0 wheels not available for Py3.6, so we have to build using
-        # an older version.
-        #
-        - BUILD_DEPENDS="numpy==1.19.2 scipy==1.5.3"
     - os: linux
       env:
         - MB_PYTHON_VERSION=3.7

From 400d90654fb0dce55facf566354b91c0f5175731 Mon Sep 17 00:00:00 2001
From: Paul Wise <pabs3@bonedaddy.net>
Date: Thu, 5 May 2022 14:43:33 +0800
Subject: [PATCH 04/34] Allow overriding the Cython version requirement (#3323)

Use an environment variable for this since it is often easier to set in a
build wrapper rather than trying to override command-line options in the
right layer of a multi-layer build wrapper and it also requires a lot less
code to do the override.

This will be useful for using alpha versions of Cython or old versions of
Cython provided by the distros or specific versions that fix certain bugs.
---
 setup.py | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/setup.py b/setup.py
index 8091591fe0..d41f668ee0 100644
--- a/setup.py
+++ b/setup.py
@@ -320,6 +320,9 @@ def run(self):
 #
 CYTHON_STR = 'Cython==0.29.28'
 
+# Allow overriding the Cython version requirement
+CYTHON_STR = os.environ.get('GENSIM_CYTHON_REQUIRES', CYTHON_STR)
+
 install_requires = [
     NUMPY_STR,
     'scipy >= 0.18.1',

From 5a19dd0407577001bcc177166582da7a5a4e5f70 Mon Sep 17 00:00:00 2001
From: Paul Wise <pabs3@bonedaddy.net>
Date: Thu, 5 May 2022 14:45:02 +0800
Subject: [PATCH 05/34] Update Python module MANIFEST (#3343)

Drop COPYING.LESSER as it was moved to COPYING in 2016.

Drop ez_setup.py as it was removed in 2018.

Switch doc2vec_inner.c to doc2vec_inner.cpp,
as it has always been using language=c++.

Suggested-by: setup.py build
Fixes: commit beb04ea1f8f9c438b0a40aa4cbbd955ea065f84f
Fixes: commit 2891861d77f9eff2dc703214c099240ef227b7da
Fixes: commit 1aa11bbaa7beba9b3068cb2e2d04a500ebd31f30
---
 MANIFEST.in | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/MANIFEST.in b/MANIFEST.in
index 8aa14d25b8..cc4323533f 100644
--- a/MANIFEST.in
+++ b/MANIFEST.in
@@ -2,8 +2,6 @@ recursive-include gensim/test/test_data *
 include README.md
 include CHANGELOG.md
 include COPYING
-include COPYING.LESSER
-include ez_setup.py
 
 include gensim/models/voidptr.h
 include gensim/models/stdint_wrapper.h
@@ -16,7 +14,7 @@ include gensim/models/word2vec_corpusfile.cpp
 include gensim/models/word2vec_corpusfile.pyx
 include gensim/models/word2vec_corpusfile.pxd
 
-include gensim/models/doc2vec_inner.c
+include gensim/models/doc2vec_inner.cpp
 include gensim/models/doc2vec_inner.pyx
 include gensim/models/doc2vec_inner.pxd
 include gensim/models/doc2vec_corpusfile.cpp

From eeb7e8662d5350efe68fa14db08b02d273735af9 Mon Sep 17 00:00:00 2001
From: Paul Wise <pabs3@bonedaddy.net>
Date: Thu, 5 May 2022 21:41:54 +0800
Subject: [PATCH 06/34] Clean up references to `Morfessor`, `tox` and
 `gensim.models.wrappers` (#3345)

* Drop reference to Morfessor

It was dropped from usage in 2022.

Fixes: commit acce8a21377d1f599f8b9ec56b10321c91d4109d

* Drop references to tox

Usage of tox was dropped in 2022.

Where necessary, replace tox commands with the current equivalent.

Fixes: commit 3ce81a44cc59b3d77edee043ee14050f611008df

* Drop direct and indirect references to gensim.modules.wrapper(s)

They were all removed in 2021.

TestDtmModel escaped being noticed via test failures because all the tests
it runs are skipped without the DTM_PATH environment variable being set.

Fixes: commit a21d9cc768598640f38e4bd03d368f8712a9aa77
---
 .gitignore                      |  1 -
 .travis.yml                     |  2 +-
 CONTRIBUTING.md                 |  8 ++--
 gensim/models/callbacks.py      | 18 ++++-----
 gensim/models/coherencemodel.py |  3 +-
 gensim/models/keyedvectors.py   |  3 +-
 gensim/test/test_dtm.py         | 70 ---------------------------------
 gensim/utils.py                 |  2 +-
 release/upload_docs.sh          |  3 +-
 9 files changed, 16 insertions(+), 94 deletions(-)
 delete mode 100644 gensim/test/test_dtm.py

diff --git a/.gitignore b/.gitignore
index 019e1812f7..8853bd683a 100644
--- a/.gitignore
+++ b/.gitignore
@@ -42,7 +42,6 @@ Thumbs.db
 
 # Other #
 #########
-.tox/
 .cache/
 .project
 .pydevproject
diff --git a/.travis.yml b/.travis.yml
index 11e06f2f63..b0b952766d 100644
--- a/.travis.yml
+++ b/.travis.yml
@@ -26,7 +26,7 @@ env:
         # them here for now.  They'll get picked up by the multibuild stuff
         # running in multibuild/common_utils.sh.
         #
-      - TEST_DEPENDS="pytest mock cython nmslib pyemd testfixtures Morfessor==2.0.2a4 python-levenshtein==0.12.0 visdom==0.1.8.9 scikit-learn"
+      - TEST_DEPENDS="pytest mock cython nmslib pyemd testfixtures python-levenshtein==0.12.0 visdom==0.1.8.9 scikit-learn"
 
 matrix:
       #
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 0eeb90591b..09f2f5a870 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -20,11 +20,9 @@ Also, please check the [Gensim FAQ](https://github.com/RaRe-Technologies/gensim/
       - For windows: `pip install -e .[test-win]`
 5. Implement your changes
 6. Check that everything's OK in your branch:
-   - Check it for PEP8: `tox -e flake8`
-   - Build its documentation (works only for MacOS/Linux): `tox -e docs` (documentation stored in `docs/src/_build`)
-   - Run unit tests: `tox -e py{version}-{os}`, for example `tox -e py35-linux` or `tox -e py36-win` where
-      - `{version}` is one of `35`, `36`
-      - `{os}` is either `win` or `linux`
+   - Check it for PEP8: `flake8 --ignore E12,W503 --max-line-length 120 --show-source gensim`
+   - Build its documentation (works only for MacOS/Linux): `make -C docs/src html` (documentation stored in `docs/src/_build`)
+   - Run unit tests: `pytest -v gensim/test`
 7. Add files, commit and push: `git add ... ; git commit -m "my commit message"; git push origin my-feature`
 8. [Create a PR](https://help.github.com/articles/creating-a-pull-request/) on Github. Write a **clear description** for your PR, including all the context and relevant information, such as:
    - The issue that you fixed, e.g. `Fixes #123`
diff --git a/gensim/models/callbacks.py b/gensim/models/callbacks.py
index 42f250cb91..c5560441af 100644
--- a/gensim/models/callbacks.py
+++ b/gensim/models/callbacks.py
@@ -234,9 +234,7 @@ def get_value(self, **kwargs):
             Key word arguments to override the object's internal attributes.
             One of the following parameters are expected:
 
-                * `model` - pre-trained topic model of type :class:`~gensim.models.ldamodel.LdaModel`, or one
-                  of its wrappers, such as :class:`~gensim.models.wrappers.ldamallet.LdaMallet` or
-                  :class:`~gensim.models.wrappers.ldavowpalwabbit.LdaVowpalWabbit`.
+                * `model` - pre-trained topic model of type :class:`~gensim.models.ldamodel.LdaModel`.
                 * `topics` - list of tokenized topics.
 
         Returns
@@ -290,10 +288,8 @@ def get_value(self, **kwargs):
         ----------
         **kwargs
             Key word arguments to override the object's internal attributes.
-            A trained topic model is expected using the 'model' key. This can be of type
-            :class:`~gensim.models.ldamodel.LdaModel`, or one of its wrappers, such as
-            :class:`~gensim.models.wrappers.ldamallet.LdaMallet` or
-            :class:`~gensim.models.wrapper.ldavowpalwabbit.LdaVowpalWabbit`.
+            A trained topic model is expected using the 'model' key.
+            This must be of type :class:`~gensim.models.ldamodel.LdaModel`.
 
         Returns
         -------
@@ -354,8 +350,8 @@ def get_value(self, **kwargs):
         ----------
         **kwargs
             Key word arguments to override the object's internal attributes.
-            Two models of type :class:`~gensim.models.ldamodelLdaModel` or its wrappers are expected using the keys
-            `model` and `other_model`.
+            Two models of type :class:`~gensim.models.ldamodelLdaModel`
+            are expected using the keys `model` and `other_model`.
 
         Returns
         -------
@@ -424,8 +420,8 @@ def get_value(self, **kwargs):
         ----------
         **kwargs
             Key word arguments to override the object's internal attributes.
-            Two models of type :class:`~gensim.models.ldamodel.LdaModel` or its wrappers are expected using the keys
-            `model` and `other_model`.
+            Two models of type :class:`~gensim.models.ldamodel.LdaModel`
+            are expected using the keys `model` and `other_model`.
 
         Returns
         -------
diff --git a/gensim/models/coherencemodel.py b/gensim/models/coherencemodel.py
index b3c89640a7..d6df976153 100644
--- a/gensim/models/coherencemodel.py
+++ b/gensim/models/coherencemodel.py
@@ -132,8 +132,7 @@ def __init__(self, model=None, topics=None, texts=None, corpus=None, dictionary=
         model : :class:`~gensim.models.basemodel.BaseTopicModel`, optional
             Pre-trained topic model, should be provided if topics is not provided.
             Currently supports :class:`~gensim.models.ldamodel.LdaModel`,
-            :class:`~gensim.models.ldamulticore.LdaMulticore`, :class:`~gensim.models.wrappers.ldamallet.LdaMallet` and
-            :class:`~gensim.models.wrappers.ldavowpalwabbit.LdaVowpalWabbit`.
+            :class:`~gensim.models.ldamulticore.LdaMulticore`.
             Use `topics` parameter to plug in an as yet unsupported model.
         topics : list of list of str, optional
             List of tokenized topics, if this is preferred over model - dictionary should be provided.
diff --git a/gensim/models/keyedvectors.py b/gensim/models/keyedvectors.py
index 8f86b807f2..6fb9e329d8 100644
--- a/gensim/models/keyedvectors.py
+++ b/gensim/models/keyedvectors.py
@@ -9,8 +9,7 @@
  and various similarity look-ups.
 
 Since trained word vectors are independent from the way they were trained (:class:`~gensim.models.word2vec.Word2Vec`,
-:class:`~gensim.models.fasttext.FastText`,
-:class:`~gensim.models.wrappers.varembed.VarEmbed` etc), they can be represented by a standalone structure,
+:class:`~gensim.models.fasttext.FastText` etc), they can be represented by a standalone structure,
 as implemented in this module.
 
 The structure is called "KeyedVectors" and is essentially a mapping between *keys*
diff --git a/gensim/test/test_dtm.py b/gensim/test/test_dtm.py
deleted file mode 100644
index 0e57d15e7e..0000000000
--- a/gensim/test/test_dtm.py
+++ /dev/null
@@ -1,70 +0,0 @@
-#!/usr/bin/env python
-# -*- coding: utf-8 -*-
-
-"""
-Automated tests for DTM/DIM model
-"""
-
-
-import logging
-from subprocess import CalledProcessError
-import gensim
-import os
-import unittest
-from gensim import corpora
-from gensim.test.utils import datapath
-
-
-class TestDtmModel(unittest.TestCase):
-
-    def setUp(self):
-        self.time_slices = [3, 7]
-        self.corpus = corpora.mmcorpus.MmCorpus(datapath('dtm_test.mm'))
-        self.id2word = corpora.Dictionary.load(datapath('dtm_test.dict'))
-        # first you need to setup the environment variable $DTM_PATH for the dtm executable file
-        self.dtm_path = os.environ.get('DTM_PATH', None)
-        if not self.dtm_path:
-            self.skipTest("$DTM_PATH is not properly set up.")
-
-    def test_dtm(self):
-        if self.dtm_path is not None:
-            model = gensim.models.wrappers.DtmModel(
-                self.dtm_path, self.corpus, self.time_slices, num_topics=2,
-                id2word=self.id2word, model='dtm', initialize_lda=True,
-                rng_seed=1
-            )
-            topics = model.show_topics(num_topics=2, times=2, num_words=10)
-            self.assertEqual(len(topics), 4)
-
-            one_topic = model.show_topic(topicid=1, time=1, topn=10)
-            self.assertEqual(len(one_topic), 10)
-            self.assertEqual(one_topic[0][1], u'idexx')
-
-    def test_dim(self):
-        if self.dtm_path is not None:
-            model = gensim.models.wrappers.DtmModel(
-                self.dtm_path, self.corpus, self.time_slices, num_topics=2,
-                id2word=self.id2word, model='fixed', initialize_lda=True,
-                rng_seed=1
-            )
-            topics = model.show_topics(num_topics=2, times=2, num_words=10)
-            self.assertEqual(len(topics), 4)
-
-            one_topic = model.show_topic(topicid=1, time=1, topn=10)
-            self.assertEqual(len(one_topic), 10)
-            self.assertEqual(one_topic[0][1], u'skills')
-
-    # In stderr expect "Error opening file /tmp/a65419_train_out/initial-lda-ss.dat. Failing."
-    def test_called_process_error(self):
-        if self.dtm_path is not None:
-            with self.assertRaises(CalledProcessError):
-                gensim.models.wrappers.DtmModel(
-                    self.dtm_path, self.corpus, self.time_slices, num_topics=2,
-                    id2word=self.id2word, model='dtm', initialize_lda=False,
-                    rng_seed=1
-                )
-
-
-if __name__ == '__main__':
-    logging.basicConfig(level=logging.DEBUG)
-    unittest.main()
diff --git a/gensim/utils.py b/gensim/utils.py
index 78d64b88e6..0619296888 100644
--- a/gensim/utils.py
+++ b/gensim/utils.py
@@ -1863,7 +1863,7 @@ def keep_vocab_item(word, count, min_count, trim_rule=None):
 def check_output(stdout=subprocess.PIPE, *popenargs, **kwargs):
     r"""Run OS command with the given arguments and return its output as a byte string.
 
-    Backported from Python 2.7 with a few minor modifications. Widely used for :mod:`gensim.models.wrappers`.
+    Backported from Python 2.7 with a few minor modifications. Used in word2vec/glove2word2vec tests.
     Behaves very similar to https://docs.python.org/2/library/subprocess.html#subprocess.check_output.
 
     Examples
diff --git a/release/upload_docs.sh b/release/upload_docs.sh
index d454eaa157..3bec935a8e 100644
--- a/release/upload_docs.sh
+++ b/release/upload_docs.sh
@@ -1,3 +1,4 @@
-tox -e compile,docs
+python setup.py build_ext --inplace
 cd docs/src
+make html
 make upload

From ded78776284ad7b55b6626191eaa8dcea0dd3db0 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Radim=20=C5=98eh=C5=AF=C5=99ek?= <radimrehurek@seznam.cz>
Date: Fri, 6 May 2022 02:53:28 +0200
Subject: [PATCH 07/34] Disable the Gensim 3=>4 warning in docs (#3346)

* disable 3=>4 docs notification

* replace migration docs by sponsorship link
---
 docs/src/sphinx_rtd_theme/notification.html | 5 +----
 1 file changed, 1 insertion(+), 4 deletions(-)

diff --git a/docs/src/sphinx_rtd_theme/notification.html b/docs/src/sphinx_rtd_theme/notification.html
index 4b0d7922e1..dd648b861f 100644
--- a/docs/src/sphinx_rtd_theme/notification.html
+++ b/docs/src/sphinx_rtd_theme/notification.html
@@ -1,6 +1,3 @@
 <div class="notification">
-  You're viewing documentation for Gensim 4.0.0. For Gensim 3.8.3, please visit the old <a id="notification" href="https://radimrehurek.com/gensim_3.8.3">Gensim 3.8.3 documentation</a> and <a href="https://github.com/RaRe-Technologies/gensim/wiki/Migrating-from-Gensim-3.x-to-4">Migration Guide</a>.
-  <script>
-    notification.href += location.pathname.replace(/^\/gensim/, "");
-  </script>
+  Gensim relies on your donations for sustenance. If you like Gensim, please <a href="https://github.com/sponsors/piskvorky">consider donating</a>.
 </div>

From 62669aef21ae8047c3105d89f0032df81e73b4fa Mon Sep 17 00:00:00 2001
From: Michael Penkov <m@penkov.dev>
Date: Mon, 22 Aug 2022 00:15:45 +0900
Subject: [PATCH 08/34] pin sphinx versions, add explicit gallery_top label
 (#3383)

* pin sphinx versions, add explicit gallery_top label

* make flake8 happy again

* make flake8 happy again

* make flake8 happy again

* make flake8 happy again
---
 docs/src/auto_examples/index.rst | 261 +++++++++++++------------------
 docs/src/gallery/README.txt      |   2 +
 docs/src/support.rst             |   2 +-
 gensim/models/doc2vec.py         |   3 +-
 gensim/models/keyedvectors.py    |   4 +-
 gensim/models/ldamodel.py        |   3 +-
 gensim/models/ldaseqmodel.py     |   6 +-
 gensim/test/test_ldamodel.py     |   2 +-
 setup.py                         |  14 +-
 9 files changed, 131 insertions(+), 166 deletions(-)

diff --git a/docs/src/auto_examples/index.rst b/docs/src/auto_examples/index.rst
index 47819284b2..ca47a1738e 100644
--- a/docs/src/auto_examples/index.rst
+++ b/docs/src/auto_examples/index.rst
@@ -1,23 +1,23 @@
 :orphan:
 
-
-
-.. _sphx_glr_auto_examples:
-
 Documentation
 =============
 
+.. _gallery_top:
+
 We welcome contributions to our documentation via GitHub pull requests, whether it's fixing a typo or authoring an entirely new tutorial or guide.
 If you're thinking about contributing documentation, please see :ref:`sphx_glr_auto_examples_howtos_run_doc.py`.
 
 
+
 .. raw:: html
 
-    <div class="sphx-glr-clear"></div>
+    <div class="sphx-glr-thumbnails">
 
 
+.. raw:: html
 
-.. _sphx_glr_auto_examples_core:
+    </div>
 
 Core Tutorials: New Users Start Here!
 -------------------------------------
@@ -27,96 +27,82 @@ Understanding this functionality is vital for using gensim effectively.
 
 
 
+.. raw:: html
+
+    <div class="sphx-glr-thumbnails">
+
+
 .. raw:: html
 
     <div class="sphx-glr-thumbcontainer" tooltip="This tutorial introduces Documents, Corpora, Vectors and Models: the basic concepts and terms n...">
 
 .. only:: html
 
- .. figure:: /auto_examples/core/images/thumb/sphx_glr_run_core_concepts_thumb.png
-     :alt: Core Concepts
+  .. image:: /auto_examples/core/images/thumb/sphx_glr_run_core_concepts_thumb.png
+    :alt: Core Concepts
 
-     :ref:`sphx_glr_auto_examples_core_run_core_concepts.py`
+  :ref:`sphx_glr_auto_examples_core_run_core_concepts.py`
 
 .. raw:: html
 
+      <div class="sphx-glr-thumbnail-title">Core Concepts</div>
     </div>
 
 
-.. toctree::
-   :hidden:
-
-   /auto_examples/core/run_core_concepts
-
 .. raw:: html
 
     <div class="sphx-glr-thumbcontainer" tooltip="Demonstrates transforming text into a vector space representation.">
 
 .. only:: html
 
- .. figure:: /auto_examples/core/images/thumb/sphx_glr_run_corpora_and_vector_spaces_thumb.png
-     :alt: Corpora and Vector Spaces
+  .. image:: /auto_examples/core/images/thumb/sphx_glr_run_corpora_and_vector_spaces_thumb.png
+    :alt: Corpora and Vector Spaces
 
-     :ref:`sphx_glr_auto_examples_core_run_corpora_and_vector_spaces.py`
+  :ref:`sphx_glr_auto_examples_core_run_corpora_and_vector_spaces.py`
 
 .. raw:: html
 
+      <div class="sphx-glr-thumbnail-title">Corpora and Vector Spaces</div>
     </div>
 
 
-.. toctree::
-   :hidden:
-
-   /auto_examples/core/run_corpora_and_vector_spaces
-
 .. raw:: html
 
     <div class="sphx-glr-thumbcontainer" tooltip="Introduces transformations and demonstrates their use on a toy corpus.">
 
 .. only:: html
 
- .. figure:: /auto_examples/core/images/thumb/sphx_glr_run_topics_and_transformations_thumb.png
-     :alt: Topics and Transformations
+  .. image:: /auto_examples/core/images/thumb/sphx_glr_run_topics_and_transformations_thumb.png
+    :alt: Topics and Transformations
 
-     :ref:`sphx_glr_auto_examples_core_run_topics_and_transformations.py`
+  :ref:`sphx_glr_auto_examples_core_run_topics_and_transformations.py`
 
 .. raw:: html
 
+      <div class="sphx-glr-thumbnail-title">Topics and Transformations</div>
     </div>
 
 
-.. toctree::
-   :hidden:
-
-   /auto_examples/core/run_topics_and_transformations
-
 .. raw:: html
 
     <div class="sphx-glr-thumbcontainer" tooltip="Demonstrates querying a corpus for similar documents.">
 
 .. only:: html
 
- .. figure:: /auto_examples/core/images/thumb/sphx_glr_run_similarity_queries_thumb.png
-     :alt: Similarity Queries
+  .. image:: /auto_examples/core/images/thumb/sphx_glr_run_similarity_queries_thumb.png
+    :alt: Similarity Queries
 
-     :ref:`sphx_glr_auto_examples_core_run_similarity_queries.py`
+  :ref:`sphx_glr_auto_examples_core_run_similarity_queries.py`
 
 .. raw:: html
 
+      <div class="sphx-glr-thumbnail-title">Similarity Queries</div>
     </div>
 
 
-.. toctree::
-   :hidden:
-
-   /auto_examples/core/run_similarity_queries
 .. raw:: html
 
-    <div class="sphx-glr-clear"></div>
-
-
-
-.. _sphx_glr_auto_examples_tutorials:
+    </div>
 
 Tutorials: Learning Oriented Lessons
 ------------------------------------
@@ -125,180 +111,150 @@ Learning-oriented lessons that introduce a particular gensim feature, e.g. a mod
 
 
 
+.. raw:: html
+
+    <div class="sphx-glr-thumbnails">
+
+
 .. raw:: html
 
     <div class="sphx-glr-thumbcontainer" tooltip="Introduces Gensim&#x27;s Word2Vec model and demonstrates its use on the `Lee Evaluation Corpus &lt;http...">
 
 .. only:: html
 
- .. figure:: /auto_examples/tutorials/images/thumb/sphx_glr_run_word2vec_thumb.png
-     :alt: Word2Vec Model
+  .. image:: /auto_examples/tutorials/images/thumb/sphx_glr_run_word2vec_thumb.png
+    :alt: Word2Vec Model
 
-     :ref:`sphx_glr_auto_examples_tutorials_run_word2vec.py`
+  :ref:`sphx_glr_auto_examples_tutorials_run_word2vec.py`
 
 .. raw:: html
 
+      <div class="sphx-glr-thumbnail-title">Word2Vec Model</div>
     </div>
 
 
-.. toctree::
-   :hidden:
-
-   /auto_examples/tutorials/run_word2vec
-
 .. raw:: html
 
     <div class="sphx-glr-thumbcontainer" tooltip="Introduces Gensim&#x27;s Doc2Vec model and demonstrates its use on the `Lee Corpus &lt;https://hekyll.s...">
 
 .. only:: html
 
- .. figure:: /auto_examples/tutorials/images/thumb/sphx_glr_run_doc2vec_lee_thumb.png
-     :alt: Doc2Vec Model
+  .. image:: /auto_examples/tutorials/images/thumb/sphx_glr_run_doc2vec_lee_thumb.png
+    :alt: Doc2Vec Model
 
-     :ref:`sphx_glr_auto_examples_tutorials_run_doc2vec_lee.py`
+  :ref:`sphx_glr_auto_examples_tutorials_run_doc2vec_lee.py`
 
 .. raw:: html
 
+      <div class="sphx-glr-thumbnail-title">Doc2Vec Model</div>
     </div>
 
 
-.. toctree::
-   :hidden:
-
-   /auto_examples/tutorials/run_doc2vec_lee
-
 .. raw:: html
 
     <div class="sphx-glr-thumbcontainer" tooltip="Introduces Gensim&#x27;s EnsembleLda model">
 
 .. only:: html
 
- .. figure:: /auto_examples/tutorials/images/thumb/sphx_glr_run_ensemblelda_thumb.png
-     :alt: Ensemble LDA
+  .. image:: /auto_examples/tutorials/images/thumb/sphx_glr_run_ensemblelda_thumb.png
+    :alt: Ensemble LDA
 
-     :ref:`sphx_glr_auto_examples_tutorials_run_ensemblelda.py`
+  :ref:`sphx_glr_auto_examples_tutorials_run_ensemblelda.py`
 
 .. raw:: html
 
+      <div class="sphx-glr-thumbnail-title">Ensemble LDA</div>
     </div>
 
 
-.. toctree::
-   :hidden:
-
-   /auto_examples/tutorials/run_ensemblelda
-
 .. raw:: html
 
     <div class="sphx-glr-thumbcontainer" tooltip="Introduces Gensim&#x27;s fastText model and demonstrates its use on the Lee Corpus.">
 
 .. only:: html
 
- .. figure:: /auto_examples/tutorials/images/thumb/sphx_glr_run_fasttext_thumb.png
-     :alt: FastText Model
+  .. image:: /auto_examples/tutorials/images/thumb/sphx_glr_run_fasttext_thumb.png
+    :alt: FastText Model
 
-     :ref:`sphx_glr_auto_examples_tutorials_run_fasttext.py`
+  :ref:`sphx_glr_auto_examples_tutorials_run_fasttext.py`
 
 .. raw:: html
 
+      <div class="sphx-glr-thumbnail-title">FastText Model</div>
     </div>
 
 
-.. toctree::
-   :hidden:
-
-   /auto_examples/tutorials/run_fasttext
-
 .. raw:: html
 
     <div class="sphx-glr-thumbcontainer" tooltip="Introduces the Annoy library for similarity queries on top of vectors learned by Word2Vec.">
 
 .. only:: html
 
- .. figure:: /auto_examples/tutorials/images/thumb/sphx_glr_run_annoy_thumb.png
-     :alt: Fast Similarity Queries with Annoy and Word2Vec
+  .. image:: /auto_examples/tutorials/images/thumb/sphx_glr_run_annoy_thumb.png
+    :alt: Fast Similarity Queries with Annoy and Word2Vec
 
-     :ref:`sphx_glr_auto_examples_tutorials_run_annoy.py`
+  :ref:`sphx_glr_auto_examples_tutorials_run_annoy.py`
 
 .. raw:: html
 
+      <div class="sphx-glr-thumbnail-title">Fast Similarity Queries with Annoy and Word2Vec</div>
     </div>
 
 
-.. toctree::
-   :hidden:
-
-   /auto_examples/tutorials/run_annoy
-
 .. raw:: html
 
     <div class="sphx-glr-thumbcontainer" tooltip="Introduces Gensim&#x27;s LDA model and demonstrates its use on the NIPS corpus.">
 
 .. only:: html
 
- .. figure:: /auto_examples/tutorials/images/thumb/sphx_glr_run_lda_thumb.png
-     :alt: LDA Model
+  .. image:: /auto_examples/tutorials/images/thumb/sphx_glr_run_lda_thumb.png
+    :alt: LDA Model
 
-     :ref:`sphx_glr_auto_examples_tutorials_run_lda.py`
+  :ref:`sphx_glr_auto_examples_tutorials_run_lda.py`
 
 .. raw:: html
 
+      <div class="sphx-glr-thumbnail-title">LDA Model</div>
     </div>
 
 
-.. toctree::
-   :hidden:
-
-   /auto_examples/tutorials/run_lda
-
 .. raw:: html
 
     <div class="sphx-glr-thumbcontainer" tooltip="Demonstrates using Gensim&#x27;s implemenation of the WMD.">
 
 .. only:: html
 
- .. figure:: /auto_examples/tutorials/images/thumb/sphx_glr_run_wmd_thumb.png
-     :alt: Word Mover's Distance
+  .. image:: /auto_examples/tutorials/images/thumb/sphx_glr_run_wmd_thumb.png
+    :alt: Word Mover's Distance
 
-     :ref:`sphx_glr_auto_examples_tutorials_run_wmd.py`
+  :ref:`sphx_glr_auto_examples_tutorials_run_wmd.py`
 
 .. raw:: html
 
+      <div class="sphx-glr-thumbnail-title">Word Mover's Distance</div>
     </div>
 
 
-.. toctree::
-   :hidden:
-
-   /auto_examples/tutorials/run_wmd
-
 .. raw:: html
 
     <div class="sphx-glr-thumbcontainer" tooltip="Demonstrates using Gensim&#x27;s implemenation of the SCM.">
 
 .. only:: html
 
- .. figure:: /auto_examples/tutorials/images/thumb/sphx_glr_run_scm_thumb.png
-     :alt: Soft Cosine Measure
+  .. image:: /auto_examples/tutorials/images/thumb/sphx_glr_run_scm_thumb.png
+    :alt: Soft Cosine Measure
 
-     :ref:`sphx_glr_auto_examples_tutorials_run_scm.py`
+  :ref:`sphx_glr_auto_examples_tutorials_run_scm.py`
 
 .. raw:: html
 
+      <div class="sphx-glr-thumbnail-title">Soft Cosine Measure</div>
     </div>
 
 
-.. toctree::
-   :hidden:
-
-   /auto_examples/tutorials/run_scm
 .. raw:: html
 
-    <div class="sphx-glr-clear"></div>
-
-
-
-.. _sphx_glr_auto_examples_howtos:
+    </div>
 
 How-to Guides: Solve a Problem
 ------------------------------
@@ -307,96 +263,82 @@ These **goal-oriented guides** demonstrate how to **solve a specific problem** u
 
 
 
+.. raw:: html
+
+    <div class="sphx-glr-thumbnails">
+
+
 .. raw:: html
 
     <div class="sphx-glr-thumbcontainer" tooltip="Demonstrates simple and quick access to common corpora and pretrained models.">
 
 .. only:: html
 
- .. figure:: /auto_examples/howtos/images/thumb/sphx_glr_run_downloader_api_thumb.png
-     :alt: How to download pre-trained models and corpora
+  .. image:: /auto_examples/howtos/images/thumb/sphx_glr_run_downloader_api_thumb.png
+    :alt: How to download pre-trained models and corpora
 
-     :ref:`sphx_glr_auto_examples_howtos_run_downloader_api.py`
+  :ref:`sphx_glr_auto_examples_howtos_run_downloader_api.py`
 
 .. raw:: html
 
+      <div class="sphx-glr-thumbnail-title">How to download pre-trained models and corpora</div>
     </div>
 
 
-.. toctree::
-   :hidden:
-
-   /auto_examples/howtos/run_downloader_api
-
 .. raw:: html
 
     <div class="sphx-glr-thumbcontainer" tooltip="How to author documentation for Gensim.">
 
 .. only:: html
 
- .. figure:: /auto_examples/howtos/images/thumb/sphx_glr_run_doc_thumb.png
-     :alt: How to Author Gensim Documentation
+  .. image:: /auto_examples/howtos/images/thumb/sphx_glr_run_doc_thumb.png
+    :alt: How to Author Gensim Documentation
 
-     :ref:`sphx_glr_auto_examples_howtos_run_doc.py`
+  :ref:`sphx_glr_auto_examples_howtos_run_doc.py`
 
 .. raw:: html
 
+      <div class="sphx-glr-thumbnail-title">How to Author Gensim Documentation</div>
     </div>
 
 
-.. toctree::
-   :hidden:
-
-   /auto_examples/howtos/run_doc
-
 .. raw:: html
 
     <div class="sphx-glr-thumbcontainer" tooltip="Shows how to reproduce results of the &quot;Distributed Representation of Sentences and Documents&quot; p...">
 
 .. only:: html
 
- .. figure:: /auto_examples/howtos/images/thumb/sphx_glr_run_doc2vec_imdb_thumb.png
-     :alt: How to reproduce the doc2vec 'Paragraph Vector' paper
+  .. image:: /auto_examples/howtos/images/thumb/sphx_glr_run_doc2vec_imdb_thumb.png
+    :alt: How to reproduce the doc2vec 'Paragraph Vector' paper
 
-     :ref:`sphx_glr_auto_examples_howtos_run_doc2vec_imdb.py`
+  :ref:`sphx_glr_auto_examples_howtos_run_doc2vec_imdb.py`
 
 .. raw:: html
 
+      <div class="sphx-glr-thumbnail-title">How to reproduce the doc2vec 'Paragraph Vector' paper</div>
     </div>
 
 
-.. toctree::
-   :hidden:
-
-   /auto_examples/howtos/run_doc2vec_imdb
-
 .. raw:: html
 
     <div class="sphx-glr-thumbcontainer" tooltip="Demonstrates how you can visualize and compare trained topic models.">
 
 .. only:: html
 
- .. figure:: /auto_examples/howtos/images/thumb/sphx_glr_run_compare_lda_thumb.png
-     :alt: How to Compare LDA Models
+  .. image:: /auto_examples/howtos/images/thumb/sphx_glr_run_compare_lda_thumb.png
+    :alt: How to Compare LDA Models
 
-     :ref:`sphx_glr_auto_examples_howtos_run_compare_lda.py`
+  :ref:`sphx_glr_auto_examples_howtos_run_compare_lda.py`
 
 .. raw:: html
 
+      <div class="sphx-glr-thumbnail-title">How to Compare LDA Models</div>
     </div>
 
 
-.. toctree::
-   :hidden:
-
-   /auto_examples/howtos/run_compare_lda
 .. raw:: html
 
-    <div class="sphx-glr-clear"></div>
-
-
-
-.. _sphx_glr_auto_examples_other:
+    </div>
 
 Other Resources
 ---------------
@@ -433,27 +375,38 @@ Blog posts, tutorial videos, hackathons and other useful Gensim resources, from
    - ? `Deep Inverse Regression with Yelp Reviews <https://github.com/RaRe-Technologies/gensim/blob/develop/docs/notebooks/deepir.ipynb>`__ (Document Classification using Bayesian Inversion and several word2vec models, one for each class)
 
 
+
 .. raw:: html
 
-    <div class="sphx-glr-clear"></div>
+    <div class="sphx-glr-thumbnails">
+
 
+.. raw:: html
+
+    </div>
 
 
-.. only :: html
+.. toctree::
+   :hidden:
+   :includehidden:
 
- .. container:: sphx-glr-footer
-    :class: sphx-glr-footer-gallery
+   /auto_examples/core/index.rst
+   /auto_examples/tutorials/index.rst
+   /auto_examples/howtos/index.rst
+   /auto_examples/other/index.rst
 
 
-  .. container:: sphx-glr-download sphx-glr-download-python
+.. only:: html
 
-    :download:`Download all examples in Python source code: auto_examples_python.zip </auto_examples/auto_examples_python.zip>`
+  .. container:: sphx-glr-footer sphx-glr-footer-gallery
 
+    .. container:: sphx-glr-download sphx-glr-download-python
 
+      :download:`Download all examples in Python source code: auto_examples_python.zip </auto_examples/auto_examples_python.zip>`
 
-  .. container:: sphx-glr-download sphx-glr-download-jupyter
+    .. container:: sphx-glr-download sphx-glr-download-jupyter
 
-    :download:`Download all examples in Jupyter notebooks: auto_examples_jupyter.zip </auto_examples/auto_examples_jupyter.zip>`
+      :download:`Download all examples in Jupyter notebooks: auto_examples_jupyter.zip </auto_examples/auto_examples_jupyter.zip>`
 
 
 .. only:: html
diff --git a/docs/src/gallery/README.txt b/docs/src/gallery/README.txt
index 80ab288c48..560c047c25 100644
--- a/docs/src/gallery/README.txt
+++ b/docs/src/gallery/README.txt
@@ -1,5 +1,7 @@
 Documentation
 =============
 
+.. _gallery_top:
+
 We welcome contributions to our documentation via GitHub pull requests, whether it's fixing a typo or authoring an entirely new tutorial or guide.
 If you're thinking about contributing documentation, please see :ref:`sphx_glr_auto_examples_howtos_run_doc.py`.
diff --git a/docs/src/support.rst b/docs/src/support.rst
index a28f1e0003..514b75b9b1 100644
--- a/docs/src/support.rst
+++ b/docs/src/support.rst
@@ -11,7 +11,7 @@ Open source support
 
 The main communication channel is the free `Gensim mailing list <https://groups.google.com/group/gensim>`_.
 
-This is the preferred way to ask for help, report problems and share insights with the community. Newbie questions are perfectly fine, as long as you've read the :ref:`tutorials <sphx_glr_auto_examples>` and `FAQ <https://github.com/RaRe-Technologies/gensim/wiki/Recipes-&-FAQ>`_.
+This is the preferred way to ask for help, report problems and share insights with the community. Newbie questions are perfectly fine, as long as you've read the :ref:`tutorials <gallery_top>` and `FAQ <https://github.com/RaRe-Technologies/gensim/wiki/Recipes-&-FAQ>`_.
 
 FAQ and some useful snippets of code are maintained on GitHub: https://github.com/RARE-Technologies/gensim/wiki/Recipes-&-FAQ.
 
diff --git a/gensim/models/doc2vec.py b/gensim/models/doc2vec.py
index 20a739f64a..d76be81f9b 100644
--- a/gensim/models/doc2vec.py
+++ b/gensim/models/doc2vec.py
@@ -1137,7 +1137,8 @@ def __iter__(self):
 
 class TaggedLineDocument:
     def __init__(self, source):
-        """Iterate over a file that contains documents: one line = :class:`~gensim.models.doc2vec.TaggedDocument` object.
+        """Iterate over a file that contains documents:
+        one line = :class:`~gensim.models.doc2vec.TaggedDocument` object.
 
         Words are expected to be already preprocessed and separated by whitespace. Document tags are constructed
         automatically from the document line number (each document gets a unique integer tag).
diff --git a/gensim/models/keyedvectors.py b/gensim/models/keyedvectors.py
index 6fb9e329d8..019d2c2652 100644
--- a/gensim/models/keyedvectors.py
+++ b/gensim/models/keyedvectors.py
@@ -517,7 +517,7 @@ def get_mean_vector(self, keys, weights=None, pre_normalize=True, post_normalize
             elif not ignore_missing:
                 raise KeyError(f"Key '{key}' not present in vocabulary")
 
-        if(total_weight > 0):
+        if total_weight > 0:
             mean = mean / total_weight
         if post_normalize:
             mean = matutils.unitvec(mean).astype(REAL)
@@ -1252,7 +1252,7 @@ def n_similarity(self, ws1, ws2):
             Similarities between `ws1` and `ws2`.
 
         """
-        if not(len(ws1) and len(ws2)):
+        if not (len(ws1) and len(ws2)):
             raise ZeroDivisionError('At least one of the passed list is empty.')
         mean1 = self.get_mean_vector(ws1, pre_normalize=False)
         mean2 = self.get_mean_vector(ws2, pre_normalize=False)
diff --git a/gensim/models/ldamodel.py b/gensim/models/ldamodel.py
index 10a0c60134..b5f8017f07 100755
--- a/gensim/models/ldamodel.py
+++ b/gensim/models/ldamodel.py
@@ -314,7 +314,8 @@ def load(cls, fname, *args, **kwargs):
 
 
 class LdaModel(interfaces.TransformationABC, basemodel.BaseTopicModel):
-    """Train and use Online Latent Dirichlet Allocation model as presented in `'Online Learning for LDA' by Hoffman et al.`_
+    """Train and use Online Latent Dirichlet Allocation model as presented in
+    `'Online Learning for LDA' by Hoffman et al.`_
 
     Examples
     -------
diff --git a/gensim/models/ldaseqmodel.py b/gensim/models/ldaseqmodel.py
index 0f222c9c6c..8ffcb5eee6 100644
--- a/gensim/models/ldaseqmodel.py
+++ b/gensim/models/ldaseqmodel.py
@@ -4,7 +4,8 @@
 # Licensed under the GNU LGPL v2.1 - http://www.gnu.org/licenses/lgpl.html
 # Based on Copyright (C) 2016 Radim Rehurek <radimrehurek@seznam.cz>
 
-"""Lda Sequence model, inspired by `David M. Blei, John D. Lafferty: "Dynamic Topic Models"
+"""Lda Sequence model, inspired by
+`David M. Blei, John D. Lafferty: "Dynamic Topic Models"
 <https://mimno.infosci.cornell.edu/info6150/readings/dynamic_topic_models.pdf>`_.
 The original C/C++ implementation can be found on `blei-lab/dtm <https://github.com/blei-lab/dtm>`_.
 
@@ -744,7 +745,8 @@ def update_zeta(self):
         return self.zeta
 
     def compute_post_variance(self, word, chain_variance):
-        r"""Get the variance, based on the `Variational Kalman Filtering approach for Approximate Inference (section 3.1)
+        r"""Get the variance, based on the
+        `Variational Kalman Filtering approach for Approximate Inference (section 3.1)
         <https://mimno.infosci.cornell.edu/info6150/readings/dynamic_topic_models.pdf>`_.
 
         This function accepts the word to compute variance for, along with the associated sslm class object,
diff --git a/gensim/test/test_ldamodel.py b/gensim/test/test_ldamodel.py
index 297006b75f..7ce675e337 100644
--- a/gensim/test/test_ldamodel.py
+++ b/gensim/test/test_ldamodel.py
@@ -33,7 +33,7 @@
 def test_random_state():
     testcases = [np.random.seed(0), None, np.random.RandomState(0), 0]
     for testcase in testcases:
-        assert(isinstance(utils.get_random_state(testcase), np.random.RandomState))
+        assert isinstance(utils.get_random_state(testcase), np.random.RandomState)
 
 
 class TestLdaModel(unittest.TestCase, basetmtests.TestBaseTopicModel):
diff --git a/setup.py b/setup.py
index d41f668ee0..de9e0bfb36 100644
--- a/setup.py
+++ b/setup.py
@@ -297,11 +297,17 @@ def run(self):
 #   https://packaging.python.org/discussions/install-requires-vs-requirements/
 #
 
+#
+# We pin the Sphinx-related packages to specific versions here because we want
+# our documentation builds to be reproducible.  Different versions of Sphinx
+# can generate slightly different output, and because we keep some of the output
+# under version control, we want to keep these differences to a minimum.
+#
 docs_testenv = core_testenv + distributed_env + visdom_req + [
-    'sphinx',
-    'sphinx-gallery',
-    'sphinxcontrib.programoutput',
-    'sphinxcontrib-napoleon',
+    'sphinx==5.1.1',
+    'sphinx-gallery==0.11.1',
+    'sphinxcontrib.programoutput==0.17',
+    'sphinxcontrib-napoleon==0.7',
     'matplotlib',  # expected by sphinx-gallery
     'memory_profiler',
     'annoy',

From 99e43c4b2da4fbfb03f5f8e5e1c6e65157e1ec48 Mon Sep 17 00:00:00 2001
From: hstk <hstk30@gmail.com>
Date: Mon, 22 Aug 2022 09:45:35 +0800
Subject: [PATCH 09/34] fix: fix error 'for loop initial declaration' (#3378)

Co-authored-by: Michael Penkov <m@penkov.dev>
---
 gensim/similarities/fastss.pyx | 9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)

diff --git a/gensim/similarities/fastss.pyx b/gensim/similarities/fastss.pyx
index e47a5442b2..fe0366bb04 100644
--- a/gensim/similarities/fastss.pyx
+++ b/gensim/similarities/fastss.pyx
@@ -43,9 +43,11 @@ cdef extern from *:
         void * s1_data = PyUnicode_DATA(s1);
         void * s2_data = PyUnicode_DATA(s2);
 
-        for (WIDTH tmpi = 0; tmpi <= len_s1; tmpi++) row2[tmpi] = tmpi;
+        WIDTH tmpi;
+        for (tmpi = 0; tmpi <= len_s1; tmpi++) row2[tmpi] = tmpi;
 
-        for (WIDTH i2 = 0; i2 < len_s2; i2++) {
+        WIDTH i2;
+        for (i2 = 0; i2 < len_s2; i2++) {
             int all_bad = i2 >= maximum;
             const Py_UCS4 ch = PyUnicode_READ(kind2, s2_data, i2);
             row_flip = 1 - row_flip;
@@ -56,7 +58,8 @@ cdef extern from *:
             }
             *pos_new = i2 + 1;
 
-            for (WIDTH i1 = 0; i1 < len_s1; i1++) {
+            WIDTH i1;
+            for (i1 = 0; i1 < len_s1; i1++) {
                 WIDTH val = *(pos_old++);
                 if (ch != PyUnicode_READ(kind1, s1_data, i1)) {
                     const WIDTH _val1 = *pos_old;

From 2350e9259b066126a9687cf6e04cb644f387a38a Mon Sep 17 00:00:00 2001
From: Michael Penkov <m@penkov.dev>
Date: Mon, 22 Aug 2022 15:37:06 +0900
Subject: [PATCH 10/34] update release/hijack_pr.py

---
 release/hijack_pr.py | 80 ++++++++++++++++++++++++++++++--------------
 1 file changed, 54 insertions(+), 26 deletions(-)

diff --git a/release/hijack_pr.py b/release/hijack_pr.py
index d109836d49..fb326fff7c 100755
--- a/release/hijack_pr.py
+++ b/release/hijack_pr.py
@@ -18,6 +18,14 @@
 The above commands would check out the code for the PR, make changes to them, and push them back.
 Obviously, this requires the PR to be writable, but most gensim PRs are.
 If they aren't, then leave it up to the PR author to make the required changes.
+
+Sometimes, we'll make upstream changes that we want to merge into existing PRs.
+This is particularly useful when some nagging build problem is affecting multiple PRs.
+We can achieve this with:
+
+    $ release/hijack_pr.py merge-upstream-into 1234
+
+This hijacks the PR and merges upstream/develop into it.
 """
 import json
 import subprocess
@@ -25,47 +33,67 @@
 
 import smart_open
 
+
 def check_output(command):
     return subprocess.check_output(command).strip().decode('utf-8')
 
 
-if sys.argv[1] == "push":
+def push():
     command = "git rev-parse --abbrev-ref HEAD@{upstream}".split()
     remote, remote_branch = check_output(command).split('/')
     current_branch = check_output(['git', 'branch', '--show-current'])
-    check_output(['git', 'push', remote, f'{current_branch}:{remote_branch}'])
+    subprocess.check_call(['git', 'push', remote, f'{current_branch}:{remote_branch}'])
 
     #
     # Cleanup to prevent remotes and branches from piling up
     #
-    check_output(['git', 'branch', '--delete', current_branch])
-    check_output(['git', 'remote', 'remove', remote])
-    sys.exit(0)
+    subprocess.check_call(['git', 'checkout', 'develop'])
+    subprocess.check_call(['git', 'branch', '--delete', current_branch])
+    subprocess.check_call(['git', 'remote', 'remove', remote])
+
+
+def hijack(prid):
+    url = f"https://github.com/repos/RaRe-Technologies/gensim/pulls/{prid}"
+    with smart_open.open(url) as fin:
+        prinfo = json.load(fin)
+
+    user = prinfo['head']['user']['login']
+    ssh_url = prinfo['head']['repo']['ssh_url']
 
-prid = int(sys.argv[1])
-url = f"https://github.com/repos/RaRe-Technologies/gensim/pulls/{prid}"
-with smart_open.open(url) as fin:
-    prinfo = json.load(fin)
+    remotes = check_output(['git', 'remote']).split('\n')
+    if user not in remotes:
+        subprocess.check_call(['git', 'remote', 'add', user, ssh_url])
 
-user = prinfo['head']['user']['login']
-ssh_url = prinfo['head']['repo']['ssh_url']
+    subprocess.check_call(['git', 'fetch', user])
 
-remotes = check_output(['git', 'remote']).split('\n')
-if user not in remotes:
-    subprocess.check_call(['git', 'remote', 'add', user, ssh_url])
+    ref = prinfo['head']['ref']
+    subprocess.check_call(['git', 'checkout', f'{user}/{ref}'])
+
+    #
+    # Prefix the local branch name with the user to avoid naming clashes with
+    # existing branches, e.g. develop
+    #
+    subprocess.check_call(['git', 'switch', '-c', f'{user}_{ref}'])
+
+    #
+    # Set the upstream so we can push back to it more easily
+    #
+    subprocess.check_call(['git', 'branch', '--set-upstream-to', f'{user}/{ref}'])
 
-subprocess.check_call(['git', 'fetch', user])
 
-ref = prinfo['head']['ref']
-subprocess.check_call(['git', 'checkout', f'{user}/{ref}'])
+def main():
+    if sys.argv[1] == "push":
+        push()
+    elif sys.argv[1] == 'merge-upstream-into':
+        prid = int(sys.argv[2])
+        hijack(prid)
+        subprocess.check_call(['git', 'fetch', 'upstream'])
+        subprocess.check_call(['git', 'merge', 'upstream/develop', '--no-edit'])
+        push()
+    else:
+        prid = int(sys.argv[1])
+        hijack(prid)
 
-#
-# Prefix the local branch name with the user to avoid naming clashes with
-# existing branches, e.g. develop
-#
-subprocess.check_call(['git', 'switch', '-c', f'{user}_{ref}'])
 
-#
-# Set the upstream so we can push back to it more easily
-#
-subprocess.check_call(['git', 'branch', '--set-upstream-to', f'{user}/{ref}'])
+if __name__ == '__main__':
+    main()

From 7f314ee10c9ad83816aa795c5ef6ebc378de3acf Mon Sep 17 00:00:00 2001
From: dymil <30931139+dymil@users.noreply.github.com>
Date: Mon, 22 Aug 2022 08:48:56 -0400
Subject: [PATCH 11/34] Fix typo in word2vec and KeyedVectors docstrings
 (#3365)

* Add missing word in word2vec docstring

* Fix docstring typo in KeyedVectors distances()

word_or_vector, not word_or_vectors
---
 gensim/models/keyedvectors.py | 2 +-
 gensim/models/word2vec.py     | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/gensim/models/keyedvectors.py b/gensim/models/keyedvectors.py
index 019d2c2652..6b31496bb5 100644
--- a/gensim/models/keyedvectors.py
+++ b/gensim/models/keyedvectors.py
@@ -1167,7 +1167,7 @@ def cosine_similarities(vector_1, vectors_all):
 
     def distances(self, word_or_vector, other_words=()):
         """Compute cosine distances from given word or vector to all words in `other_words`.
-        If `other_words` is empty, return distance between `word_or_vectors` and all words in vocab.
+        If `other_words` is empty, return distance between `word_or_vector` and all words in vocab.
 
         Parameters
         ----------
diff --git a/gensim/models/word2vec.py b/gensim/models/word2vec.py
index 061dcfc817..d20bb63b1f 100755
--- a/gensim/models/word2vec.py
+++ b/gensim/models/word2vec.py
@@ -68,7 +68,7 @@
     >>> sims = model.wv.most_similar('computer', topn=10)  # get other similar words
 
 The reason for separating the trained vectors into `KeyedVectors` is that if you don't
-need the full model state any more (don't need to continue training), its state can discarded,
+need the full model state any more (don't need to continue training), its state can be discarded,
 keeping just the vectors and their keys proper.
 
 This results in a much smaller and faster object that can be mmapped for lightning

From 77c3a7ff5254346146d0e9eedf8e84fb6d577878 Mon Sep 17 00:00:00 2001
From: dymil <30931139+dymil@users.noreply.github.com>
Date: Mon, 22 Aug 2022 08:54:57 -0400
Subject: [PATCH 12/34] Replace np.multiply with np.square and copyedit in
 translation_matrix.py (#3374)

* Replace np.multiply with np.square and copyedit

* Copyedit translation_matrix.py

Co-authored-by: Michael Penkov <m@penkov.dev>
---
 gensim/models/translation_matrix.py | 40 ++++++++++++++---------------
 1 file changed, 20 insertions(+), 20 deletions(-)

diff --git a/gensim/models/translation_matrix.py b/gensim/models/translation_matrix.py
index 528e3d6fa2..246482421f 100644
--- a/gensim/models/translation_matrix.py
+++ b/gensim/models/translation_matrix.py
@@ -5,7 +5,7 @@
 a standard nearest neighbour method or a globally corrected neighbour retrieval method [1]_.
 
 This method can be used to augment the existing phrase tables with more candidate translations, or
-filter out errors from the translation tables and known dictionaries [2]_. What's more, It also work
+filter out errors from the translation tables and known dictionaries [2]_. What's more, it also works
 for any two sets of named-vectors where there are some paired-guideposts to learn the transformation.
 
 Examples
@@ -14,7 +14,7 @@
 How to make translation between two set of word-vectors
 =======================================================
 
-Initialize a word-vector models
+Initialize two word-vector models
 
 .. sourcecode:: pycon
 
@@ -24,7 +24,7 @@
     >>> model_en = KeyedVectors.load_word2vec_format(datapath("EN.1-10.cbow1_wind5_hs0_neg10_size300_smpl1e-05.txt"))
     >>> model_it = KeyedVectors.load_word2vec_format(datapath("IT.1-10.cbow1_wind5_hs0_neg10_size300_smpl1e-05.txt"))
 
-Define word pairs (that will be used for construction of translation matrix
+Define word pairs (that will be used for construction of translation matrix)
 
 .. sourcecode:: pycon
 
@@ -143,12 +143,12 @@ def build(cls, lang_vec, lexicon=None):
             Object that stored word-vectors
 
         """
-        # `words` to store all the word that
-        # `mat` to store all the word vector for the word in 'words' list
+        # `words` to store all the words
+        # `mat` to store the word vector for each word in the 'words' list
         words = []
         mat = []
         if lexicon is not None:
-            # if the lexicon is not provided, using the all the Keyedvectors's words as default
+            # if the lexicon is not provided, using all the Keyedvectors's words as default
             for item in lexicon:
                 words.append(item)
                 mat.append(lang_vec.vectors[lang_vec.get_index(item)])
@@ -161,18 +161,18 @@ def build(cls, lang_vec, lexicon=None):
         return Space(mat, words)
 
     def normalize(self):
-        """Normalize the word vector's matrix."""
-        self.mat = self.mat / np.sqrt(np.sum(np.multiply(self.mat, self.mat), axis=1, keepdims=True))
+        """Normalize the word vectors matrix."""
+        self.mat = self.mat / np.sqrt(np.sum(np.square(self.mat), axis=1, keepdims=True))
 
 
 class TranslationMatrix(utils.SaveLoad):
-    """Objects of this class realize the translation matrix which map the source language to the target language.
+    """Objects of this class realize the translation matrix which maps the source language to the target language.
     The main methods are:
 
     We map it to the other language space by computing z = Wx, then return the
     word whose representation is close to z.
 
-    The details use seen the notebook [3]_
+    For details on use, see the tutorial notebook [3]_
 
     Examples
     --------
@@ -234,7 +234,7 @@ def __init__(self, source_lang_vec, target_lang_vec, word_pairs=None, random_sta
             self.train(word_pairs)
 
     def train(self, word_pairs):
-        """Build the translation matrix that mapping from source space to target space.
+        """Build the translation matrix to map from source space to target space.
 
         Parameters
         ----------
@@ -289,7 +289,7 @@ def translate(self, source_words, topn=5, gc=0, sample_num=None, source_lang_vec
             Define translation algorithm, if `gc == 0` - use standard NN retrieval,
             otherwise, use globally corrected neighbour retrieval method (as described in [1]_).
         sample_num : int, optional
-            Number of word to sample from the source lexicon, if `gc == 1`, then `sample_num` **must** be provided.
+            Number of words to sample from the source lexicon, if `gc == 1`, then `sample_num` **must** be provided.
         source_lang_vec : :class:`~gensim.models.keyedvectors.KeyedVectors`, optional
             New source language vectors for translation, by default, used the model's source language vector.
         target_lang_vec : :class:`~gensim.models.keyedvectors.KeyedVectors`, optional
@@ -366,15 +366,15 @@ def translate(self, source_words, topn=5, gc=0, sample_num=None, source_lang_vec
 
 
 class BackMappingTranslationMatrix(utils.SaveLoad):
-    """Realize the BackMapping translation matrix which map the source model's document vector
-    to the target model's document vector(old model).
+    """Realize the BackMapping translation matrix which maps the source model's document vector
+    to the target model's document vector (old model).
 
-    BackMapping translation matrix is used to learn a mapping for two document vector space which we
-    specify as source document vector and target document vector. The target document vector are trained
-    on superset corpus of source document vector, we can incrementally increase the vector in
+    BackMapping translation matrix is used to learn a mapping for two document vector spaces which we
+    specify as source document vector and target document vector. The target document vectors are trained
+    on a superset corpus of source document vectors; we can incrementally increase the vector in
     the old model through the BackMapping translation matrix.
 
-    the details use seen the notebook [3]_.
+    For details on use, see the tutorial notebook [3]_.
 
     Examples
     --------
@@ -421,7 +421,7 @@ def __init__(self, source_lang_vec, target_lang_vec, tagged_docs=None, random_st
             self.train(tagged_docs)
 
     def train(self, tagged_docs):
-        """Build the translation matrix that mapping from the source model's vector to target model's vector
+        """Build the translation matrix to map from the source model's vectors to target model's vectors
 
         Parameters
         ----------
@@ -432,7 +432,7 @@ def train(self, tagged_docs):
         Returns
         -------
         numpy.ndarray
-            Translation matrix that mapping from the source model's vector to target model's vector.
+            Translation matrix that maps from the source model's vectors to target model's vectors.
 
         """
         m1 = [self.source_lang_vec.dv[item.tags].flatten() for item in tagged_docs]

From ff3531bee156f69c8a7fe5809ce22df0176bcf98 Mon Sep 17 00:00:00 2001
From: dymil <30931139+dymil@users.noreply.github.com>
Date: Mon, 22 Aug 2022 08:56:01 -0400
Subject: [PATCH 13/34] Copyedit and fix outdated statements (#3375)

* print statements replaced with print function for Python 3
* gensim.utils.smart_open replaced with smart_open.open for newer gensim

Co-authored-by: Michael Penkov <m@penkov.dev>
---
 docs/notebooks/translation_matrix.ipynb | 92 +++++++++++--------------
 1 file changed, 42 insertions(+), 50 deletions(-)

diff --git a/docs/notebooks/translation_matrix.ipynb b/docs/notebooks/translation_matrix.ipynb
index 8832f732e6..8e7eefdbbd 100644
--- a/docs/notebooks/translation_matrix.ipynb
+++ b/docs/notebooks/translation_matrix.ipynb
@@ -4,7 +4,7 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "# Tranlation Matrix Tutorial"
+    "# Translation Matrix Tutorial"
    ]
   },
   {
@@ -34,14 +34,14 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "Tomas Mikolov, Quoc V Le, Ilya Sutskever. 2013.[Exploiting Similarities among Languages for Machine Translation](https://arxiv.org/pdf/1309.4168.pdf)\n",
+    "Tomas Mikolov, Quoc V Le, Ilya Sutskever. 2013. [Exploiting Similarities among Languages for Machine Translation](https://arxiv.org/pdf/1309.4168.pdf)\n",
     "\n",
-    "Georgiana Dinu, Angelikie Lazaridou and Marco Baroni. 2014.[Improving zero-shot learning by mitigating the hubness problem](https://arxiv.org/pdf/1309.4168.pdf)"
+    "Georgiana Dinu, Angelikie Lazaridou and Marco Baroni. 2014. [Improving zero-shot learning by mitigating the hubness problem](https://arxiv.org/pdf/1309.4168.pdf)"
    ]
   },
   {
    "cell_type": "code",
-   "execution_count": 1,
+   "execution_count": 5,
    "metadata": {},
    "outputs": [],
    "source": [
@@ -49,7 +49,8 @@
     "\n",
     "from gensim import utils\n",
     "from gensim.models import translation_matrix\n",
-    "from gensim.models import KeyedVectors"
+    "from gensim.models import KeyedVectors\n",
+    "import smart_open"
    ]
   },
   {
@@ -65,7 +66,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 4,
+   "execution_count": null,
    "metadata": {},
    "outputs": [],
    "source": [
@@ -74,30 +75,23 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 2,
+   "execution_count": 7,
    "metadata": {},
    "outputs": [
     {
-     "ename": "FileNotFoundError",
-     "evalue": "[Errno 2] No such file or directory: 'OPUS_en_it_europarl_train_5K.txt'",
-     "output_type": "error",
-     "traceback": [
-      "\u001b[0;31m---------------------------------------------------------------------------\u001b[0m",
-      "\u001b[0;31mFileNotFoundError\u001b[0m                         Traceback (most recent call last)",
-      "\u001b[0;32m<ipython-input-2-a21913f3bec7>\u001b[0m in \u001b[0;36m<module>\u001b[0;34m\u001b[0m\n\u001b[1;32m      1\u001b[0m \u001b[0mtrain_file\u001b[0m \u001b[0;34m=\u001b[0m \u001b[0;34m\"OPUS_en_it_europarl_train_5K.txt\"\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m      2\u001b[0m \u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0;32m----> 3\u001b[0;31m \u001b[0;32mwith\u001b[0m \u001b[0mutils\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0msmart_open\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0mtrain_file\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0;34m\"r\"\u001b[0m\u001b[0;34m)\u001b[0m \u001b[0;32mas\u001b[0m \u001b[0mf\u001b[0m\u001b[0;34m:\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0m\u001b[1;32m      4\u001b[0m     \u001b[0mword_pair\u001b[0m \u001b[0;34m=\u001b[0m \u001b[0;34m[\u001b[0m\u001b[0mtuple\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0mutils\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0mto_unicode\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0mline\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0mstrip\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0msplit\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m)\u001b[0m \u001b[0;32mfor\u001b[0m \u001b[0mline\u001b[0m \u001b[0;32min\u001b[0m \u001b[0mf\u001b[0m\u001b[0;34m]\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m      5\u001b[0m \u001b[0mprint\u001b[0m \u001b[0;34m(\u001b[0m\u001b[0mword_pair\u001b[0m\u001b[0;34m[\u001b[0m\u001b[0;34m:\u001b[0m\u001b[0;36m10\u001b[0m\u001b[0;34m]\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n",
-      "\u001b[0;32m~/envs/gensim/lib/python3.7/site-packages/smart_open/smart_open_lib.py\u001b[0m in \u001b[0;36msmart_open\u001b[0;34m(uri, mode, **kw)\u001b[0m\n\u001b[1;32m    437\u001b[0m             \u001b[0mtransport_params\u001b[0m\u001b[0;34m[\u001b[0m\u001b[0mkey\u001b[0m\u001b[0;34m]\u001b[0m \u001b[0;34m=\u001b[0m \u001b[0mvalue\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m    438\u001b[0m \u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0;32m--> 439\u001b[0;31m     \u001b[0;32mreturn\u001b[0m \u001b[0mopen\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0muri\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0mmode\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0mignore_ext\u001b[0m\u001b[0;34m=\u001b[0m\u001b[0mignore_extension\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0mtransport_params\u001b[0m\u001b[0;34m=\u001b[0m\u001b[0mtransport_params\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0;34m**\u001b[0m\u001b[0mscrubbed_kwargs\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0m\u001b[1;32m    440\u001b[0m \u001b[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m    441\u001b[0m \u001b[0;34m\u001b[0m\u001b[0m\n",
-      "\u001b[0;32m~/envs/gensim/lib/python3.7/site-packages/smart_open/smart_open_lib.py\u001b[0m in \u001b[0;36mopen\u001b[0;34m(uri, mode, buffering, encoding, errors, newline, closefd, opener, ignore_ext, transport_params)\u001b[0m\n\u001b[1;32m    305\u001b[0m         \u001b[0mbuffering\u001b[0m\u001b[0;34m=\u001b[0m\u001b[0mbuffering\u001b[0m\u001b[0;34m,\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m    306\u001b[0m         \u001b[0mencoding\u001b[0m\u001b[0;34m=\u001b[0m\u001b[0mencoding\u001b[0m\u001b[0;34m,\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0;32m--> 307\u001b[0;31m         \u001b[0merrors\u001b[0m\u001b[0;34m=\u001b[0m\u001b[0merrors\u001b[0m\u001b[0;34m,\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0m\u001b[1;32m    308\u001b[0m     )\n\u001b[1;32m    309\u001b[0m     \u001b[0;32mif\u001b[0m \u001b[0mfobj\u001b[0m \u001b[0;32mis\u001b[0m \u001b[0;32mnot\u001b[0m \u001b[0;32mNone\u001b[0m\u001b[0;34m:\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n",
-      "\u001b[0;32m~/envs/gensim/lib/python3.7/site-packages/smart_open/smart_open_lib.py\u001b[0m in \u001b[0;36m_shortcut_open\u001b[0;34m(uri, mode, ignore_ext, buffering, encoding, errors)\u001b[0m\n\u001b[1;32m    496\u001b[0m     \u001b[0;31m#\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m    497\u001b[0m     \u001b[0;32mif\u001b[0m \u001b[0msix\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0mPY3\u001b[0m\u001b[0;34m:\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0;32m--> 498\u001b[0;31m         \u001b[0;32mreturn\u001b[0m \u001b[0m_builtin_open\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0mparsed_uri\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0muri_path\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0mmode\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0mbuffering\u001b[0m\u001b[0;34m=\u001b[0m\u001b[0mbuffering\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0;34m**\u001b[0m\u001b[0mopen_kwargs\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0m\u001b[1;32m    499\u001b[0m     \u001b[0;32melif\u001b[0m \u001b[0;32mnot\u001b[0m \u001b[0mopen_kwargs\u001b[0m\u001b[0;34m:\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m    500\u001b[0m         \u001b[0;32mreturn\u001b[0m \u001b[0m_builtin_open\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0mparsed_uri\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0muri_path\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0mmode\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0mbuffering\u001b[0m\u001b[0;34m=\u001b[0m\u001b[0mbuffering\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n",
-      "\u001b[0;31mFileNotFoundError\u001b[0m: [Errno 2] No such file or directory: 'OPUS_en_it_europarl_train_5K.txt'"
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "[('for', 'per'), ('that', 'che'), ('with', 'con'), ('are', 'are'), ('are', 'sono'), ('this', 'questa'), ('this', 'questo'), ('you', 'lei'), ('not', 'non'), ('which', 'che')]\n"
      ]
     }
    ],
    "source": [
     "train_file = \"OPUS_en_it_europarl_train_5K.txt\"\n",
     "\n",
-    "with utils.smart_open(train_file, \"r\") as f:\n",
+    "with smart_open.open(train_file, \"r\") as f:\n",
     "    word_pair = [tuple(utils.to_unicode(line).strip().split()) for line in f]\n",
-    "print (word_pair[:10])"
+    "print(word_pair[:10])"
    ]
   },
   {
@@ -151,14 +145,14 @@
    "source": [
     "transmat = translation_matrix.TranslationMatrix(source_word_vec, target_word_vec, word_pair)\n",
     "transmat.train(word_pair)\n",
-    "print (\"the shape of translation matrix is: \", transmat.translation_matrix.shape)"
+    "print(\"the shape of translation matrix is: \", transmat.translation_matrix.shape)"
    ]
   },
   {
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "Prediction Time: For any given new word, we can map it to the other language space by coputing $z = Wx$, then we find the word whose representation is closet to z in the target language space, using consine similarity as the distance metric."
+    "Prediction Time: For any given new word, we can map it to the other language space by computing $z = Wx$, then we find the word whose representation is closet to z in the target language space, using cosine similarity as the distance metric."
    ]
   },
   {
@@ -190,7 +184,7 @@
    "outputs": [],
    "source": [
     "for k, v in translated_word.iteritems():\n",
-    "    print (\"word \", k, \" and translated word\", v)"
+    "    print(\"word \", k, \" and translated word\", v)"
    ]
   },
   {
@@ -211,7 +205,7 @@
     "source_word, target_word = zip(*words)\n",
     "translated_word = transmat.translate(source_word, 5)\n",
     "for k, v in translated_word.iteritems():\n",
-    "    print (\"word \", k, \" and translated word\", v)"
+    "    print(\"word \", k, \" and translated word\", v)"
    ]
   },
   {
@@ -232,7 +226,7 @@
     "source_word, target_word = zip(*words)\n",
     "translated_word = transmat.translate(source_word, 5)\n",
     "for k, v in translated_word.iteritems():\n",
-    "    print (\"word \", k, \" and translated word\", v)"
+    "    print(\"word \", k, \" and translated word\", v)"
    ]
   },
   {
@@ -246,7 +240,7 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "Testing the creation time, we extracted more word pairs from a dictionary built from Europarl([Europara, en-it](http://opus.lingfil.uu.se/)). We obtain about 20K word pairs and their coresponding word vectors or you can download from this.[word_dict.pkl](https://pan.baidu.com/s/1dF8HUX7)"
+    "Testing the creation time, we extracted more word pairs from a dictionary built from Europarl([Europara, en-it](http://opus.lingfil.uu.se/)). We obtain about 20K word pairs and their corresponding word vectors or you can download from this: [word_dict.pkl](https://pan.baidu.com/s/1dF8HUX7)"
    ]
   },
   {
@@ -257,9 +251,9 @@
    "source": [
     "import pickle\n",
     "word_dict = \"word_dict.pkl\"\n",
-    "with utils.smart_open(word_dict, \"r\") as f:\n",
+    "with smart_open.open(word_dict, \"r\") as f:\n",
     "    word_pair = pickle.load(f)\n",
-    "print (\"the length of word pair \", len(word_pair))"
+    "print(\"the length of word pair \", len(word_pair))"
    ]
   },
   {
@@ -423,7 +417,7 @@
     "\n",
     "# Translate the English word five to Italian word\n",
     "translated_word = transmat.translate([en_words[4]], 3)\n",
-    "print \"translation of five: \", translated_word\n",
+    "print(\"translation of five: \", translated_word)\n",
     "\n",
     "# the translated words of five\n",
     "for item in translated_word[en_words[4]]:\n",
@@ -518,7 +512,7 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "Let's see some animal words, the figue shows that most of words are also share the similar geometric arrangements."
+    "Let's see some animal words, the figure shows that most of the words also have similar geometric arrangements."
    ]
   },
   {
@@ -593,7 +587,7 @@
     "\n",
     "# Translate the English word birds to Italian word\n",
     "translated_word = transmat.translate([en_words[4]], 3)\n",
-    "print \"translation of birds: \", translated_word\n",
+    "print(\"translation of birds: \", translated_word)\n",
     "\n",
     "# the translated words of birds\n",
     "for item in translated_word[en_words[4]]:\n",
@@ -700,7 +694,7 @@
    "source": [
     "As dicussion in this [PR](https://github.com/RaRe-Technologies/gensim/pull/1434), Translation Matrix not only can used to translate the words from one source language to another target lanuage, but also to translate new document vectors back to old model space.\n",
     "\n",
-    "For example, if we have trained 15k documents using doc2vec (we called this as model1), and we are going to train new 35k documents using doc2vec(we called this as model2). So we can include those 15k documents as reference documents into the new 35k documents. Then we can get 15k document vectors from model1 and 50k document vectors from model2, but both of the two models have vectors for those 15k documents. We can use those vectors to build a mapping from model1 to model2. Finally, with this relation, we can back-mapping the model2's vector to model1. Therefore, 35k document vectors are learned using this method."
+    "For example, if we have trained 15k documents using doc2vec (we called this as model1), and we are going to train new 35k documents using doc2vec (we called this as model2). So we can include those 15k documents as reference documents into the new 35k documents. Then we can get 15k document vectors from model1 and 50k document vectors from model2, but both of the two models have vectors for those 15k documents. We can use those vectors to build a mapping from model1 to model2. Finally, with this relation, we can back-map the model2's vector to model1. Therefore, 35k document vectors are learned using this method."
    ]
   },
   {
@@ -720,13 +714,13 @@
     "from gensim.models.doc2vec import TaggedDocument\n",
     "from gensim.models import Doc2Vec\n",
     "from collections import namedtuple\n",
-    "from gensim import utils\n",
+    "import smart_open\n",
     "\n",
     "def read_sentimentDocs():\n",
     "    SentimentDocument = namedtuple('SentimentDocument', 'words tags split sentiment')\n",
     "\n",
     "    alldocs = []  # will hold all docs in original order\n",
-    "    with utils.smart_open('aclImdb/alldata-id.txt', encoding='utf-8') as alldata:\n",
+    "    with smart_open.open('aclImdb/alldata-id.txt', encoding='utf-8') as alldata:\n",
     "        for line_no, line in enumerate(alldata):\n",
     "            tokens = gensim.utils.to_unicode(line).split()\n",
     "            words = tokens[1:]\n",
@@ -748,14 +742,14 @@
     "small_corpus = train_docs[:15000]\n",
     "large_corpus = train_docs + test_docs\n",
     "\n",
-    "print len(train_docs), len(test_docs), len(doc_list), len(small_corpus), len(large_corpus)"
+    "print(len(train_docs), len(test_docs), len(doc_list), len(small_corpus), len(large_corpus))"
    ]
   },
   {
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "Here, we train two Doc2vec model, the parameters can be determined by yourself. We trained on 15k documents for the `model1` and 50k documents for the `model2`. But you should mixed some documents which from the 15k document in `model` to the `model2` as dicussed before. "
+    "Here, we train two Doc2vec model, the parameters can be determined by yourself. We trained on 15k documents for the `model1` and 50k documents for the `model2`. But you should mix some documents which from the 15k document in `model` to the `model2`, as discussed before. "
    ]
   },
   {
@@ -795,7 +789,7 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "For the IMDB training dataset, we train an classifier on the train data which has 25k documents with positive and negative label. Then using this classifier to predict the test data. To see what accuracy can the document vectors which learned by different method achieve."
+    "For the IMDB training dataset, we train an classifier on the train data which has 25k documents with positive and negative label. Then using this classifier to predict the test data, we see what accuracy can be achieved by the document vectors learned by different methods."
    ]
   },
   {
@@ -812,7 +806,7 @@
     "    classifier = LogisticRegression()\n",
     "    classifier.fit(train, train_label)\n",
     "    score = classifier.score(test, test_label)\n",
-    "    print \"the classifier score :\", score\n",
+    "    print(\"the classifier score :\", score)\n",
     "    return score"
    ]
   },
@@ -855,7 +849,7 @@
     "    test_array[i + 12500] = m2[i + 37500]\n",
     "    test_label[i + 12500] = 0\n",
     "\n",
-    "print \"The vectors are learned by doc2vec method\"\n",
+    "print(\"The vectors are learned by doc2vec method\")\n",
     "test_classifier_error(train_array, train_label, test_array, test_label)"
    ]
   },
@@ -910,7 +904,7 @@
     "    test_array[i + 12500] = m1[i + 37500]\n",
     "    test_label[i + 12500] = 0\n",
     "\n",
-    "print \"The vectors are learned by back-mapping method\"\n",
+    "print(\"The vectors are learned by back-mapping method\")\n",
     "test_classifier_error(train_array, train_label, test_array, test_label)"
    ]
   },
@@ -918,7 +912,7 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "As we can see that, the vectors learned by back-mapping method performed not bad but still need improved."
+    "As we can see that, the vectors learned by back-mapping method performed not bad but still need to be improved."
    ]
   },
   {
@@ -1026,18 +1020,11 @@
    "source": [
     "You probably will see kinds of colors point. One for the `model1`, the `sdoc0` to `sdoc4` document vector are learned by Doc2vec and `sdoc5` and `sdoc6` are learned by back-mapping.  One for the `model2`, the `tdoc0` to `tdoc6` are learned by Doc2vec. We can see that some of points learned from the back-mapping method still have the relative position with the point learned by Doc2vec."
    ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": null,
-   "metadata": {},
-   "outputs": [],
-   "source": []
   }
  ],
  "metadata": {
   "kernelspec": {
-   "display_name": "Python 3",
+   "display_name": "Python 3.10.2 64-bit",
    "language": "python",
    "name": "python3"
   },
@@ -1051,7 +1038,12 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.7.1"
+   "version": "3.10.2"
+  },
+  "vscode": {
+   "interpreter": {
+    "hash": "901b79e026e03396fd1ffa7133844e9ea80e258ce34c66e1aabb5896bcb18463"
+   }
   }
  },
  "nbformat": 4,

From 5dbfb1e231e72a8f4ebc1bf099675116848f1d05 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?V=C3=ADt=20Novotn=C3=BD?= <witiko@mail.muni.cz>
Date: Thu, 8 Sep 2022 02:50:27 +0200
Subject: [PATCH 14/34] Implement Okapi BM25 variants in Gensim (#3304)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* Add and unit-test gensim.models.bm25model.OkapiBM25Model

* Document gensim.models.bm25

* Add and unit-test gensim.models.bm25model.{Lucene,Atire}BM25Model

* Add normalize_{queries,documents} params to gensim.similarities.docsim

* Add example of BM25 to gensim.similarities.docsim.SparseMatrixSimilarity

* Refresh stale gallery cache

* Update gensim/models/bm25model.py

Co-authored-by: Radim Řehůřek <me@radimrehurek.com>

Co-authored-by: Radim Řehůřek <me@radimrehurek.com>
---
 ...glr_run_topics_and_transformations_001.png | Bin 69248 -> 120191 bytes
 ...r_run_topics_and_transformations_thumb.png | Bin 62435 -> 64089 bytes
 .../core/run_topics_and_transformations.ipynb |  12 +-
 .../core/run_topics_and_transformations.py    |  14 +
 .../run_topics_and_transformations.py.md5     |   2 +-
 .../core/run_topics_and_transformations.rst   | 150 ++++++-
 .../auto_examples/core/sg_execution_times.rst |   8 +-
 docs/src/auto_examples/index.rst              |   4 +-
 .../core/run_topics_and_transformations.py    |  14 +
 gensim/models/__init__.py                     |   1 +
 gensim/models/bm25model.py                    | 391 ++++++++++++++++++
 gensim/similarities/docsim.py                 |  90 +++-
 gensim/test/test_bm25model.py                 | 264 ++++++++++++
 13 files changed, 907 insertions(+), 43 deletions(-)
 create mode 100644 gensim/models/bm25model.py
 create mode 100644 gensim/test/test_bm25model.py

diff --git a/docs/src/auto_examples/core/images/sphx_glr_run_topics_and_transformations_001.png b/docs/src/auto_examples/core/images/sphx_glr_run_topics_and_transformations_001.png
index 3dbf224404b34b76d60f5e91180daa785176a7ef..2b3ddc2b4fbd96caeb535b0fcf576bcfa1dcbe54 100644
GIT binary patch
literal 120191
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
E0QKl*g8%>k

literal 69248
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
YGxoYUsdJR@WiSANr>mdKI;Vst06nQ7hX4Qo

diff --git a/docs/src/auto_examples/core/images/thumb/sphx_glr_run_topics_and_transformations_thumb.png b/docs/src/auto_examples/core/images/thumb/sphx_glr_run_topics_and_transformations_thumb.png
index eebecf5b78e66e2e6b1e1185f05c2f51740e394d..81f90665d13eaab0e268aa1f66fc4dcae546952c 100644
GIT binary patch
literal 64089
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
Q1_OR%C6y#<#J&ap58RCY6#xJL

literal 62435
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
L$&1zs8wC9iVGki2

diff --git a/docs/src/auto_examples/core/run_topics_and_transformations.ipynb b/docs/src/auto_examples/core/run_topics_and_transformations.ipynb
index c5a5fbb709..4f40de02be 100644
--- a/docs/src/auto_examples/core/run_topics_and_transformations.ipynb
+++ b/docs/src/auto_examples/core/run_topics_and_transformations.ipynb
@@ -15,7 +15,7 @@
       "cell_type": "markdown",
       "metadata": {},
       "source": [
-        "\nTopics and Transformations\n===========================\n\nIntroduces transformations and demonstrates their use on a toy corpus.\n\n"
+        "\n# Topics and Transformations\n\nIntroduces transformations and demonstrates their use on a toy corpus.\n"
       ]
     },
     {
@@ -33,7 +33,7 @@
       "cell_type": "markdown",
       "metadata": {},
       "source": [
-        "In this tutorial, I will show how to transform documents from one vector representation\ninto another. This process serves two goals:\n\n1. To bring out hidden structure in the corpus, discover relationships between\n   words and use them to describe the documents in a new and\n   (hopefully) more semantic way.\n2. To make the document representation more compact. This both improves efficiency\n   (new representation consumes less resources) and efficacy (marginal data\n   trends are ignored, noise-reduction).\n\nCreating the Corpus\n-------------------\n\nFirst, we need to create a corpus to work with.\nThis step is the same as in the previous tutorial;\nif you completed it, feel free to skip to the next section.\n\n"
+        "In this tutorial, I will show how to transform documents from one vector representation\ninto another. This process serves two goals:\n\n1. To bring out hidden structure in the corpus, discover relationships between\n   words and use them to describe the documents in a new and\n   (hopefully) more semantic way.\n2. To make the document representation more compact. This both improves efficiency\n   (new representation consumes less resources) and efficacy (marginal data\n   trends are ignored, noise-reduction).\n\n## Creating the Corpus\n\nFirst, we need to create a corpus to work with.\nThis step is the same as in the previous tutorial;\nif you completed it, feel free to skip to the next section.\n\n"
       ]
     },
     {
@@ -51,7 +51,7 @@
       "cell_type": "markdown",
       "metadata": {},
       "source": [
-        "Creating a transformation\n++++++++++++++++++++++++++\n\nThe transformations are standard Python objects, typically initialized by means of\na :dfn:`training corpus`:\n\n\n"
+        "### Creating a transformation\n\nThe transformations are standard Python objects, typically initialized by means of\na :dfn:`training corpus`:\n\n\n"
       ]
     },
     {
@@ -69,7 +69,7 @@
       "cell_type": "markdown",
       "metadata": {},
       "source": [
-        "We used our old corpus from tutorial 1 to initialize (train) the transformation model. Different\ntransformations may require different initialization parameters; in case of TfIdf, the\n\"training\" consists simply of going through the supplied corpus once and computing document frequencies\nof all its features. Training other models, such as Latent Semantic Analysis or Latent Dirichlet\nAllocation, is much more involved and, consequently, takes much more time.\n\n<div class=\"alert alert-info\"><h4>Note</h4><p>Transformations always convert between two specific vector\n  spaces. The same vector space (= the same set of feature ids) must be used for training\n  as well as for subsequent vector transformations. Failure to use the same input\n  feature space, such as applying a different string preprocessing, using different\n  feature ids, or using bag-of-words input vectors where TfIdf vectors are expected, will\n  result in feature mismatch during transformation calls and consequently in either\n  garbage output and/or runtime exceptions.</p></div>\n\n\nTransforming vectors\n+++++++++++++++++++++\n\nFrom now on, ``tfidf`` is treated as a read-only object that can be used to convert\nany vector from the old representation (bag-of-words integer counts) to the new representation\n(TfIdf real-valued weights):\n\n"
+        "We used our old corpus from tutorial 1 to initialize (train) the transformation model. Different\ntransformations may require different initialization parameters; in case of TfIdf, the\n\"training\" consists simply of going through the supplied corpus once and computing document frequencies\nof all its features. Training other models, such as Latent Semantic Analysis or Latent Dirichlet\nAllocation, is much more involved and, consequently, takes much more time.\n\n<div class=\"alert alert-info\"><h4>Note</h4><p>Transformations always convert between two specific vector\n  spaces. The same vector space (= the same set of feature ids) must be used for training\n  as well as for subsequent vector transformations. Failure to use the same input\n  feature space, such as applying a different string preprocessing, using different\n  feature ids, or using bag-of-words input vectors where TfIdf vectors are expected, will\n  result in feature mismatch during transformation calls and consequently in either\n  garbage output and/or runtime exceptions.</p></div>\n\n\n### Transforming vectors\n\nFrom now on, ``tfidf`` is treated as a read-only object that can be used to convert\nany vector from the old representation (bag-of-words integer counts) to the new representation\n(TfIdf real-valued weights):\n\n"
       ]
     },
     {
@@ -177,7 +177,7 @@
       "cell_type": "markdown",
       "metadata": {},
       "source": [
-        "The next question might be: just how exactly similar are those documents to each other?\nIs there a way to formalize the similarity, so that for a given input document, we can\norder some other set of documents according to their similarity? Similarity queries\nare covered in the next tutorial (`sphx_glr_auto_examples_core_run_similarity_queries.py`).\n\n\nAvailable transformations\n--------------------------\n\nGensim implements several popular Vector Space Model algorithms:\n\n* `Term Frequency * Inverse Document Frequency, Tf-Idf <http://en.wikipedia.org/wiki/Tf%E2%80%93idf>`_\n  expects a bag-of-words (integer values) training corpus during initialization.\n  During transformation, it will take a vector and return another vector of the\n  same dimensionality, except that features which were rare in the training corpus\n  will have their value increased.\n  It therefore converts integer-valued vectors into real-valued ones, while leaving\n  the number of dimensions intact. It can also optionally normalize the resulting\n  vectors to (Euclidean) unit length.\n\n .. sourcecode:: pycon\n\n    model = models.TfidfModel(corpus, normalize=True)\n\n* `Latent Semantic Indexing, LSI (or sometimes LSA) <http://en.wikipedia.org/wiki/Latent_semantic_indexing>`_\n  transforms documents from either bag-of-words or (preferrably) TfIdf-weighted space into\n  a latent space of a lower dimensionality. For the toy corpus above we used only\n  2 latent dimensions, but on real corpora, target dimensionality of 200--500 is recommended\n  as a \"golden standard\" [1]_.\n\n  .. sourcecode:: pycon\n\n    model = models.LsiModel(tfidf_corpus, id2word=dictionary, num_topics=300)\n\n  LSI training is unique in that we can continue \"training\" at any point, simply\n  by providing more training documents. This is done by incremental updates to\n  the underlying model, in a process called `online training`. Because of this feature, the\n  input document stream may even be infinite -- just keep feeding LSI new documents\n  as they arrive, while using the computed transformation model as read-only in the meanwhile!\n\n  .. sourcecode:: pycon\n\n    model.add_documents(another_tfidf_corpus)  # now LSI has been trained on tfidf_corpus + another_tfidf_corpus\n    lsi_vec = model[tfidf_vec]  # convert some new document into the LSI space, without affecting the model\n\n    model.add_documents(more_documents)  # tfidf_corpus + another_tfidf_corpus + more_documents\n    lsi_vec = model[tfidf_vec]\n\n  See the :mod:`gensim.models.lsimodel` documentation for details on how to make\n  LSI gradually \"forget\" old observations in infinite streams. If you want to get dirty,\n  there are also parameters you can tweak that affect speed vs. memory footprint vs. numerical\n  precision of the LSI algorithm.\n\n  `gensim` uses a novel online incremental streamed distributed training algorithm (quite a mouthful!),\n  which I published in [5]_. `gensim` also executes a stochastic multi-pass algorithm\n  from Halko et al. [4]_ internally, to accelerate in-core part\n  of the computations.\n  See also `wiki` for further speed-ups by distributing the computation across\n  a cluster of computers.\n\n* `Random Projections, RP <http://www.cis.hut.fi/ella/publications/randproj_kdd.pdf>`_ aim to\n  reduce vector space dimensionality. This is a very efficient (both memory- and\n  CPU-friendly) approach to approximating TfIdf distances between documents, by throwing in a little randomness.\n  Recommended target dimensionality is again in the hundreds/thousands, depending on your dataset.\n\n  .. sourcecode:: pycon\n\n    model = models.RpModel(tfidf_corpus, num_topics=500)\n\n* `Latent Dirichlet Allocation, LDA <http://en.wikipedia.org/wiki/Latent_Dirichlet_allocation>`_\n  is yet another transformation from bag-of-words counts into a topic space of lower\n  dimensionality. LDA is a probabilistic extension of LSA (also called multinomial PCA),\n  so LDA's topics can be interpreted as probability distributions over words. These distributions are,\n  just like with LSA, inferred automatically from a training corpus. Documents\n  are in turn interpreted as a (soft) mixture of these topics (again, just like with LSA).\n\n  .. sourcecode:: pycon\n\n    model = models.LdaModel(corpus, id2word=dictionary, num_topics=100)\n\n  `gensim` uses a fast implementation of online LDA parameter estimation based on [2]_,\n  modified to run in `distributed mode <distributed>` on a cluster of computers.\n\n* `Hierarchical Dirichlet Process, HDP <http://jmlr.csail.mit.edu/proceedings/papers/v15/wang11a/wang11a.pdf>`_\n  is a non-parametric bayesian method (note the missing number of requested topics):\n\n  .. sourcecode:: pycon\n\n    model = models.HdpModel(corpus, id2word=dictionary)\n\n  `gensim` uses a fast, online implementation based on [3]_.\n  The HDP model is a new addition to `gensim`, and still rough around its academic edges -- use with care.\n\nAdding new :abbr:`VSM (Vector Space Model)` transformations (such as different weighting schemes) is rather trivial;\nsee the `apiref` or directly the `Python code <https://github.com/piskvorky/gensim/blob/develop/gensim/models/tfidfmodel.py>`_\nfor more info and examples.\n\nIt is worth repeating that these are all unique, **incremental** implementations,\nwhich do not require the whole training corpus to be present in main memory all at once.\nWith memory taken care of, I am now improving `distributed`,\nto improve CPU efficiency, too.\nIf you feel you could contribute by testing, providing use-cases or code, see the `Gensim Developer guide <https://github.com/RaRe-Technologies/gensim/wiki/Developer-page>`__.\n\nWhat Next?\n----------\n\nContinue on to the next tutorial on `sphx_glr_auto_examples_core_run_similarity_queries.py`.\n\nReferences\n----------\n\n.. [1] Bradford. 2008. An empirical study of required dimensionality for large-scale latent semantic indexing applications.\n\n.. [2] Hoffman, Blei, Bach. 2010. Online learning for Latent Dirichlet Allocation.\n\n.. [3] Wang, Paisley, Blei. 2011. Online variational inference for the hierarchical Dirichlet process.\n\n.. [4] Halko, Martinsson, Tropp. 2009. Finding structure with randomness.\n\n.. [5] \u0158eh\u016f\u0159ek. 2011. Subspace tracking for Latent Semantic Analysis.\n\n"
+        "The next question might be: just how exactly similar are those documents to each other?\nIs there a way to formalize the similarity, so that for a given input document, we can\norder some other set of documents according to their similarity? Similarity queries\nare covered in the next tutorial (`sphx_glr_auto_examples_core_run_similarity_queries.py`).\n\n\n## Available transformations\n\nGensim implements several popular Vector Space Model algorithms:\n\n* `Term Frequency * Inverse Document Frequency, Tf-Idf <http://en.wikipedia.org/wiki/Tf%E2%80%93idf>`_\n  expects a bag-of-words (integer values) training corpus during initialization.\n  During transformation, it will take a vector and return another vector of the\n  same dimensionality, except that features which were rare in the training corpus\n  will have their value increased.\n  It therefore converts integer-valued vectors into real-valued ones, while leaving\n  the number of dimensions intact. It can also optionally normalize the resulting\n  vectors to (Euclidean) unit length.\n\n .. sourcecode:: pycon\n\n    model = models.TfidfModel(corpus, normalize=True)\n\n* `Okapi Best Matching, Okapi BM25 <https://en.wikipedia.org/wiki/Okapi_BM25>`_\n  expects a bag-of-words (integer values) training corpus during initialization.\n  During transformation, it will take a vector and return another vector of the\n  same dimensionality, except that features which were rare in the training corpus\n  will have their value increased. It therefore converts integer-valued\n  vectors into real-valued ones, while leaving the number of dimensions intact.\n\n  Okapi BM25 is the standard ranking function used by search engines to estimate\n  the relevance of documents to a given search query.\n\n .. sourcecode:: pycon\n\n    model = models.OkapiBM25Model(corpus)\n\n* `Latent Semantic Indexing, LSI (or sometimes LSA) <http://en.wikipedia.org/wiki/Latent_semantic_indexing>`_\n  transforms documents from either bag-of-words or (preferrably) TfIdf-weighted space into\n  a latent space of a lower dimensionality. For the toy corpus above we used only\n  2 latent dimensions, but on real corpora, target dimensionality of 200--500 is recommended\n  as a \"golden standard\" [1]_.\n\n  .. sourcecode:: pycon\n\n    model = models.LsiModel(tfidf_corpus, id2word=dictionary, num_topics=300)\n\n  LSI training is unique in that we can continue \"training\" at any point, simply\n  by providing more training documents. This is done by incremental updates to\n  the underlying model, in a process called `online training`. Because of this feature, the\n  input document stream may even be infinite -- just keep feeding LSI new documents\n  as they arrive, while using the computed transformation model as read-only in the meanwhile!\n\n  .. sourcecode:: pycon\n\n    model.add_documents(another_tfidf_corpus)  # now LSI has been trained on tfidf_corpus + another_tfidf_corpus\n    lsi_vec = model[tfidf_vec]  # convert some new document into the LSI space, without affecting the model\n\n    model.add_documents(more_documents)  # tfidf_corpus + another_tfidf_corpus + more_documents\n    lsi_vec = model[tfidf_vec]\n\n  See the :mod:`gensim.models.lsimodel` documentation for details on how to make\n  LSI gradually \"forget\" old observations in infinite streams. If you want to get dirty,\n  there are also parameters you can tweak that affect speed vs. memory footprint vs. numerical\n  precision of the LSI algorithm.\n\n  `gensim` uses a novel online incremental streamed distributed training algorithm (quite a mouthful!),\n  which I published in [5]_. `gensim` also executes a stochastic multi-pass algorithm\n  from Halko et al. [4]_ internally, to accelerate in-core part\n  of the computations.\n  See also `wiki` for further speed-ups by distributing the computation across\n  a cluster of computers.\n\n* `Random Projections, RP <http://www.cis.hut.fi/ella/publications/randproj_kdd.pdf>`_ aim to\n  reduce vector space dimensionality. This is a very efficient (both memory- and\n  CPU-friendly) approach to approximating TfIdf distances between documents, by throwing in a little randomness.\n  Recommended target dimensionality is again in the hundreds/thousands, depending on your dataset.\n\n  .. sourcecode:: pycon\n\n    model = models.RpModel(tfidf_corpus, num_topics=500)\n\n* `Latent Dirichlet Allocation, LDA <http://en.wikipedia.org/wiki/Latent_Dirichlet_allocation>`_\n  is yet another transformation from bag-of-words counts into a topic space of lower\n  dimensionality. LDA is a probabilistic extension of LSA (also called multinomial PCA),\n  so LDA's topics can be interpreted as probability distributions over words. These distributions are,\n  just like with LSA, inferred automatically from a training corpus. Documents\n  are in turn interpreted as a (soft) mixture of these topics (again, just like with LSA).\n\n  .. sourcecode:: pycon\n\n    model = models.LdaModel(corpus, id2word=dictionary, num_topics=100)\n\n  `gensim` uses a fast implementation of online LDA parameter estimation based on [2]_,\n  modified to run in `distributed mode <distributed>` on a cluster of computers.\n\n* `Hierarchical Dirichlet Process, HDP <http://jmlr.csail.mit.edu/proceedings/papers/v15/wang11a/wang11a.pdf>`_\n  is a non-parametric bayesian method (note the missing number of requested topics):\n\n  .. sourcecode:: pycon\n\n    model = models.HdpModel(corpus, id2word=dictionary)\n\n  `gensim` uses a fast, online implementation based on [3]_.\n  The HDP model is a new addition to `gensim`, and still rough around its academic edges -- use with care.\n\nAdding new :abbr:`VSM (Vector Space Model)` transformations (such as different weighting schemes) is rather trivial;\nsee the `apiref` or directly the `Python code <https://github.com/piskvorky/gensim/blob/develop/gensim/models/tfidfmodel.py>`_\nfor more info and examples.\n\nIt is worth repeating that these are all unique, **incremental** implementations,\nwhich do not require the whole training corpus to be present in main memory all at once.\nWith memory taken care of, I am now improving `distributed`,\nto improve CPU efficiency, too.\nIf you feel you could contribute by testing, providing use-cases or code, see the `Gensim Developer guide <https://github.com/RaRe-Technologies/gensim/wiki/Developer-page>`__.\n\n## What Next?\n\nContinue on to the next tutorial on `sphx_glr_auto_examples_core_run_similarity_queries.py`.\n\n## References\n\n.. [1] Bradford. 2008. An empirical study of required dimensionality for large-scale latent semantic indexing applications.\n\n.. [2] Hoffman, Blei, Bach. 2010. Online learning for Latent Dirichlet Allocation.\n\n.. [3] Wang, Paisley, Blei. 2011. Online variational inference for the hierarchical Dirichlet process.\n\n.. [4] Halko, Martinsson, Tropp. 2009. Finding structure with randomness.\n\n.. [5] \u0158eh\u016f\u0159ek. 2011. Subspace tracking for Latent Semantic Analysis.\n\n"
       ]
     },
     {
@@ -208,7 +208,7 @@
       "name": "python",
       "nbconvert_exporter": "python",
       "pygments_lexer": "ipython3",
-      "version": "3.6.5"
+      "version": "3.8.13"
     }
   },
   "nbformat": 4,
diff --git a/docs/src/auto_examples/core/run_topics_and_transformations.py b/docs/src/auto_examples/core/run_topics_and_transformations.py
index 605584084d..45888505e0 100644
--- a/docs/src/auto_examples/core/run_topics_and_transformations.py
+++ b/docs/src/auto_examples/core/run_topics_and_transformations.py
@@ -188,6 +188,20 @@
 #
 #     model = models.TfidfModel(corpus, normalize=True)
 #
+# * `Okapi Best Matching, Okapi BM25 <https://en.wikipedia.org/wiki/Okapi_BM25>`_
+#   expects a bag-of-words (integer values) training corpus during initialization.
+#   During transformation, it will take a vector and return another vector of the
+#   same dimensionality, except that features which were rare in the training corpus
+#   will have their value increased. It therefore converts integer-valued
+#   vectors into real-valued ones, while leaving the number of dimensions intact.
+#
+#   Okapi BM25 is the standard ranking function used by search engines to estimate
+#   the relevance of documents to a given search query.
+#
+#  .. sourcecode:: pycon
+#
+#     model = models.OkapiBM25Model(corpus)
+#
 # * `Latent Semantic Indexing, LSI (or sometimes LSA) <http://en.wikipedia.org/wiki/Latent_semantic_indexing>`_
 #   transforms documents from either bag-of-words or (preferrably) TfIdf-weighted space into
 #   a latent space of a lower dimensionality. For the toy corpus above we used only
diff --git a/docs/src/auto_examples/core/run_topics_and_transformations.py.md5 b/docs/src/auto_examples/core/run_topics_and_transformations.py.md5
index 4ea3bee39d..ce683c931f 100644
--- a/docs/src/auto_examples/core/run_topics_and_transformations.py.md5
+++ b/docs/src/auto_examples/core/run_topics_and_transformations.py.md5
@@ -1 +1 @@
-f49c3821bbacdeefdf3945d5dcb5ad01
\ No newline at end of file
+226db24f9e807e4bbd2a6ef280a75510
\ No newline at end of file
diff --git a/docs/src/auto_examples/core/run_topics_and_transformations.rst b/docs/src/auto_examples/core/run_topics_and_transformations.rst
index a5056ee4e3..64c9675939 100644
--- a/docs/src/auto_examples/core/run_topics_and_transformations.rst
+++ b/docs/src/auto_examples/core/run_topics_and_transformations.rst
@@ -1,12 +1,21 @@
+
+.. DO NOT EDIT.
+.. THIS FILE WAS AUTOMATICALLY GENERATED BY SPHINX-GALLERY.
+.. TO MAKE CHANGES, EDIT THE SOURCE PYTHON FILE:
+.. "auto_examples/core/run_topics_and_transformations.py"
+.. LINE NUMBERS ARE GIVEN BELOW.
+
 .. only:: html
 
     .. note::
         :class: sphx-glr-download-link-note
 
-        Click :ref:`here <sphx_glr_download_auto_examples_core_run_topics_and_transformations.py>`     to download the full example code
-    .. rst-class:: sphx-glr-example-title
+        Click :ref:`here <sphx_glr_download_auto_examples_core_run_topics_and_transformations.py>`
+        to download the full example code
+
+.. rst-class:: sphx-glr-example-title
 
-    .. _sphx_glr_auto_examples_core_run_topics_and_transformations.py:
+.. _sphx_glr_auto_examples_core_run_topics_and_transformations.py:
 
 
 Topics and Transformations
@@ -14,6 +23,7 @@ Topics and Transformations
 
 Introduces transformations and demonstrates their use on a toy corpus.
 
+.. GENERATED FROM PYTHON SOURCE LINES 7-11
 
 .. code-block:: default
 
@@ -28,6 +38,8 @@ Introduces transformations and demonstrates their use on a toy corpus.
 
 
 
+.. GENERATED FROM PYTHON SOURCE LINES 12-28
+
 In this tutorial, I will show how to transform documents from one vector representation
 into another. This process serves two goals:
 
@@ -45,6 +57,7 @@ First, we need to create a corpus to work with.
 This step is the same as in the previous tutorial;
 if you completed it, feel free to skip to the next section.
 
+.. GENERATED FROM PYTHON SOURCE LINES 28-65
 
 .. code-block:: default
 
@@ -89,8 +102,20 @@ if you completed it, feel free to skip to the next section.
 
 
 
+.. rst-class:: sphx-glr-script-out
+
+ Out:
+
+ .. code-block:: none
+
+    2022-07-18 19:59:38,851 : INFO : adding document #0 to Dictionary<0 unique tokens: []>
+    2022-07-18 19:59:38,852 : INFO : built Dictionary<12 unique tokens: ['computer', 'human', 'interface', 'response', 'survey']...> from 9 documents (total 29 corpus positions)
+    2022-07-18 19:59:38,853 : INFO : Dictionary lifecycle event {'msg': "built Dictionary<12 unique tokens: ['computer', 'human', 'interface', 'response', 'survey']...> from 9 documents (total 29 corpus positions)", 'datetime': '2022-07-18T19:59:38.852315', 'gensim': '4.2.1.dev0', 'python': '3.8.13 (default, Jul 12 2022, 12:32:46) \n[GCC 10.2.1 20210110]', 'platform': 'Linux-5.10.0-0.bpo.12-amd64-x86_64-with-glibc2.2.5', 'event': 'created'}
+
+
 
 
+.. GENERATED FROM PYTHON SOURCE LINES 66-72
 
 Creating a transformation
 ++++++++++++++++++++++++++
@@ -99,6 +124,7 @@ The transformations are standard Python objects, typically initialized by means
 a :dfn:`training corpus`:
 
 
+.. GENERATED FROM PYTHON SOURCE LINES 73-77
 
 .. code-block:: default
 
@@ -110,9 +136,21 @@ a :dfn:`training corpus`:
 
 
 
+.. rst-class:: sphx-glr-script-out
+
+ Out:
+
+ .. code-block:: none
+
+    2022-07-18 19:59:38,866 : INFO : collecting document frequencies
+    2022-07-18 19:59:38,866 : INFO : PROGRESS: processing document #0
+    2022-07-18 19:59:38,868 : INFO : TfidfModel lifecycle event {'msg': 'calculated IDF weights for 9 documents and 12 features (28 matrix non-zeros)', 'datetime': '2022-07-18T19:59:38.868192', 'gensim': '4.2.1.dev0', 'python': '3.8.13 (default, Jul 12 2022, 12:32:46) \n[GCC 10.2.1 20210110]', 'platform': 'Linux-5.10.0-0.bpo.12-amd64-x86_64-with-glibc2.2.5', 'event': 'initialize'}
 
 
 
+
+.. GENERATED FROM PYTHON SOURCE LINES 78-100
+
 We used our old corpus from tutorial 1 to initialize (train) the transformation model. Different
 transformations may require different initialization parameters; in case of TfIdf, the
 "training" consists simply of going through the supplied corpus once and computing document frequencies
@@ -136,6 +174,7 @@ From now on, ``tfidf`` is treated as a read-only object that can be used to conv
 any vector from the old representation (bag-of-words integer counts) to the new representation
 (TfIdf real-valued weights):
 
+.. GENERATED FROM PYTHON SOURCE LINES 100-104
 
 .. code-block:: default
 
@@ -158,8 +197,11 @@ any vector from the old representation (bag-of-words integer counts) to the new
 
 
 
+.. GENERATED FROM PYTHON SOURCE LINES 105-106
+
 Or to apply a transformation to a whole corpus:
 
+.. GENERATED FROM PYTHON SOURCE LINES 106-111
 
 .. code-block:: default
 
@@ -191,6 +233,8 @@ Or to apply a transformation to a whole corpus:
 
 
 
+.. GENERATED FROM PYTHON SOURCE LINES 112-128
+
 In this particular case, we are transforming the same corpus that we used
 for training, but this is only incidental. Once the transformation model has been initialized,
 it can be used on any vectors (provided they come from the same vector space, of course),
@@ -208,6 +252,7 @@ folding-in for LSA, by topic inference for LDA etc.
 
 Transformations can also be serialized, one on top of another, in a sort of chain:
 
+.. GENERATED FROM PYTHON SOURCE LINES 128-132
 
 .. code-block:: default
 
@@ -219,13 +264,36 @@ Transformations can also be serialized, one on top of another, in a sort of chai
 
 
 
+.. rst-class:: sphx-glr-script-out
+
+ Out:
+
+ .. code-block:: none
+
+    2022-07-18 19:59:39,141 : INFO : using serial LSI version on this node
+    2022-07-18 19:59:39,142 : INFO : updating model with new documents
+    2022-07-18 19:59:39,143 : INFO : preparing a new chunk of documents
+    2022-07-18 19:59:39,144 : INFO : using 100 extra samples and 2 power iterations
+    2022-07-18 19:59:39,144 : INFO : 1st phase: constructing (12, 102) action matrix
+    2022-07-18 19:59:39,146 : INFO : orthonormalizing (12, 102) action matrix
+    2022-07-18 19:59:39,148 : INFO : 2nd phase: running dense svd on (12, 9) matrix
+    2022-07-18 19:59:39,148 : INFO : computing the final decomposition
+    2022-07-18 19:59:39,149 : INFO : keeping 2 factors (discarding 47.565% of energy spectrum)
+    2022-07-18 19:59:39,150 : INFO : processed documents up to #9
+    2022-07-18 19:59:39,151 : INFO : topic #0(1.594): 0.703*"trees" + 0.538*"graph" + 0.402*"minors" + 0.187*"survey" + 0.061*"system" + 0.060*"time" + 0.060*"response" + 0.058*"user" + 0.049*"computer" + 0.035*"interface"
+    2022-07-18 19:59:39,151 : INFO : topic #1(1.476): -0.460*"system" + -0.373*"user" + -0.332*"eps" + -0.328*"interface" + -0.320*"time" + -0.320*"response" + -0.293*"computer" + -0.280*"human" + -0.171*"survey" + 0.161*"trees"
+    2022-07-18 19:59:39,151 : INFO : LsiModel lifecycle event {'msg': 'trained LsiModel<num_terms=12, num_topics=2, decay=1.0, chunksize=20000> in 0.01s', 'datetime': '2022-07-18T19:59:39.151911', 'gensim': '4.2.1.dev0', 'python': '3.8.13 (default, Jul 12 2022, 12:32:46) \n[GCC 10.2.1 20210110]', 'platform': 'Linux-5.10.0-0.bpo.12-amd64-x86_64-with-glibc2.2.5', 'event': 'created'}
+
+
 
 
+.. GENERATED FROM PYTHON SOURCE LINES 133-136
 
 Here we transformed our Tf-Idf corpus via `Latent Semantic Indexing <http://en.wikipedia.org/wiki/Latent_semantic_indexing>`_
 into a latent 2-D space (2-D because we set ``num_topics=2``). Now you're probably wondering: what do these two latent
 dimensions stand for? Let's inspect with :func:`models.LsiModel.print_topics`:
 
+.. GENERATED FROM PYTHON SOURCE LINES 136-139
 
 .. code-block:: default
 
@@ -242,11 +310,15 @@ dimensions stand for? Let's inspect with :func:`models.LsiModel.print_topics`:
 
  .. code-block:: none
 
+    2022-07-18 19:59:39,298 : INFO : topic #0(1.594): 0.703*"trees" + 0.538*"graph" + 0.402*"minors" + 0.187*"survey" + 0.061*"system" + 0.060*"time" + 0.060*"response" + 0.058*"user" + 0.049*"computer" + 0.035*"interface"
+    2022-07-18 19:59:39,298 : INFO : topic #1(1.476): -0.460*"system" + -0.373*"user" + -0.332*"eps" + -0.328*"interface" + -0.320*"time" + -0.320*"response" + -0.293*"computer" + -0.280*"human" + -0.171*"survey" + 0.161*"trees"
 
-    [(0, '0.703*"trees" + 0.538*"graph" + 0.402*"minors" + 0.187*"survey" + 0.061*"system" + 0.060*"response" + 0.060*"time" + 0.058*"user" + 0.049*"computer" + 0.035*"interface"'), (1, '-0.460*"system" + -0.373*"user" + -0.332*"eps" + -0.328*"interface" + -0.320*"response" + -0.320*"time" + -0.293*"computer" + -0.280*"human" + -0.171*"survey" + 0.161*"trees"')]
+    [(0, '0.703*"trees" + 0.538*"graph" + 0.402*"minors" + 0.187*"survey" + 0.061*"system" + 0.060*"time" + 0.060*"response" + 0.058*"user" + 0.049*"computer" + 0.035*"interface"'), (1, '-0.460*"system" + -0.373*"user" + -0.332*"eps" + -0.328*"interface" + -0.320*"time" + -0.320*"response" + -0.293*"computer" + -0.280*"human" + -0.171*"survey" + 0.161*"trees"')]
 
 
 
+.. GENERATED FROM PYTHON SOURCE LINES 140-148
+
 (the topics are printed to log -- see the note at the top of this page about activating
 logging)
 
@@ -256,6 +328,7 @@ second topic practically concerns itself with all the other words. As expected,
 the first five documents are more strongly related to the second topic while the
 remaining four documents to the first topic:
 
+.. GENERATED FROM PYTHON SOURCE LINES 148-153
 
 .. code-block:: default
 
@@ -274,21 +347,24 @@ remaining four documents to the first topic:
 
  .. code-block:: none
 
-    [(0, 0.06600783396090518), (1, -0.520070330636184)] Human machine interface for lab abc computer applications
-    [(0, 0.19667592859142694), (1, -0.7609563167700047)] A survey of user opinion of computer system response time
-    [(0, 0.08992639972446678), (1, -0.72418606267525)] The EPS user interface management system
-    [(0, 0.07585847652178407), (1, -0.6320551586003417)] System and human system engineering testing of EPS
-    [(0, 0.10150299184980252), (1, -0.5737308483002961)] Relation of user perceived response time to error measurement
-    [(0, 0.7032108939378307), (1, 0.16115180214025954)] The generation of random binary unordered trees
-    [(0, 0.8774787673119826), (1, 0.16758906864659615)] The intersection graph of paths in trees
-    [(0, 0.9098624686818572), (1, 0.14086553628719237)] Graph minors IV Widths of trees and well quasi ordering
-    [(0, 0.6165825350569278), (1, -0.05392907566389235)] Graph minors A survey
+    [(0, 0.06600783396090446), (1, -0.5200703306361851)] Human machine interface for lab abc computer applications
+    [(0, 0.19667592859142627), (1, -0.7609563167700037)] A survey of user opinion of computer system response time
+    [(0, 0.08992639972446514), (1, -0.724186062675251)] The EPS user interface management system
+    [(0, 0.07585847652178207), (1, -0.632055158600343)] System and human system engineering testing of EPS
+    [(0, 0.10150299184980262), (1, -0.5737308483002944)] Relation of user perceived response time to error measurement
+    [(0, 0.703210893937831), (1, 0.16115180214025884)] The generation of random binary unordered trees
+    [(0, 0.8774787673119828), (1, 0.16758906864659542)] The intersection graph of paths in trees
+    [(0, 0.9098624686818574), (1, 0.14086553628719167)] Graph minors IV Widths of trees and well quasi ordering
+    [(0, 0.6165825350569278), (1, -0.05392907566389242)] Graph minors A survey
+
 
 
 
+.. GENERATED FROM PYTHON SOURCE LINES 154-155
 
 Model persistency is achieved with the :func:`save` and :func:`load` functions:
 
+.. GENERATED FROM PYTHON SOURCE LINES 155-165
 
 .. code-block:: default
 
@@ -306,8 +382,30 @@ Model persistency is achieved with the :func:`save` and :func:`load` functions:
 
 
 
+.. rst-class:: sphx-glr-script-out
+
+ Out:
+
+ .. code-block:: none
+
+    2022-07-18 19:59:39,441 : INFO : Projection lifecycle event {'fname_or_handle': '/tmp/model-rpai5uj5.lsi.projection', 'separately': 'None', 'sep_limit': 10485760, 'ignore': frozenset(), 'datetime': '2022-07-18T19:59:39.441811', 'gensim': '4.2.1.dev0', 'python': '3.8.13 (default, Jul 12 2022, 12:32:46) \n[GCC 10.2.1 20210110]', 'platform': 'Linux-5.10.0-0.bpo.12-amd64-x86_64-with-glibc2.2.5', 'event': 'saving'}
+    2022-07-18 19:59:39,443 : INFO : saved /tmp/model-rpai5uj5.lsi.projection
+    2022-07-18 19:59:39,443 : INFO : LsiModel lifecycle event {'fname_or_handle': '/tmp/model-rpai5uj5.lsi', 'separately': 'None', 'sep_limit': 10485760, 'ignore': ['projection', 'dispatcher'], 'datetime': '2022-07-18T19:59:39.443722', 'gensim': '4.2.1.dev0', 'python': '3.8.13 (default, Jul 12 2022, 12:32:46) \n[GCC 10.2.1 20210110]', 'platform': 'Linux-5.10.0-0.bpo.12-amd64-x86_64-with-glibc2.2.5', 'event': 'saving'}
+    2022-07-18 19:59:39,444 : INFO : not storing attribute projection
+    2022-07-18 19:59:39,444 : INFO : not storing attribute dispatcher
+    2022-07-18 19:59:39,444 : INFO : saved /tmp/model-rpai5uj5.lsi
+    2022-07-18 19:59:39,444 : INFO : loading LsiModel object from /tmp/model-rpai5uj5.lsi
+    2022-07-18 19:59:39,445 : INFO : loading id2word recursively from /tmp/model-rpai5uj5.lsi.id2word.* with mmap=None
+    2022-07-18 19:59:39,445 : INFO : setting ignored attribute projection to None
+    2022-07-18 19:59:39,445 : INFO : setting ignored attribute dispatcher to None
+    2022-07-18 19:59:39,445 : INFO : LsiModel lifecycle event {'fname': '/tmp/model-rpai5uj5.lsi', 'datetime': '2022-07-18T19:59:39.445641', 'gensim': '4.2.1.dev0', 'python': '3.8.13 (default, Jul 12 2022, 12:32:46) \n[GCC 10.2.1 20210110]', 'platform': 'Linux-5.10.0-0.bpo.12-amd64-x86_64-with-glibc2.2.5', 'event': 'loaded'}
+    2022-07-18 19:59:39,445 : INFO : loading LsiModel object from /tmp/model-rpai5uj5.lsi.projection
+    2022-07-18 19:59:39,446 : INFO : Projection lifecycle event {'fname': '/tmp/model-rpai5uj5.lsi.projection', 'datetime': '2022-07-18T19:59:39.446113', 'gensim': '4.2.1.dev0', 'python': '3.8.13 (default, Jul 12 2022, 12:32:46) \n[GCC 10.2.1 20210110]', 'platform': 'Linux-5.10.0-0.bpo.12-amd64-x86_64-with-glibc2.2.5', 'event': 'loaded'}
+
+
 
 
+.. GENERATED FROM PYTHON SOURCE LINES 166-301
 
 The next question might be: just how exactly similar are those documents to each other?
 Is there a way to formalize the similarity, so that for a given input document, we can
@@ -334,6 +432,20 @@ Gensim implements several popular Vector Space Model algorithms:
 
     model = models.TfidfModel(corpus, normalize=True)
 
+* `Okapi Best Matching, Okapi BM25 <https://en.wikipedia.org/wiki/Okapi_BM25>`_
+  expects a bag-of-words (integer values) training corpus during initialization.
+  During transformation, it will take a vector and return another vector of the
+  same dimensionality, except that features which were rare in the training corpus
+  will have their value increased. It therefore converts integer-valued
+  vectors into real-valued ones, while leaving the number of dimensions intact.
+
+  Okapi BM25 is the standard ranking function used by search engines to estimate
+  the relevance of documents to a given search query.
+
+ .. sourcecode:: pycon
+
+    model = models.OkapiBM25Model(corpus)
+
 * `Latent Semantic Indexing, LSI (or sometimes LSA) <http://en.wikipedia.org/wiki/Latent_semantic_indexing>`_
   transforms documents from either bag-of-words or (preferrably) TfIdf-weighted space into
   a latent space of a lower dimensionality. For the toy corpus above we used only
@@ -431,6 +543,7 @@ References
 
 .. [5] Řehůřek. 2011. Subspace tracking for Latent Semantic Analysis.
 
+.. GENERATED FROM PYTHON SOURCE LINES 301-307
 
 .. code-block:: default
 
@@ -443,9 +556,10 @@ References
 
 
 
-.. image:: /auto_examples/core/images/sphx_glr_run_topics_and_transformations_001.png
-    :alt: run topics and transformations
-    :class: sphx-glr-single-img
+.. image-sg:: /auto_examples/core/images/sphx_glr_run_topics_and_transformations_001.png
+   :alt: run topics and transformations
+   :srcset: /auto_examples/core/images/sphx_glr_run_topics_and_transformations_001.png
+   :class: sphx-glr-single-img
 
 
 
@@ -454,9 +568,9 @@ References
 
 .. rst-class:: sphx-glr-timing
 
-   **Total running time of the script:** ( 0 minutes  0.970 seconds)
+   **Total running time of the script:** ( 0 minutes  1.658 seconds)
 
-**Estimated memory usage:**  7 MB
+**Estimated memory usage:**  58 MB
 
 
 .. _sphx_glr_download_auto_examples_core_run_topics_and_transformations.py:
diff --git a/docs/src/auto_examples/core/sg_execution_times.rst b/docs/src/auto_examples/core/sg_execution_times.rst
index e206b6d636..26ebfe6747 100644
--- a/docs/src/auto_examples/core/sg_execution_times.rst
+++ b/docs/src/auto_examples/core/sg_execution_times.rst
@@ -5,14 +5,14 @@
 
 Computation times
 =================
-**00:05.212** total execution time for **auto_examples_core** files:
+**00:01.658** total execution time for **auto_examples_core** files:
 
 +--------------------------------------------------------------------------------------------------------------+-----------+---------+
-| :ref:`sphx_glr_auto_examples_core_run_corpora_and_vector_spaces.py` (``run_corpora_and_vector_spaces.py``)   | 00:05.212 | 47.2 MB |
+| :ref:`sphx_glr_auto_examples_core_run_topics_and_transformations.py` (``run_topics_and_transformations.py``) | 00:01.658 | 58.1 MB |
 +--------------------------------------------------------------------------------------------------------------+-----------+---------+
 | :ref:`sphx_glr_auto_examples_core_run_core_concepts.py` (``run_core_concepts.py``)                           | 00:00.000 | 0.0 MB  |
 +--------------------------------------------------------------------------------------------------------------+-----------+---------+
-| :ref:`sphx_glr_auto_examples_core_run_similarity_queries.py` (``run_similarity_queries.py``)                 | 00:00.000 | 0.0 MB  |
+| :ref:`sphx_glr_auto_examples_core_run_corpora_and_vector_spaces.py` (``run_corpora_and_vector_spaces.py``)   | 00:00.000 | 0.0 MB  |
 +--------------------------------------------------------------------------------------------------------------+-----------+---------+
-| :ref:`sphx_glr_auto_examples_core_run_topics_and_transformations.py` (``run_topics_and_transformations.py``) | 00:00.000 | 0.0 MB  |
+| :ref:`sphx_glr_auto_examples_core_run_similarity_queries.py` (``run_similarity_queries.py``)                 | 00:00.000 | 0.0 MB  |
 +--------------------------------------------------------------------------------------------------------------+-----------+---------+
diff --git a/docs/src/auto_examples/index.rst b/docs/src/auto_examples/index.rst
index ca47a1738e..a1f42f795e 100644
--- a/docs/src/auto_examples/index.rst
+++ b/docs/src/auto_examples/index.rst
@@ -220,7 +220,7 @@ Learning-oriented lessons that introduce a particular gensim feature, e.g. a mod
 
 .. raw:: html
 
-    <div class="sphx-glr-thumbcontainer" tooltip="Demonstrates using Gensim&#x27;s implemenation of the WMD.">
+    <div class="sphx-glr-thumbcontainer" tooltip="Demonstrates using Gensim&#x27;s implemenation of the SCM.">
 
 .. only:: html
 
@@ -237,7 +237,7 @@ Learning-oriented lessons that introduce a particular gensim feature, e.g. a mod
 
 .. raw:: html
 
-    <div class="sphx-glr-thumbcontainer" tooltip="Demonstrates using Gensim&#x27;s implemenation of the SCM.">
+    <div class="sphx-glr-thumbcontainer" tooltip="Demonstrates using Gensim&#x27;s implemenation of the WMD.">
 
 .. only:: html
 
diff --git a/docs/src/gallery/core/run_topics_and_transformations.py b/docs/src/gallery/core/run_topics_and_transformations.py
index 605584084d..45888505e0 100644
--- a/docs/src/gallery/core/run_topics_and_transformations.py
+++ b/docs/src/gallery/core/run_topics_and_transformations.py
@@ -188,6 +188,20 @@
 #
 #     model = models.TfidfModel(corpus, normalize=True)
 #
+# * `Okapi Best Matching, Okapi BM25 <https://en.wikipedia.org/wiki/Okapi_BM25>`_
+#   expects a bag-of-words (integer values) training corpus during initialization.
+#   During transformation, it will take a vector and return another vector of the
+#   same dimensionality, except that features which were rare in the training corpus
+#   will have their value increased. It therefore converts integer-valued
+#   vectors into real-valued ones, while leaving the number of dimensions intact.
+#
+#   Okapi BM25 is the standard ranking function used by search engines to estimate
+#   the relevance of documents to a given search query.
+#
+#  .. sourcecode:: pycon
+#
+#     model = models.OkapiBM25Model(corpus)
+#
 # * `Latent Semantic Indexing, LSI (or sometimes LSA) <http://en.wikipedia.org/wiki/Latent_semantic_indexing>`_
 #   transforms documents from either bag-of-words or (preferrably) TfIdf-weighted space into
 #   a latent space of a lower dimensionality. For the toy corpus above we used only
diff --git a/gensim/models/__init__.py b/gensim/models/__init__.py
index ac08d1fdb4..d9a28ead34 100644
--- a/gensim/models/__init__.py
+++ b/gensim/models/__init__.py
@@ -9,6 +9,7 @@
 from .ldamodel import LdaModel  # noqa:F401
 from .lsimodel import LsiModel  # noqa:F401
 from .tfidfmodel import TfidfModel  # noqa:F401
+from .bm25model import OkapiBM25Model, LuceneBM25Model, AtireBM25Model  # noqa:F401
 from .rpmodel import RpModel  # noqa:F401
 from .logentropy_model import LogEntropyModel  # noqa:F401
 from .word2vec import Word2Vec, FAST_VERSION  # noqa:F401
diff --git a/gensim/models/bm25model.py b/gensim/models/bm25model.py
new file mode 100644
index 0000000000..265afb3af9
--- /dev/null
+++ b/gensim/models/bm25model.py
@@ -0,0 +1,391 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+
+"""This module implements functionality related to the `Okapi Best Matching
+<https://en.wikipedia.org/wiki/Okapi_BM25>`_ class of bag-of-words vector space models.
+
+Robertson and Zaragoza [1]_ describe the original algorithm and its modifications.
+
+.. [1] Robertson S., Zaragoza H. (2015). `The Probabilistic Relevance Framework: BM25 and
+   Beyond, <http://www.staff.city.ac.uk/~sb317/papers/foundations_bm25_review.pdf>`_.
+
+"""
+
+from abc import ABCMeta, abstractmethod
+from collections import defaultdict
+import logging
+import math
+
+from gensim import interfaces, utils
+import numpy as np
+
+
+logger = logging.getLogger(__name__)
+
+
+class BM25ABC(interfaces.TransformationABC, metaclass=ABCMeta):
+    """Objects of this abstract class realize the transformation between word-document co-occurrence
+    matrix (int) into a BM25 matrix (positive floats). Concrete subclasses of this abstract class
+    implement different BM25 scoring functions.
+
+    """
+    def __init__(self, corpus=None, dictionary=None):
+        r"""Pre-compute the average length of a document and inverse term document frequencies,
+        which will be used to weight term frequencies for the documents.
+
+        Parameters
+        ----------
+        corpus : iterable of iterable of (int, int) or None, optional
+            An input corpus, which will be used to compute the average length of a document and
+            inverse term document frequencies. If None, then `dictionary` will be used to compute
+            the statistics. If both `corpus` and `dictionary` are None, the statistics will be left
+            unintialized. Default is None.
+        dictionary : :class:`~gensim.corpora.Dictionary`
+            An input dictionary, which will be used to compute the average length of a document and
+            inverse term document frequencies.  If None, then `corpus` will be used to compute the
+            statistics. If both `corpus` and `dictionary` are None, the statistics will be left
+            unintialized. Default is None.
+
+        Attributes
+        ----------
+        avgdl : float
+            The average length of a document.
+        idfs : dict of (int, float)
+            A mapping from term ids to inverse term document frequencies.
+
+        """
+        self.avgdl, self.idfs = None, None
+        if dictionary:
+            if corpus:
+                logger.warning("constructor received both corpus and dictionary; ignoring the corpus")
+            num_tokens = sum(dictionary.cfs.values())
+            self.avgdl = num_tokens / dictionary.num_docs
+            self.idfs = self.precompute_idfs(dictionary.dfs, dictionary.num_docs)
+        elif corpus:
+            dfs = defaultdict(lambda: 0)
+            num_tokens = 0
+            num_docs = 0
+            for bow in corpus:
+                num_tokens += len(bow)
+                for term_id in set(term_id for term_id, _ in bow):
+                    dfs[term_id] += 1
+                num_docs += 1
+            self.avgdl = num_tokens / num_docs
+            self.idfs = self.precompute_idfs(dfs, num_docs)
+        else:
+            pass
+
+    @abstractmethod
+    def precompute_idfs(self, dfs, num_docs):
+        """Precompute inverse term document frequencies, which will be used to weight term frequencies
+        for the documents.
+
+        Parameters
+        ----------
+        dfs : dict of (int, int)
+            A mapping from term ids to term document frequencies.
+        num_docs : int
+            The total number of documents in the training corpus.
+
+        Returns
+        -------
+        idfs : dict of (int, float)
+            A mapping from term ids to inverse term document frequencies.
+
+        """
+        pass
+
+    @abstractmethod
+    def get_term_weights(self, num_tokens, term_frequencies, idfs):
+        """Compute vector space weights for a set of terms in a document.
+
+        Parameters
+        ----------
+        num_tokens : int
+            The number of tokens in the document.
+        term_frequencies : ndarray
+            1D array of term frequencies.
+        idfs : ndarray
+            1D array of inverse term document frequencies.
+
+        Returns
+        -------
+        term_weights : ndarray
+            1D array of vector space weights.
+
+        """
+        pass
+
+    def __getitem__(self, bow):
+        is_corpus, bow = utils.is_corpus(bow)
+        if is_corpus:
+            return self._apply(bow)
+
+        num_tokens = sum(freq for term_id, freq in bow)
+
+        term_ids, term_frequencies, idfs = [], [], []
+        for term_id, term_frequency in bow:
+            term_ids.append(term_id)
+            term_frequencies.append(term_frequency)
+            idfs.append(self.idfs.get(term_id) or 0.0)
+        term_frequencies, idfs = np.array(term_frequencies), np.array(idfs)
+
+        term_weights = self.get_term_weights(num_tokens, term_frequencies, idfs)
+
+        vector = [
+            (term_id, float(weight))
+            for term_id, weight
+            in zip(term_ids, term_weights)
+        ]
+        return vector
+
+
+class OkapiBM25Model(BM25ABC):
+    """The original Okapi BM25 scoring function of Robertson et al. [2]_.
+
+    Examples
+    --------
+    .. sourcecode:: pycon
+
+        >>> from gensim.corpora import Dictionary
+        >>> from gensim.models import OkapiBM25Model
+        >>> from gensim.test.utils import common_texts
+        >>>
+        >>> dictionary = Dictionary(common_texts)  # fit dictionary
+        >>> model = OkapiBM25Model(dictionary=dictionary)  # fit model
+        >>>
+        >>> corpus = [dictionary.doc2bow(line) for line in common_texts]  # convert corpus to BoW format
+        >>> vector = model[corpus[0]]  # apply model to the first corpus document
+
+    References
+    ----------
+    .. [2] Robertson S. E., Walker S., Jones S., Hancock-Beaulieu M. M., Gatford M. (1995).
+       `Okapi at TREC-3 <http://research.microsoft.com/pubs/67649/okapi_trec3.pdf>`_.
+       *NIST Special Publication 500-226*.
+
+    """
+    def __init__(self, corpus=None, dictionary=None, k1=1.5, b=0.75, epsilon=0.25):
+        r"""Pre-compute the average length of a document and inverse term document frequencies,
+        which will be used to weight term frequencies for the documents.
+
+        Parameters
+        ----------
+        corpus : iterable of iterable of (int, int) or None, optional
+            An input corpus, which will be used to compute the average length of a document and
+            inverse term document frequencies. If None, then `dictionary` will be used to compute
+            the statistics. If both `corpus` and `dictionary` are None, the statistics will be left
+            unintialized. Default is None.
+        dictionary : :class:`~gensim.corpora.Dictionary`
+            An input dictionary, which will be used to compute the average length of a document and
+            inverse term document frequencies.  If None, then `corpus` will be used to compute the
+            statistics. If both `corpus` and `dictionary` are None, the statistics will be left
+            unintialized. Default is None.
+        k1 : float
+            A positive tuning parameter that determines the impact of the term frequency on its BM25
+            weight. Singhal [5]_ suggests to set `k1` between 1.0 and 2.0. Default is 1.5.
+        b : float
+            A tuning parameter between 0.0 and 1.0 that determines the document length
+            normalization: 1.0 corresponds to full document normalization, while 0.0 corresponds to
+            no length normalization. Singhal [5]_ suggests to set `b` to 0.75, which is the default.
+        epsilon : float
+            A positive tuning parameter that lower-bounds an inverse document frequency.
+            Defaults to 0.25.
+
+        Attributes
+        ----------
+        k1 : float
+            A positive tuning parameter that determines the impact of the term frequency on its BM25
+            weight. Singhal [3]_ suggests to set `k1` between 1.0 and 2.0. Default is 1.5.
+        b : float
+            A tuning parameter between 0.0 and 1.0 that determines the document length
+            normalization: 1.0 corresponds to full document normalization, while 0.0 corresponds to
+            no length normalization. Singhal [3]_ suggests to set `b` to 0.75, which is the default.
+        epsilon : float
+            A positive tuning parameter that lower-bounds an inverse document frequency.
+            Defaults to 0.25.
+
+        References
+        ----------
+        .. [3] Singhal, A. (2001). `Modern information retrieval: A brief overview
+           <http://singhal.info/ieee2001.pdf>`_. *IEEE Data Eng. Bull.*, 24(4), 35–43.
+
+        """
+        self.k1, self.b, self.epsilon = k1, b, epsilon
+        super().__init__(corpus, dictionary)
+
+    def precompute_idfs(self, dfs, num_docs):
+        idf_sum = 0
+        idfs = dict()
+        negative_idfs = []
+        for term_id, freq in dfs.items():
+            idf = math.log(num_docs - freq + 0.5) - math.log(freq + 0.5)
+            idfs[term_id] = idf
+            idf_sum += idf
+            if idf < 0:
+                negative_idfs.append(term_id)
+        average_idf = idf_sum / len(idfs)
+
+        eps = self.epsilon * average_idf
+        for term_id in negative_idfs:
+            idfs[term_id] = eps
+
+        return idfs
+
+    def get_term_weights(self, num_tokens, term_frequencies, idfs):
+        term_weights = idfs * (term_frequencies * (self.k1 + 1)
+                              / (term_frequencies + self.k1 * (1 - self.b + self.b
+                                                              * num_tokens / self.avgdl)))
+        return term_weights
+
+
+class LuceneBM25Model(BM25ABC):
+    """The scoring function of Apache Lucene 8 [4]_.
+
+    Examples
+    --------
+    .. sourcecode:: pycon
+
+        >>> from gensim.corpora import Dictionary
+        >>> from gensim.models import LuceneBM25Model
+        >>> from gensim.test.utils import common_texts
+        >>>
+        >>> dictionary = Dictionary(common_texts)  # fit dictionary
+        >>> corpus = [dictionary.doc2bow(line) for line in common_texts]  # convert corpus to BoW format
+        >>>
+        >>> model = LuceneBM25Model(dictionary=dictionary)  # fit model
+        >>> vector = model[corpus[0]]  # apply model to the first corpus document
+
+    References
+    ----------
+    .. [4] Kamphuis, C., de Vries, A. P., Boytsov, L., Lin, J. (2020). Which
+       BM25 Do You Mean? `A Large-Scale Reproducibility Study of Scoring Variants
+       <https://doi.org/10.1007/978-3-030-45442-5_4>`_. In: Advances in Information Retrieval.
+       28–34.
+
+    """
+    def __init__(self, corpus=None, dictionary=None, k1=1.5, b=0.75):
+        r"""Pre-compute the average length of a document and inverse term document frequencies,
+        which will be used to weight term frequencies for the documents.
+
+        Parameters
+        ----------
+        corpus : iterable of iterable of (int, int) or None, optional
+            An input corpus, which will be used to compute the average length of a document and
+            inverse term document frequencies. If None, then `dictionary` will be used to compute
+            the statistics. If both `corpus` and `dictionary` are None, the statistics will be left
+            unintialized. Default is None.
+        dictionary : :class:`~gensim.corpora.Dictionary`
+            An input dictionary, which will be used to compute the average length of a document and
+            inverse term document frequencies.  If None, then `corpus` will be used to compute the
+            statistics. If both `corpus` and `dictionary` are None, the statistics will be left
+            unintialized. Default is None.
+        k1 : float
+            A positive tuning parameter that determines the impact of the term frequency on its BM25
+            weight. Singhal [5]_ suggests to set `k1` between 1.0 and 2.0. Default is 1.5.
+        b : float
+            A tuning parameter between 0.0 and 1.0 that determines the document length
+            normalization: 1.0 corresponds to full document normalization, while 0.0 corresponds to
+            no length normalization. Singhal [5]_ suggests to set `b` to 0.75, which is the default.
+
+        Attributes
+        ----------
+        k1 : float
+            A positive tuning parameter that determines the impact of the term frequency on its BM25
+            weight. Singhal [3]_ suggests to set `k1` between 1.0 and 2.0. Default is 1.5.
+        b : float
+            A tuning parameter between 0.0 and 1.0 that determines the document length
+            normalization: 1.0 corresponds to full document normalization, while 0.0 corresponds to
+            no length normalization. Singhal [3]_ suggests to set `b` to 0.75, which is the default.
+
+        """
+        self.k1, self.b = k1, b
+        super().__init__(corpus, dictionary)
+
+    def precompute_idfs(self, dfs, num_docs):
+        idfs = dict()
+        for term_id, freq in dfs.items():
+            idf = math.log(num_docs + 1.0) - math.log(freq + 0.5)
+            idfs[term_id] = idf
+        return idfs
+
+    def get_term_weights(self, num_tokens, term_frequencies, idfs):
+        term_weights = idfs * (term_frequencies
+                              / (term_frequencies + self.k1 * (1 - self.b + self.b
+                                                              * num_tokens / self.avgdl)))
+        return term_weights
+
+
+class AtireBM25Model(BM25ABC):
+    """The scoring function of Trotman et al. [5]_.
+
+    Examples
+    --------
+    .. sourcecode:: pycon
+
+        >>> from gensim.corpora import Dictionary
+        >>> from gensim.models import AtireBM25Model
+        >>> from gensim.test.utils import common_texts
+        >>>
+        >>> dictionary = Dictionary(common_texts)  # fit dictionary
+        >>> corpus = [dictionary.doc2bow(line) for line in common_texts]  # convert corpus to BoW format
+        >>>
+        >>> model = AtireBM25Model(dictionary=dictionary)  # fit model
+        >>> vector = model[corpus[0]]  # apply model to the first corpus document
+
+    References
+    ----------
+    .. [5] Trotman, A., Jia X., Crane M., `Towards an Efficient and Effective Search Engine
+       <http://www.cs.otago.ac.nz/homepages/andrew/involvement/2012-SIGIR-OSIR.pdf#page=45>`_,
+       In: SIGIR 2012 Workshop on Open Source Information Retrieval. 40–47.
+
+    """
+    def __init__(self, corpus=None, dictionary=None, k1=1.5, b=0.75):
+        r"""Pre-compute the average length of a document and inverse term document frequencies,
+        which will be used to weight term frequencies for the documents.
+
+        Parameters
+        ----------
+        corpus : iterable of iterable of (int, int) or None, optional
+            An input corpus, which will be used to compute the average length of a document and
+            inverse term document frequencies. If None, then `dictionary` will be used to compute
+            the statistics. If both `corpus` and `dictionary` are None, the statistics will be left
+            unintialized. Default is None.
+        dictionary : :class:`~gensim.corpora.Dictionary`
+            An input dictionary, which will be used to compute the average length of a document and
+            inverse term document frequencies.  If None, then `corpus` will be used to compute the
+            statistics. If both `corpus` and `dictionary` are None, the statistics will be left
+            unintialized. Default is None.
+        k1 : float
+            A positive tuning parameter that determines the impact of the term frequency on its BM25
+            weight. Singhal [5]_ suggests to set `k1` between 1.0 and 2.0. Default is 1.5.
+        b : float
+            A tuning parameter between 0.0 and 1.0 that determines the document length
+            normalization: 1.0 corresponds to full document normalization, while 0.0 corresponds to
+            no length normalization. Singhal [5]_ suggests to set `b` to 0.75, which is the default.
+
+        Attributes
+        ----------
+        k1 : float
+            A positive tuning parameter that determines the impact of the term frequency on its BM25
+            weight. Singhal [3]_ suggests to set `k1` between 1.0 and 2.0. Default is 1.5.
+        b : float
+            A tuning parameter between 0.0 and 1.0 that determines the document length
+            normalization: 1.0 corresponds to full document normalization, while 0.0 corresponds to
+            no length normalization. Singhal [3]_ suggests to set `b` to 0.75, which is the default.
+
+        """
+        self.k1, self.b = k1, b
+        super().__init__(corpus, dictionary)
+
+    def precompute_idfs(self, dfs, num_docs):
+        idfs = dict()
+        for term_id, freq in dfs.items():
+            idf = math.log(num_docs) - math.log(freq)
+            idfs[term_id] = idf
+        return idfs
+
+    def get_term_weights(self, num_tokens, term_frequencies, idfs):
+        term_weights = idfs * (term_frequencies * (self.k1 + 1)
+                              / (term_frequencies + self.k1 * (1 - self.b + self.b
+                                                              * num_tokens / self.avgdl)))
+        return term_weights
diff --git a/gensim/similarities/docsim.py b/gensim/similarities/docsim.py
index cdb966547d..a6d5e21bce 100644
--- a/gensim/similarities/docsim.py
+++ b/gensim/similarities/docsim.py
@@ -73,6 +73,7 @@
 import itertools
 import os
 import heapq
+import warnings
 
 import numpy
 import scipy.sparse
@@ -906,7 +907,8 @@ class SoftCosineSimilarity(interfaces.SimilarityABC):
     for more examples.
 
     """
-    def __init__(self, corpus, similarity_matrix, num_best=None, chunksize=256, normalized=(True, True)):
+    def __init__(self, corpus, similarity_matrix, num_best=None, chunksize=256, normalized=None,
+                 normalize_queries=True, normalize_documents=True):
         """
 
         Parameters
@@ -919,12 +921,19 @@ def __init__(self, corpus, similarity_matrix, num_best=None, chunksize=256, norm
             The number of results to retrieve for a query, if None - return similarities with all elements from corpus.
         chunksize: int, optional
             Size of one corpus chunk.
-        normalized : tuple of {True, False, 'maintain'}, optional
-            First/second value specifies whether the query/document vectors in the inner product
-            will be L2-normalized (True; corresponds to the soft cosine similarity measure; default),
-            maintain their L2-norm during change of basis ('maintain'; corresponds to query
-            expansion with partial membership), or kept as-is (False;
-            corresponds to query expansion).
+        normalized : tuple of {True, False, 'maintain', None}, optional
+            A deprecated alias for `(normalize_queries, normalize_documents)`. If None, use
+            `normalize_queries` and `normalize_documents`. Default is None.
+        normalize_queries : {True, False, 'maintain'}, optional
+            Whether the query vector in the inner product will be L2-normalized (True; corresponds
+            to the soft cosine similarity measure; default), maintain their L2-norm during change of
+            basis ('maintain'; corresponds to queryexpansion with partial membership), or kept as-is
+            (False;  corresponds to query expansion).
+        normalize_documents : {True, False, 'maintain'}, optional
+            Whether the document vector in the inner product will be L2-normalized (True; corresponds
+            to the soft cosine similarity measure; default), maintain their L2-norm during change of
+            basis ('maintain'; corresponds to queryexpansion with partial membership), or kept as-is
+            (False;  corresponds to query expansion).
 
         See Also
         --------
@@ -941,7 +950,14 @@ def __init__(self, corpus, similarity_matrix, num_best=None, chunksize=256, norm
         self.corpus = list(corpus)
         self.num_best = num_best
         self.chunksize = chunksize
-        self.normalized = normalized
+        if normalized is not None:
+            warnings.warn(
+                'Parameter normalized will be removed in 5.0.0, use normalize_queries and normalize_documents instead',
+                category=DeprecationWarning,
+            )
+            self.normalized = normalized
+        else:
+            self.normalized = (normalize_queries, normalize_documents)
 
         # Normalization of features is undesirable, since soft cosine similarity requires special
         # normalization using the similarity matrix. Therefore, we would just be normalizing twice,
@@ -1102,6 +1118,50 @@ def __str__(self):
 class SparseMatrixSimilarity(interfaces.SimilarityABC):
     """Compute cosine similarity against a corpus of documents by storing the index matrix in memory.
 
+    Examples
+    --------
+    Here is how you would index and query a corpus of documents in the bag-of-words format using the
+    cosine similarity:
+
+    .. sourcecode:: pycon
+
+        >>> from gensim.corpora import Dictionary
+        >>> from gensim.similarities import SparseMatrixSimilarity
+        >>> from gensim.test.utils import common_texts as corpus
+        >>>
+        >>> dictionary = Dictionary(corpus)  # fit dictionary
+        >>> bow_corpus = [dictionary.doc2bow(line) for line in corpus]  # convert corpus to BoW format
+        >>> index = SparseMatrixSimilarity(bm25_corpus, num_docs=len(corpus), num_terms=len(dictionary))
+        >>>
+        >>> query = 'graph trees computer'.split()  # make a query
+        >>> bow_query = dictionary.doc2bow(query)
+        >>> similarities = index[bow_query]  # calculate similarity of query to each doc from bow_corpus
+
+    Here is how you would index and query a corpus of documents using the Okapi BM25 scoring
+    function:
+
+    .. sourcecode:: pycon
+
+        >>> from gensim.corpora import Dictionary
+        >>> from gensim.models import TfidfModel, OkapiBM25Model
+        >>> from gensim.similarities import SparseMatrixSimilarity
+        >>> from gensim.test.utils import common_texts as corpus
+        >>>
+        >>> dictionary = Dictionary(corpus)  # fit dictionary
+        >>> query_model = TfidfModel(dictionary=dictionary, smartirs='bnn')  # enforce binary weights
+        >>> document_model = OkapiBM25Model(dictionary=dictionary)  # fit bm25 model
+        >>>
+        >>> bow_corpus = [dictionary.doc2bow(line) for line in corpus]  # convert corpus to BoW format
+        >>> bm25_corpus = document_model[bow_corpus]
+        >>> index = SparseMatrixSimilarity(bm25_corpus, num_docs=len(corpus), num_terms=len(dictionary),
+        ...                                normalize_queries=False, normalize_documents=False)
+        >>>
+        >>>
+        >>> query = 'graph trees computer'.split()  # make a query
+        >>> bow_query = dictionary.doc2bow(query)
+        >>> bm25_query = query_model[bow_query]
+        >>> similarities = index[bm25_query]  # calculate similarity of query to each doc from bow_corpus
+
     Notes
     -----
     Use this if your input corpus contains sparse vectors (such as TF-IDF documents) and fits into RAM.
@@ -1122,7 +1182,8 @@ class SparseMatrixSimilarity(interfaces.SimilarityABC):
 
     """
     def __init__(self, corpus, num_features=None, num_terms=None, num_docs=None, num_nnz=None,
-                 num_best=None, chunksize=500, dtype=numpy.float32, maintain_sparsity=False):
+                 num_best=None, chunksize=500, dtype=numpy.float32, maintain_sparsity=False,
+                 normalize_queries=True, normalize_documents=True):
         """
 
         Parameters
@@ -1146,10 +1207,15 @@ def __init__(self, corpus, num_features=None, num_terms=None, num_docs=None, num
             Data type of the internal matrix.
         maintain_sparsity : bool, optional
             Return sparse arrays from :meth:`~gensim.similarities.docsim.SparseMatrixSimilarity.get_similarities`?
-
+        normalize_queries : bool, optional
+            If queries are in bag-of-words (int, float) format, as opposed to a sparse or dense
+            2D arrays, they will be L2-normalized. Default is True.
+        normalize_documents : bool, optional
+            If `corpus` is in bag-of-words (int, float) format, as opposed to a sparse or dense
+            2D arrays, it will be L2-normalized. Default is True.
         """
         self.num_best = num_best
-        self.normalize = True
+        self.normalize = normalize_queries
         self.chunksize = chunksize
         self.maintain_sparsity = maintain_sparsity
 
@@ -1173,7 +1239,7 @@ def __init__(self, corpus, num_features=None, num_terms=None, num_docs=None, num
                 raise ValueError("refusing to guess the number of sparse features: specify num_features explicitly")
             corpus = (matutils.scipy2sparse(v) if scipy.sparse.issparse(v) else
                       (matutils.full2sparse(v) if isinstance(v, numpy.ndarray) else
-                       matutils.unitvec(v)) for v in corpus)
+                       matutils.unitvec(v) if normalize_documents else v) for v in corpus)
             self.index = matutils.corpus2csc(
                 corpus, num_terms=num_terms, num_docs=num_docs, num_nnz=num_nnz,
                 dtype=dtype, printprogress=10000,
diff --git a/gensim/test/test_bm25model.py b/gensim/test/test_bm25model.py
new file mode 100644
index 0000000000..4cb9ca49ee
--- /dev/null
+++ b/gensim/test/test_bm25model.py
@@ -0,0 +1,264 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+
+from collections import defaultdict
+import math
+import unittest
+
+from gensim.models.bm25model import BM25ABC
+from gensim.models import OkapiBM25Model, LuceneBM25Model, AtireBM25Model
+
+from gensim.corpora import Dictionary
+
+
+class BM25Stub(BM25ABC):
+    def __init__(self, *args, **kwargs):
+        super().__init__(*args, **kwargs)
+
+    def precompute_idfs(self, dfs, num_docs):
+        return dict()
+
+    def get_term_weights(self, num_tokens, term_frequencies, idfs):
+        return term_frequencies
+
+
+class BM25ABCTest(unittest.TestCase):
+    def setUp(self):
+        self.documents = [['cat', 'dog', 'mouse'], ['cat', 'lion'], ['cat', 'lion']]
+        self.dictionary = Dictionary(self.documents)
+
+        self.expected_avgdl = sum(map(len, self.documents)) / len(self.documents)
+
+    def test_avgdl_from_corpus(self):
+        corpus = list(map(self.dictionary.doc2bow, self.documents))
+        model = BM25Stub(corpus=corpus)
+        actual_avgdl = model.avgdl
+        self.assertAlmostEqual(self.expected_avgdl, actual_avgdl)
+
+    def test_avgdl_from_dictionary(self):
+        model = BM25Stub(dictionary=self.dictionary)
+        actual_avgdl = model.avgdl
+        self.assertAlmostEqual(self.expected_avgdl, actual_avgdl)
+
+
+class OkapiBM25ModelTest(unittest.TestCase):
+    def setUp(self):
+        self.documents = [['cat', 'dog', 'mouse'], ['cat', 'lion'], ['cat', 'lion']]
+        self.dictionary = Dictionary(self.documents)
+        self.k1, self.b, self.epsilon = 1.5, 0.75, 0.25
+
+        def get_idf(word):
+            frequency = sum(map(lambda document: word in document, self.documents))
+            return math.log((len(self.documents) - frequency + 0.5) / (frequency + 0.5))
+
+        dog_idf = get_idf('dog')
+        cat_idf = get_idf('cat')
+        mouse_idf = get_idf('mouse')
+        lion_idf = get_idf('lion')
+
+        average_idf = (dog_idf + cat_idf + mouse_idf + lion_idf) / len(self.dictionary)
+        eps = self.epsilon * average_idf
+
+        self.expected_dog_idf = dog_idf if dog_idf > 0 else eps
+        self.expected_cat_idf = cat_idf if cat_idf > 0 else eps
+        self.expected_mouse_idf = mouse_idf if mouse_idf > 0 else eps
+        self.expected_lion_idf = lion_idf if lion_idf > 0 else eps
+
+    def test_idfs_from_corpus(self):
+        corpus = list(map(self.dictionary.doc2bow, self.documents))
+        model = OkapiBM25Model(corpus=corpus, k1=self.k1, b=self.b, epsilon=self.epsilon)
+
+        actual_dog_idf = model.idfs[self.dictionary.token2id['dog']]
+        actual_cat_idf = model.idfs[self.dictionary.token2id['cat']]
+        actual_mouse_idf = model.idfs[self.dictionary.token2id['mouse']]
+        actual_lion_idf = model.idfs[self.dictionary.token2id['lion']]
+
+        self.assertAlmostEqual(self.expected_dog_idf, actual_dog_idf)
+        self.assertAlmostEqual(self.expected_cat_idf, actual_cat_idf)
+        self.assertAlmostEqual(self.expected_mouse_idf, actual_mouse_idf)
+        self.assertAlmostEqual(self.expected_lion_idf, actual_lion_idf)
+
+    def test_idfs_from_dictionary(self):
+        model = OkapiBM25Model(dictionary=self.dictionary, k1=self.k1, b=self.b, epsilon=self.epsilon)
+
+        actual_dog_idf = model.idfs[self.dictionary.token2id['dog']]
+        actual_cat_idf = model.idfs[self.dictionary.token2id['cat']]
+        actual_mouse_idf = model.idfs[self.dictionary.token2id['mouse']]
+        actual_lion_idf = model.idfs[self.dictionary.token2id['lion']]
+
+        self.assertAlmostEqual(self.expected_dog_idf, actual_dog_idf)
+        self.assertAlmostEqual(self.expected_cat_idf, actual_cat_idf)
+        self.assertAlmostEqual(self.expected_mouse_idf, actual_mouse_idf)
+        self.assertAlmostEqual(self.expected_lion_idf, actual_lion_idf)
+
+    def test_score(self):
+        model = OkapiBM25Model(dictionary=self.dictionary, k1=self.k1, b=self.b, epsilon=self.epsilon)
+
+        first_document = self.documents[0]
+        first_bow = self.dictionary.doc2bow(first_document)
+        weights = defaultdict(lambda: 0.0)
+        weights.update(model[first_bow])
+
+        actual_dog_weight = weights[self.dictionary.token2id['dog']]
+        actual_cat_weight = weights[self.dictionary.token2id['cat']]
+        actual_mouse_weight = weights[self.dictionary.token2id['mouse']]
+        actual_lion_weight = weights[self.dictionary.token2id['lion']]
+
+        def get_expected_weight(word):
+            idf = model.idfs[self.dictionary.token2id[word]]
+            numerator = self.k1 + 1
+            denominator = 1 + self.k1 * (1 - self.b + self.b * len(first_document) / model.avgdl)
+            return idf * numerator / denominator
+
+        expected_dog_weight = get_expected_weight('dog') if 'dog' in first_document else 0.0
+        expected_cat_weight = get_expected_weight('cat') if 'cat' in first_document else 0.0
+        expected_mouse_weight = get_expected_weight('mouse') if 'mouse' in first_document else 0.0
+        expected_lion_weight = get_expected_weight('lion') if 'lion' in first_document else 0.0
+
+        self.assertAlmostEqual(expected_dog_weight, actual_dog_weight)
+        self.assertAlmostEqual(expected_cat_weight, actual_cat_weight)
+        self.assertAlmostEqual(expected_mouse_weight, actual_mouse_weight)
+        self.assertAlmostEqual(expected_lion_weight, actual_lion_weight)
+
+
+class LuceneBM25ModelTest(unittest.TestCase):
+    def setUp(self):
+        self.documents = [['cat', 'dog', 'mouse'], ['cat', 'lion'], ['cat', 'lion']]
+        self.dictionary = Dictionary(self.documents)
+        self.k1, self.b = 1.5, 0.75
+
+        def get_idf(word):
+            frequency = sum(map(lambda document: word in document, self.documents))
+            return math.log(1.0 + (len(self.documents) - frequency + 0.5) / (frequency + 0.5))
+
+        self.expected_dog_idf = get_idf('dog')
+        self.expected_cat_idf = get_idf('cat')
+        self.expected_mouse_idf = get_idf('mouse')
+        self.expected_lion_idf = get_idf('lion')
+
+    def test_idfs_from_corpus(self):
+        corpus = list(map(self.dictionary.doc2bow, self.documents))
+        model = LuceneBM25Model(corpus=corpus, k1=self.k1, b=self.b)
+
+        actual_dog_idf = model.idfs[self.dictionary.token2id['dog']]
+        actual_cat_idf = model.idfs[self.dictionary.token2id['cat']]
+        actual_mouse_idf = model.idfs[self.dictionary.token2id['mouse']]
+        actual_lion_idf = model.idfs[self.dictionary.token2id['lion']]
+
+        self.assertAlmostEqual(self.expected_dog_idf, actual_dog_idf)
+        self.assertAlmostEqual(self.expected_cat_idf, actual_cat_idf)
+        self.assertAlmostEqual(self.expected_mouse_idf, actual_mouse_idf)
+        self.assertAlmostEqual(self.expected_lion_idf, actual_lion_idf)
+
+    def test_idfs_from_dictionary(self):
+        model = LuceneBM25Model(dictionary=self.dictionary, k1=self.k1, b=self.b)
+
+        actual_dog_idf = model.idfs[self.dictionary.token2id['dog']]
+        actual_cat_idf = model.idfs[self.dictionary.token2id['cat']]
+        actual_mouse_idf = model.idfs[self.dictionary.token2id['mouse']]
+        actual_lion_idf = model.idfs[self.dictionary.token2id['lion']]
+
+        self.assertAlmostEqual(self.expected_dog_idf, actual_dog_idf)
+        self.assertAlmostEqual(self.expected_cat_idf, actual_cat_idf)
+        self.assertAlmostEqual(self.expected_mouse_idf, actual_mouse_idf)
+        self.assertAlmostEqual(self.expected_lion_idf, actual_lion_idf)
+
+    def test_score(self):
+        model = LuceneBM25Model(dictionary=self.dictionary, k1=self.k1, b=self.b)
+
+        first_document = self.documents[0]
+        first_bow = self.dictionary.doc2bow(first_document)
+        weights = defaultdict(lambda: 0.0)
+        weights.update(model[first_bow])
+
+        actual_dog_weight = weights[self.dictionary.token2id['dog']]
+        actual_cat_weight = weights[self.dictionary.token2id['cat']]
+        actual_mouse_weight = weights[self.dictionary.token2id['mouse']]
+        actual_lion_weight = weights[self.dictionary.token2id['lion']]
+
+        def get_expected_weight(word):
+            idf = model.idfs[self.dictionary.token2id[word]]
+            denominator = 1 + self.k1 * (1 - self.b + self.b * len(first_document) / model.avgdl)
+            return idf / denominator
+
+        expected_dog_weight = get_expected_weight('dog') if 'dog' in first_document else 0.0
+        expected_cat_weight = get_expected_weight('cat') if 'cat' in first_document else 0.0
+        expected_mouse_weight = get_expected_weight('mouse') if 'mouse' in first_document else 0.0
+        expected_lion_weight = get_expected_weight('lion') if 'lion' in first_document else 0.0
+
+        self.assertAlmostEqual(expected_dog_weight, actual_dog_weight)
+        self.assertAlmostEqual(expected_cat_weight, actual_cat_weight)
+        self.assertAlmostEqual(expected_mouse_weight, actual_mouse_weight)
+        self.assertAlmostEqual(expected_lion_weight, actual_lion_weight)
+
+
+class AtireBM25ModelTest(unittest.TestCase):
+    def setUp(self):
+        self.documents = [['cat', 'dog', 'mouse'], ['cat', 'lion'], ['cat', 'lion']]
+        self.dictionary = Dictionary(self.documents)
+        self.k1, self.b, self.epsilon = 1.5, 0.75, 0.25
+
+        def get_idf(word):
+            frequency = sum(map(lambda document: word in document, self.documents))
+            return math.log(len(self.documents) / frequency)
+
+        self.expected_dog_idf = get_idf('dog')
+        self.expected_cat_idf = get_idf('cat')
+        self.expected_mouse_idf = get_idf('mouse')
+        self.expected_lion_idf = get_idf('lion')
+
+    def test_idfs_from_corpus(self):
+        corpus = list(map(self.dictionary.doc2bow, self.documents))
+        model = AtireBM25Model(corpus=corpus, k1=self.k1, b=self.b)
+
+        actual_dog_idf = model.idfs[self.dictionary.token2id['dog']]
+        actual_cat_idf = model.idfs[self.dictionary.token2id['cat']]
+        actual_mouse_idf = model.idfs[self.dictionary.token2id['mouse']]
+        actual_lion_idf = model.idfs[self.dictionary.token2id['lion']]
+
+        self.assertAlmostEqual(self.expected_dog_idf, actual_dog_idf)
+        self.assertAlmostEqual(self.expected_cat_idf, actual_cat_idf)
+        self.assertAlmostEqual(self.expected_mouse_idf, actual_mouse_idf)
+        self.assertAlmostEqual(self.expected_lion_idf, actual_lion_idf)
+
+    def test_idfs_from_dictionary(self):
+        model = AtireBM25Model(dictionary=self.dictionary, k1=self.k1, b=self.b)
+
+        actual_dog_idf = model.idfs[self.dictionary.token2id['dog']]
+        actual_cat_idf = model.idfs[self.dictionary.token2id['cat']]
+        actual_mouse_idf = model.idfs[self.dictionary.token2id['mouse']]
+        actual_lion_idf = model.idfs[self.dictionary.token2id['lion']]
+
+        self.assertAlmostEqual(self.expected_dog_idf, actual_dog_idf)
+        self.assertAlmostEqual(self.expected_cat_idf, actual_cat_idf)
+        self.assertAlmostEqual(self.expected_mouse_idf, actual_mouse_idf)
+        self.assertAlmostEqual(self.expected_lion_idf, actual_lion_idf)
+
+    def test_score(self):
+        model = AtireBM25Model(dictionary=self.dictionary, k1=self.k1, b=self.b)
+
+        first_document = self.documents[0]
+        first_bow = self.dictionary.doc2bow(first_document)
+        weights = defaultdict(lambda: 0.0)
+        weights.update(model[first_bow])
+
+        actual_dog_weight = weights[self.dictionary.token2id['dog']]
+        actual_cat_weight = weights[self.dictionary.token2id['cat']]
+        actual_mouse_weight = weights[self.dictionary.token2id['mouse']]
+        actual_lion_weight = weights[self.dictionary.token2id['lion']]
+
+        def get_expected_weight(word):
+            idf = model.idfs[self.dictionary.token2id[word]]
+            numerator = self.k1 + 1
+            denominator = 1 + self.k1 * (1 - self.b + self.b * len(first_document) / model.avgdl)
+            return idf * numerator / denominator
+
+        expected_dog_weight = get_expected_weight('dog') if 'dog' in first_document else 0.0
+        expected_cat_weight = get_expected_weight('cat') if 'cat' in first_document else 0.0
+        expected_mouse_weight = get_expected_weight('mouse') if 'mouse' in first_document else 0.0
+        expected_lion_weight = get_expected_weight('lion') if 'lion' in first_document else 0.0
+
+        self.assertAlmostEqual(expected_dog_weight, actual_dog_weight)
+        self.assertAlmostEqual(expected_cat_weight, actual_cat_weight)
+        self.assertAlmostEqual(expected_mouse_weight, actual_mouse_weight)
+        self.assertAlmostEqual(expected_lion_weight, actual_lion_weight)

From a435f24fe25e17f473e71af3468660512c2606cb Mon Sep 17 00:00:00 2001
From: Tobi <proxima@sezanzeb.de>
Date: Sun, 2 Oct 2022 17:05:30 +0200
Subject: [PATCH 15/34] Giving missing credit to Alex in docs (#3393)

---
 gensim/models/ensemblelda.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/gensim/models/ensemblelda.py b/gensim/models/ensemblelda.py
index 39d7e06620..16b5c1c1bc 100644
--- a/gensim/models/ensemblelda.py
+++ b/gensim/models/ensemblelda.py
@@ -91,7 +91,7 @@
 Citation
 --------
 BRIGL, Tobias, 2019, Extracting Reliable Topics using Ensemble Latent Dirichlet Allocation [Bachelor Thesis].
-Technische Hochschule Ingolstadt. Munich: Data Reply GmbH. Available from:
+Technische Hochschule Ingolstadt. Munich: Data Reply GmbH. Supervised by Alex Loosley. Available from:
 https://www.sezanzeb.de/machine_learning/ensemble_LDA/
 
 """

From fdf40eb309f5b188b8ef173cff80c7727bfa36ff Mon Sep 17 00:00:00 2001
From: TLouf <31036680+TLouf@users.noreply.github.com>
Date: Thu, 3 Nov 2022 14:44:56 +0100
Subject: [PATCH 16/34] PERF: pyemd to POT for EMD computation in `wmdistance`
 (#3327)

* PERF: switch from pyemd to POT for EMD computation

* Adapt citations

* Adapt dependency

* Adapt tests

* Update cache for gallery

Co-authored-by: TLouf <loufthomas@gmail.com>
---
 .travis.yml                                   |   2 +-
 docs/notebooks/WMD_tutorial.ipynb             |   5 +-
 docs/notebooks/soft_cosine_tutorial.ipynb     |  46 +-
 docs/src/auto_examples/core/index.rst         |  98 ++++
 docs/src/auto_examples/howtos/index.rst       |  97 ++++
 docs/src/auto_examples/index.rst              |  24 +-
 docs/src/auto_examples/other/index.rst        |  49 ++
 .../images/sphx_glr_run_fasttext_001.png      | Bin 8103 -> 19508 bytes
 .../tutorials/images/sphx_glr_run_wmd_001.png | Bin 31931 -> 31931 bytes
 .../thumb/sphx_glr_run_fasttext_thumb.png     | Bin 12051 -> 13093 bytes
 .../images/thumb/sphx_glr_run_wmd_thumb.png   | Bin 17172 -> 17211 bytes
 docs/src/auto_examples/tutorials/index.rst    | 169 +++++++
 .../tutorials/run_fasttext.ipynb              |  24 +-
 .../auto_examples/tutorials/run_fasttext.py   |   2 +-
 .../tutorials/run_fasttext.py.md5             |   2 +-
 .../auto_examples/tutorials/run_fasttext.rst  | 421 +++++++++++-------
 .../tutorials/run_fasttext_codeobj.pickle     | Bin 0 -> 9038 bytes
 .../src/auto_examples/tutorials/run_wmd.ipynb |  10 +-
 docs/src/auto_examples/tutorials/run_wmd.py   |   9 +-
 .../auto_examples/tutorials/run_wmd.py.md5    |   2 +-
 docs/src/auto_examples/tutorials/run_wmd.rst  | 132 +++---
 .../tutorials/run_wmd_codeobj.pickle          | Bin 0 -> 2602 bytes
 .../tutorials/sg_execution_times.rst          |  36 +-
 docs/src/gallery/tutorials/run_fasttext.py    |   2 +-
 docs/src/gallery/tutorials/run_wmd.py         |   9 +-
 gensim/models/keyedvectors.py                 |  19 +-
 gensim/similarities/docsim.py                 |   6 +-
 gensim/test/test_fasttext.py                  |   8 +-
 gensim/test/test_similarities.py              |  48 +-
 gensim/test/test_word2vec.py                  |  12 +-
 requirements_docs.txt                         |   2 +-
 setup.py                                      |   2 +-
 32 files changed, 866 insertions(+), 370 deletions(-)
 create mode 100644 docs/src/auto_examples/core/index.rst
 create mode 100644 docs/src/auto_examples/howtos/index.rst
 create mode 100644 docs/src/auto_examples/other/index.rst
 create mode 100644 docs/src/auto_examples/tutorials/index.rst
 create mode 100644 docs/src/auto_examples/tutorials/run_fasttext_codeobj.pickle
 create mode 100644 docs/src/auto_examples/tutorials/run_wmd_codeobj.pickle

diff --git a/.travis.yml b/.travis.yml
index b0b952766d..d27d176f58 100644
--- a/.travis.yml
+++ b/.travis.yml
@@ -26,7 +26,7 @@ env:
         # them here for now.  They'll get picked up by the multibuild stuff
         # running in multibuild/common_utils.sh.
         #
-      - TEST_DEPENDS="pytest mock cython nmslib pyemd testfixtures python-levenshtein==0.12.0 visdom==0.1.8.9 scikit-learn"
+      - TEST_DEPENDS="pytest mock cython nmslib POT testfixtures python-levenshtein==0.12.0 visdom==0.1.8.9 scikit-learn"
 
 matrix:
       #
diff --git a/docs/notebooks/WMD_tutorial.ipynb b/docs/notebooks/WMD_tutorial.ipynb
index ff1f608dc5..9b051104d5 100644
--- a/docs/notebooks/WMD_tutorial.ipynb
+++ b/docs/notebooks/WMD_tutorial.ipynb
@@ -30,7 +30,7 @@
     "\n",
     "## Running this notebook\n",
     "\n",
-    "You can download this [iPython Notebook](http://ipython.org/notebook.html), and run it on your own computer, provided you have installed Gensim, PyEMD, NLTK, and downloaded the necessary data.\n",
+    "You can download this [iPython Notebook](http://ipython.org/notebook.html), and run it on your own computer, provided you have installed Gensim, POT, NLTK, and downloaded the necessary data.\n",
     "\n",
     "The notebook was run on an Ubuntu machine with an Intel core i7-4770 CPU 3.40GHz (8 cores) and 32 GB memory. Running the entire notebook on this machine takes about 3 minutes.\n",
     "\n",
@@ -524,8 +524,7 @@
    "source": [
     "## References\n",
     "\n",
-    "1. Ofir Pele and Michael Werman, *A linear time histogram metric for improved SIFT matching*, 2008.\n",
-    "* Ofir Pele and Michael Werman, *Fast and robust earth mover's distances*, 2009.\n",
+    "1. * Rémi Flamary et al. *POT: Python Optimal Transport*, 2021.\n",
     "* Matt Kusner et al. *From Embeddings To Document Distances*, 2015.\n",
     "* Thomas Mikolov et al. *Efficient Estimation of Word Representations in Vector Space*, 2013."
    ]
diff --git a/docs/notebooks/soft_cosine_tutorial.ipynb b/docs/notebooks/soft_cosine_tutorial.ipynb
index 4c7fceb1df..a8d1c41555 100644
--- a/docs/notebooks/soft_cosine_tutorial.ipynb
+++ b/docs/notebooks/soft_cosine_tutorial.ipynb
@@ -30,7 +30,7 @@
     ">\n",
     "\n",
     "## Running this notebook\n",
-    "You can download this [Jupyter notebook](http://jupyter.org/), and run it on your own computer, provided you have installed the `gensim`, `jupyter`, `sklearn`, `pyemd`, and `wmd` Python packages.\n",
+    "You can download this [Jupyter notebook](http://jupyter.org/), and run it on your own computer, provided you have installed the `gensim`, `jupyter`, `sklearn`, `POT`, and `wmd` Python packages.\n",
     "\n",
     "The notebook was run on an Ubuntu machine with an Intel core i7-6700HQ CPU 3.10GHz (4 cores) and 16 GB memory. Assuming all resources required by the notebook have already been downloaded, running the entire notebook on this machine takes about 30 minutes."
    ]
@@ -357,7 +357,7 @@
    "metadata": {},
    "outputs": [],
    "source": [
-    "!pip install pyemd"
+    "!pip install POT"
    ]
   },
   {
@@ -404,7 +404,7 @@
     "    return similarities\n",
     "\n",
     "def wmd_gensim(query, documents):\n",
-    "    # Compute Word Mover's Distance as implemented in PyEMD by William Mayner\n",
+    "    # Compute Word Mover's Distance as implemented in POT\n",
     "    # between the query and the documents.\n",
     "    index = WmdSimilarity(documents, w2v_model)\n",
     "    similarities = index[query]\n",
@@ -532,26 +532,26 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-     "Dataset | Strategy | MAP score | Elapsed time (sec)\n",
-     ":---|:---|:---|---:\n",
-     "2016-test|softcossim|78.52 ±11.18|6.00 ±0.79\n",
-     "2016-test|**Winner (UH-PRHLT-primary)**|76.70 ±0.00|\n",
-     "2016-test|cossim|76.45 ±10.40|0.64 ±0.08\n",
-     "2016-test|wmd-gensim|76.23 ±11.42|5.37 ±0.64\n",
-     "2016-test|**Baseline 1 (IR)**|74.75 ±0.00|\n",
-     "2016-test|wmd-relax|71.05 ±11.06|1.11 ±0.09\n",
-     "2016-test|**Baseline 2 (random)**|46.98 ±0.00|\n",
-     "\n",
-     "\n",
-     "Dataset | Strategy | MAP score | Elapsed time (sec)\n",
-     ":---|:---|:---|---:\n",
-     "2017-test|**Winner (SimBow-primary)**|47.22 ±0.00|\n",
-     "2017-test|softcossim|45.88 ±16.22|7.08 ±1.49\n",
-     "2017-test|cossim|44.38 ±14.71|0.74 ±0.10\n",
-     "2017-test|wmd-gensim|44.06 ±15.92|6.20 ±0.87\n",
-     "2017-test|wmd-relax|43.52 ±16.30|1.30 ±0.18\n",
-     "2017-test|**Baseline 1 (IR)**|41.85 ±0.00|\n",
-     "2017-test|**Baseline 2 (random)**|29.81 ±0.00|"
+    "Dataset | Strategy | MAP score | Elapsed time (sec)\n",
+    ":---|:---|:---|---:\n",
+    "2016-test|softcossim|78.52 ±11.18|6.00 ±0.79\n",
+    "2016-test|**Winner (UH-PRHLT-primary)**|76.70 ±0.00|\n",
+    "2016-test|cossim|76.45 ±10.40|0.64 ±0.08\n",
+    "2016-test|wmd-gensim|76.23 ±11.42|5.37 ±0.64\n",
+    "2016-test|**Baseline 1 (IR)**|74.75 ±0.00|\n",
+    "2016-test|wmd-relax|71.05 ±11.06|1.11 ±0.09\n",
+    "2016-test|**Baseline 2 (random)**|46.98 ±0.00|\n",
+    "\n",
+    "\n",
+    "Dataset | Strategy | MAP score | Elapsed time (sec)\n",
+    ":---|:---|:---|---:\n",
+    "2017-test|**Winner (SimBow-primary)**|47.22 ±0.00|\n",
+    "2017-test|softcossim|45.88 ±16.22|7.08 ±1.49\n",
+    "2017-test|cossim|44.38 ±14.71|0.74 ±0.10\n",
+    "2017-test|wmd-gensim|44.06 ±15.92|6.20 ±0.87\n",
+    "2017-test|wmd-relax|43.52 ±16.30|1.30 ±0.18\n",
+    "2017-test|**Baseline 1 (IR)**|41.85 ±0.00|\n",
+    "2017-test|**Baseline 2 (random)**|29.81 ±0.00|"
    ]
   },
   {
diff --git a/docs/src/auto_examples/core/index.rst b/docs/src/auto_examples/core/index.rst
new file mode 100644
index 0000000000..03716729a9
--- /dev/null
+++ b/docs/src/auto_examples/core/index.rst
@@ -0,0 +1,98 @@
+
+
+.. _sphx_glr_auto_examples_core:
+
+Core Tutorials: New Users Start Here!
+-------------------------------------
+
+If you're new to gensim, we recommend going through all core tutorials in order.
+Understanding this functionality is vital for using gensim effectively.
+
+
+
+.. raw:: html
+
+    <div class="sphx-glr-thumbnails">
+
+
+.. raw:: html
+
+    <div class="sphx-glr-thumbcontainer" tooltip="This tutorial introduces Documents, Corpora, Vectors and Models: the basic concepts and terms n...">
+
+.. only:: html
+
+  .. image:: /auto_examples/core/images/thumb/sphx_glr_run_core_concepts_thumb.png
+    :alt: Core Concepts
+
+  :ref:`sphx_glr_auto_examples_core_run_core_concepts.py`
+
+.. raw:: html
+
+      <div class="sphx-glr-thumbnail-title">Core Concepts</div>
+    </div>
+
+
+.. raw:: html
+
+    <div class="sphx-glr-thumbcontainer" tooltip="Demonstrates transforming text into a vector space representation.">
+
+.. only:: html
+
+  .. image:: /auto_examples/core/images/thumb/sphx_glr_run_corpora_and_vector_spaces_thumb.png
+    :alt: Corpora and Vector Spaces
+
+  :ref:`sphx_glr_auto_examples_core_run_corpora_and_vector_spaces.py`
+
+.. raw:: html
+
+      <div class="sphx-glr-thumbnail-title">Corpora and Vector Spaces</div>
+    </div>
+
+
+.. raw:: html
+
+    <div class="sphx-glr-thumbcontainer" tooltip="Introduces transformations and demonstrates their use on a toy corpus.">
+
+.. only:: html
+
+  .. image:: /auto_examples/core/images/thumb/sphx_glr_run_topics_and_transformations_thumb.png
+    :alt: Topics and Transformations
+
+  :ref:`sphx_glr_auto_examples_core_run_topics_and_transformations.py`
+
+.. raw:: html
+
+      <div class="sphx-glr-thumbnail-title">Topics and Transformations</div>
+    </div>
+
+
+.. raw:: html
+
+    <div class="sphx-glr-thumbcontainer" tooltip="Demonstrates querying a corpus for similar documents.">
+
+.. only:: html
+
+  .. image:: /auto_examples/core/images/thumb/sphx_glr_run_similarity_queries_thumb.png
+    :alt: Similarity Queries
+
+  :ref:`sphx_glr_auto_examples_core_run_similarity_queries.py`
+
+.. raw:: html
+
+      <div class="sphx-glr-thumbnail-title">Similarity Queries</div>
+    </div>
+
+
+.. raw:: html
+
+    </div>
+
+
+.. toctree::
+   :hidden:
+
+   /auto_examples/core/run_core_concepts
+   /auto_examples/core/run_corpora_and_vector_spaces
+   /auto_examples/core/run_topics_and_transformations
+   /auto_examples/core/run_similarity_queries
+
diff --git a/docs/src/auto_examples/howtos/index.rst b/docs/src/auto_examples/howtos/index.rst
new file mode 100644
index 0000000000..a43341d306
--- /dev/null
+++ b/docs/src/auto_examples/howtos/index.rst
@@ -0,0 +1,97 @@
+
+
+.. _sphx_glr_auto_examples_howtos:
+
+How-to Guides: Solve a Problem
+------------------------------
+
+These **goal-oriented guides** demonstrate how to **solve a specific problem** using gensim.
+
+
+
+.. raw:: html
+
+    <div class="sphx-glr-thumbnails">
+
+
+.. raw:: html
+
+    <div class="sphx-glr-thumbcontainer" tooltip="Demonstrates simple and quick access to common corpora and pretrained models.">
+
+.. only:: html
+
+  .. image:: /auto_examples/howtos/images/thumb/sphx_glr_run_downloader_api_thumb.png
+    :alt: How to download pre-trained models and corpora
+
+  :ref:`sphx_glr_auto_examples_howtos_run_downloader_api.py`
+
+.. raw:: html
+
+      <div class="sphx-glr-thumbnail-title">How to download pre-trained models and corpora</div>
+    </div>
+
+
+.. raw:: html
+
+    <div class="sphx-glr-thumbcontainer" tooltip="How to author documentation for Gensim.">
+
+.. only:: html
+
+  .. image:: /auto_examples/howtos/images/thumb/sphx_glr_run_doc_thumb.png
+    :alt: How to Author Gensim Documentation
+
+  :ref:`sphx_glr_auto_examples_howtos_run_doc.py`
+
+.. raw:: html
+
+      <div class="sphx-glr-thumbnail-title">How to Author Gensim Documentation</div>
+    </div>
+
+
+.. raw:: html
+
+    <div class="sphx-glr-thumbcontainer" tooltip="Shows how to reproduce results of the &quot;Distributed Representation of Sentences and Documents&quot; p...">
+
+.. only:: html
+
+  .. image:: /auto_examples/howtos/images/thumb/sphx_glr_run_doc2vec_imdb_thumb.png
+    :alt: How to reproduce the doc2vec 'Paragraph Vector' paper
+
+  :ref:`sphx_glr_auto_examples_howtos_run_doc2vec_imdb.py`
+
+.. raw:: html
+
+      <div class="sphx-glr-thumbnail-title">How to reproduce the doc2vec 'Paragraph Vector' paper</div>
+    </div>
+
+
+.. raw:: html
+
+    <div class="sphx-glr-thumbcontainer" tooltip="Demonstrates how you can visualize and compare trained topic models.">
+
+.. only:: html
+
+  .. image:: /auto_examples/howtos/images/thumb/sphx_glr_run_compare_lda_thumb.png
+    :alt: How to Compare LDA Models
+
+  :ref:`sphx_glr_auto_examples_howtos_run_compare_lda.py`
+
+.. raw:: html
+
+      <div class="sphx-glr-thumbnail-title">How to Compare LDA Models</div>
+    </div>
+
+
+.. raw:: html
+
+    </div>
+
+
+.. toctree::
+   :hidden:
+
+   /auto_examples/howtos/run_downloader_api
+   /auto_examples/howtos/run_doc
+   /auto_examples/howtos/run_doc2vec_imdb
+   /auto_examples/howtos/run_compare_lda
+
diff --git a/docs/src/auto_examples/index.rst b/docs/src/auto_examples/index.rst
index a1f42f795e..2d2f133d0c 100644
--- a/docs/src/auto_examples/index.rst
+++ b/docs/src/auto_examples/index.rst
@@ -152,35 +152,35 @@ Learning-oriented lessons that introduce a particular gensim feature, e.g. a mod
 
 .. raw:: html
 
-    <div class="sphx-glr-thumbcontainer" tooltip="Introduces Gensim&#x27;s EnsembleLda model">
+    <div class="sphx-glr-thumbcontainer" tooltip="Introduces Gensim&#x27;s fastText model and demonstrates its use on the Lee Corpus.">
 
 .. only:: html
 
-  .. image:: /auto_examples/tutorials/images/thumb/sphx_glr_run_ensemblelda_thumb.png
-    :alt: Ensemble LDA
+  .. image:: /auto_examples/tutorials/images/thumb/sphx_glr_run_fasttext_thumb.png
+    :alt: FastText Model
 
-  :ref:`sphx_glr_auto_examples_tutorials_run_ensemblelda.py`
+  :ref:`sphx_glr_auto_examples_tutorials_run_fasttext.py`
 
 .. raw:: html
 
-      <div class="sphx-glr-thumbnail-title">Ensemble LDA</div>
+      <div class="sphx-glr-thumbnail-title">FastText Model</div>
     </div>
 
 
 .. raw:: html
 
-    <div class="sphx-glr-thumbcontainer" tooltip="Introduces Gensim&#x27;s fastText model and demonstrates its use on the Lee Corpus.">
+    <div class="sphx-glr-thumbcontainer" tooltip="Introduces Gensim&#x27;s EnsembleLda model">
 
 .. only:: html
 
-  .. image:: /auto_examples/tutorials/images/thumb/sphx_glr_run_fasttext_thumb.png
-    :alt: FastText Model
+  .. image:: /auto_examples/tutorials/images/thumb/sphx_glr_run_ensemblelda_thumb.png
+    :alt: Ensemble LDA
 
-  :ref:`sphx_glr_auto_examples_tutorials_run_fasttext.py`
+  :ref:`sphx_glr_auto_examples_tutorials_run_ensemblelda.py`
 
 .. raw:: html
 
-      <div class="sphx-glr-thumbnail-title">FastText Model</div>
+      <div class="sphx-glr-thumbnail-title">Ensemble LDA</div>
     </div>
 
 
@@ -220,7 +220,7 @@ Learning-oriented lessons that introduce a particular gensim feature, e.g. a mod
 
 .. raw:: html
 
-    <div class="sphx-glr-thumbcontainer" tooltip="Demonstrates using Gensim&#x27;s implemenation of the SCM.">
+    <div class="sphx-glr-thumbcontainer" tooltip="Demonstrates using Gensim&#x27;s implemenation of the WMD.">
 
 .. only:: html
 
@@ -237,7 +237,7 @@ Learning-oriented lessons that introduce a particular gensim feature, e.g. a mod
 
 .. raw:: html
 
-    <div class="sphx-glr-thumbcontainer" tooltip="Demonstrates using Gensim&#x27;s implemenation of the WMD.">
+    <div class="sphx-glr-thumbcontainer" tooltip="Demonstrates using Gensim&#x27;s implemenation of the SCM.">
 
 .. only:: html
 
diff --git a/docs/src/auto_examples/other/index.rst b/docs/src/auto_examples/other/index.rst
new file mode 100644
index 0000000000..c573b3902a
--- /dev/null
+++ b/docs/src/auto_examples/other/index.rst
@@ -0,0 +1,49 @@
+
+
+.. _sphx_glr_auto_examples_other:
+
+Other Resources
+---------------
+
+Blog posts, tutorial videos, hackathons and other useful Gensim resources, from around the internet.
+
+- *Use FastText or Word2Vec?* Comparison of embedding quality and performance. `Jupyter Notebook <https://github.com/RaRe-Technologies/gensim/blob/ba1ce894a5192fc493a865c535202695bb3c0424/docs/notebooks/Word2Vec_FastText_Comparison.ipynb>`__
+- Multiword phrases extracted from *How I Met Your Mother*. `Blog post by Mark Needham <http://www.markhneedham.com/blog/2015/02/12/pythongensim-creating-bigrams-over-how-i-met-your-mother-transcripts/>`__
+- *Using Gensim LDA for hierarchical document clustering*. `Jupyter notebook by Brandon Rose <http://brandonrose.org/clustering#Latent-Dirichlet-Allocation>`__
+- *Evolution of Voldemort topic through the 7 Harry Potter books*. `Blog post <http://rare-technologies.com/understanding-and-coding-dynamic-topic-models/>`__
+- *Movie plots by genre*: Document classification using various techniques: TF-IDF, word2vec averaging, Deep IR, Word Movers Distance and doc2vec. `Github repo <https://github.com/RaRe-Technologies/movie-plots-by-genre>`__
+- *Word2vec: Faster than Google? Optimization lessons in Python*, talk by Radim Řehůřek at PyData Berlin 2014. `Youtube video <https://www.youtube.com/watch?v=vU4TlwZzTfU>`__
+- *Word2vec & friends*, talk by Radim Řehůřek at MLMU.cz 7.1.2015. `Youtube video <https://www.youtube.com/watch?v=wTp3P2UnTfQ>`__
+
+..
+   - ? `Making an Impact with NLP <https://www.youtube.com/watch?v=oSSnDeOXTZQ>`__ -- Pycon 2016 Tutorial by Hobsons Lane
+   - ? `NLP with NLTK and Gensim <https://www.youtube.com/watch?v=itKNpCPHq3I>`__ -- Pycon 2016 Tutorial by Tony Ojeda, Benjamin Bengfort, Laura Lorenz from District Data Labs
+   - ? `Word Embeddings for Fun and Profit <https://www.youtube.com/watch?v=lfqW46u0UKc>`__ -- Talk at PyData London 2016 talk by Lev Konstantinovskiy. See accompanying `repo <https://github.com/RaRe-Technologies/movie-plots-by-genre>`__
+   - ? English Wikipedia; TODO: convert to proper .py format
+   - ? `Colouring words by topic in a document, print words in a
+     topics <https://github.com/RaRe-Technologies/gensim/blob/develop/docs/notebooks/topic_methods.ipynb>`__
+   - ? `Topic Coherence, a metric that correlates that human judgement on topic quality. <https://github.com/RaRe-Technologies/gensim/blob/develop/docs/notebooks/topic_coherence_tutorial.ipynb>`__
+   - ? `America's Next Topic Model slides <https://speakerdeck.com/tmylk/americas-next-topic-model-at-pydata-berlin-august-2016?slide=7>`__
+      - How to choose your next topic model, presented at Pydata Berlin 10 August 2016 by Lev Konstantinovsky
+   - ?  `Dynamic Topic Modeling and Dynamic Influence Model Tutorial <https://github.com/RaRe-Technologies/gensim/blob/develop/docs/notebooks/dtm_example.ipynb>`__
+   - ?  `Python Dynamic Topic Modelling Theory and Tutorial <https://github.com/RaRe-Technologies/gensim/blob/develop/docs/notebooks/ldaseqmodel.ipynb>`__
+   - ? `Word Movers Distance for Yelp Reviews tutorial <https://github.com/RaRe-Technologies/gensim/blob/develop/docs/notebooks/WMD_tutorial.ipynb>`__
+     - FIXME WMD superceded by soft cosine similarity = faster and better? any numbers / tutorials for that?
+   - ? `Great illustration of corpus preparation <https://linanqiu.github.io/2015/10/07/word2vec-sentiment/>`__, `Code <https://github.com/linanqiu/word2vec-sentiments>`__
+     - ? `Alternative <https://medium.com/@klintcho/doc2vec-tutorial-using-gensim-ab3ac03d3a1#.nv2lxvbj1>`__,
+     - ? `Alternative 2 <https://districtdatalabs.silvrback.com/modern-methods-for-sentiment-analysis>`__
+   - ? `Doc2Vec on customer reviews <http://multithreaded.stitchfix.com/blog/2015/03/11/word-is-worth-a-thousand-vectors/>`__
+   - ? `Doc2Vec on Airline Tweets Sentiment Analysis <https://www.zybuluo.com/HaomingJiang/note/462804>`__
+   - ? `Deep Inverse Regression with Yelp Reviews <https://github.com/RaRe-Technologies/gensim/blob/develop/docs/notebooks/deepir.ipynb>`__ (Document Classification using Bayesian Inversion and several word2vec models, one for each class)
+
+
+
+.. raw:: html
+
+    <div class="sphx-glr-thumbnails">
+
+
+.. raw:: html
+
+    </div>
+
diff --git a/docs/src/auto_examples/tutorials/images/sphx_glr_run_fasttext_001.png b/docs/src/auto_examples/tutorials/images/sphx_glr_run_fasttext_001.png
index 9d95c4d8f04a2059385c9a1e342354fee11f61a4..9994f9312b39f15e4bad50a319bf0c26f960efe5 100644
GIT binary patch
literal 19508
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
B^C$oS

literal 8103
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

diff --git a/docs/src/auto_examples/tutorials/images/sphx_glr_run_wmd_001.png b/docs/src/auto_examples/tutorials/images/sphx_glr_run_wmd_001.png
index 7d7ea7db56c5c8dc4d14f7739370a485d74c9814..d321d6e8ec87ed529003479d8698d80acb0ace58 100644
GIT binary patch
delta 45
zcmdn}lX3S?#tCi;W_pG?3K=CO1;tkS`nicE1v&X8Ihjd%`9<maxAuRXwJ|NU1^}Lw
B68ZoD

delta 45
zcmdn}lX3S?#tCi;#(E|?3K=CO1;tkS`nicE1v&X8Ihjd%`9<ma0wHI1ZA=TT0RWWz
B5xf8Z

diff --git a/docs/src/auto_examples/tutorials/images/thumb/sphx_glr_run_fasttext_thumb.png b/docs/src/auto_examples/tutorials/images/thumb/sphx_glr_run_fasttext_thumb.png
index 7cd540a8962cfa60f408fcd0d03a2178a7d9a65a..74b0c057f39fc5cd9cf1003abc7040a057ed00c1 100644
GIT binary patch
literal 13093
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
CuJjxL

literal 12051
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

diff --git a/docs/src/auto_examples/tutorials/images/thumb/sphx_glr_run_wmd_thumb.png b/docs/src/auto_examples/tutorials/images/thumb/sphx_glr_run_wmd_thumb.png
index 381d4a9d592148dda9d9dd0066687d998ad6059c..9732c8e0961aa871346cac0cbad00c4c9d05dad8 100644
GIT binary patch
literal 17211
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
Z0!NiSzl6?(K@P=$k`$8@tr9i}`XB9DWAFd~

literal 17172
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

diff --git a/docs/src/auto_examples/tutorials/index.rst b/docs/src/auto_examples/tutorials/index.rst
new file mode 100644
index 0000000000..d33cb95a53
--- /dev/null
+++ b/docs/src/auto_examples/tutorials/index.rst
@@ -0,0 +1,169 @@
+
+
+.. _sphx_glr_auto_examples_tutorials:
+
+Tutorials: Learning Oriented Lessons
+------------------------------------
+
+Learning-oriented lessons that introduce a particular gensim feature, e.g. a model (Word2Vec, FastText) or technique (similarity queries or text summarization).
+
+
+
+.. raw:: html
+
+    <div class="sphx-glr-thumbnails">
+
+
+.. raw:: html
+
+    <div class="sphx-glr-thumbcontainer" tooltip="Introduces Gensim&#x27;s Word2Vec model and demonstrates its use on the `Lee Evaluation Corpus &lt;http...">
+
+.. only:: html
+
+  .. image:: /auto_examples/tutorials/images/thumb/sphx_glr_run_word2vec_thumb.png
+    :alt: Word2Vec Model
+
+  :ref:`sphx_glr_auto_examples_tutorials_run_word2vec.py`
+
+.. raw:: html
+
+      <div class="sphx-glr-thumbnail-title">Word2Vec Model</div>
+    </div>
+
+
+.. raw:: html
+
+    <div class="sphx-glr-thumbcontainer" tooltip="Introduces Gensim&#x27;s Doc2Vec model and demonstrates its use on the `Lee Corpus &lt;https://hekyll.s...">
+
+.. only:: html
+
+  .. image:: /auto_examples/tutorials/images/thumb/sphx_glr_run_doc2vec_lee_thumb.png
+    :alt: Doc2Vec Model
+
+  :ref:`sphx_glr_auto_examples_tutorials_run_doc2vec_lee.py`
+
+.. raw:: html
+
+      <div class="sphx-glr-thumbnail-title">Doc2Vec Model</div>
+    </div>
+
+
+.. raw:: html
+
+    <div class="sphx-glr-thumbcontainer" tooltip="Introduces Gensim&#x27;s fastText model and demonstrates its use on the Lee Corpus.">
+
+.. only:: html
+
+  .. image:: /auto_examples/tutorials/images/thumb/sphx_glr_run_fasttext_thumb.png
+    :alt: FastText Model
+
+  :ref:`sphx_glr_auto_examples_tutorials_run_fasttext.py`
+
+.. raw:: html
+
+      <div class="sphx-glr-thumbnail-title">FastText Model</div>
+    </div>
+
+
+.. raw:: html
+
+    <div class="sphx-glr-thumbcontainer" tooltip="Introduces Gensim&#x27;s EnsembleLda model">
+
+.. only:: html
+
+  .. image:: /auto_examples/tutorials/images/thumb/sphx_glr_run_ensemblelda_thumb.png
+    :alt: Ensemble LDA
+
+  :ref:`sphx_glr_auto_examples_tutorials_run_ensemblelda.py`
+
+.. raw:: html
+
+      <div class="sphx-glr-thumbnail-title">Ensemble LDA</div>
+    </div>
+
+
+.. raw:: html
+
+    <div class="sphx-glr-thumbcontainer" tooltip="Introduces the Annoy library for similarity queries on top of vectors learned by Word2Vec.">
+
+.. only:: html
+
+  .. image:: /auto_examples/tutorials/images/thumb/sphx_glr_run_annoy_thumb.png
+    :alt: Fast Similarity Queries with Annoy and Word2Vec
+
+  :ref:`sphx_glr_auto_examples_tutorials_run_annoy.py`
+
+.. raw:: html
+
+      <div class="sphx-glr-thumbnail-title">Fast Similarity Queries with Annoy and Word2Vec</div>
+    </div>
+
+
+.. raw:: html
+
+    <div class="sphx-glr-thumbcontainer" tooltip="Introduces Gensim&#x27;s LDA model and demonstrates its use on the NIPS corpus.">
+
+.. only:: html
+
+  .. image:: /auto_examples/tutorials/images/thumb/sphx_glr_run_lda_thumb.png
+    :alt: LDA Model
+
+  :ref:`sphx_glr_auto_examples_tutorials_run_lda.py`
+
+.. raw:: html
+
+      <div class="sphx-glr-thumbnail-title">LDA Model</div>
+    </div>
+
+
+.. raw:: html
+
+    <div class="sphx-glr-thumbcontainer" tooltip="Demonstrates using Gensim&#x27;s implemenation of the WMD.">
+
+.. only:: html
+
+  .. image:: /auto_examples/tutorials/images/thumb/sphx_glr_run_wmd_thumb.png
+    :alt: Word Mover's Distance
+
+  :ref:`sphx_glr_auto_examples_tutorials_run_wmd.py`
+
+.. raw:: html
+
+      <div class="sphx-glr-thumbnail-title">Word Mover's Distance</div>
+    </div>
+
+
+.. raw:: html
+
+    <div class="sphx-glr-thumbcontainer" tooltip="Demonstrates using Gensim&#x27;s implemenation of the SCM.">
+
+.. only:: html
+
+  .. image:: /auto_examples/tutorials/images/thumb/sphx_glr_run_scm_thumb.png
+    :alt: Soft Cosine Measure
+
+  :ref:`sphx_glr_auto_examples_tutorials_run_scm.py`
+
+.. raw:: html
+
+      <div class="sphx-glr-thumbnail-title">Soft Cosine Measure</div>
+    </div>
+
+
+.. raw:: html
+
+    </div>
+
+
+.. toctree::
+   :hidden:
+
+   /auto_examples/tutorials/run_word2vec
+   /auto_examples/tutorials/run_doc2vec_lee
+   /auto_examples/tutorials/run_fasttext
+   /auto_examples/tutorials/run_ensemblelda
+   /auto_examples/tutorials/run_annoy
+   /auto_examples/tutorials/run_lda
+   /auto_examples/tutorials/run_wmd
+   /auto_examples/tutorials/run_scm
+
diff --git a/docs/src/auto_examples/tutorials/run_fasttext.ipynb b/docs/src/auto_examples/tutorials/run_fasttext.ipynb
index 6506e1465b..0170d7fc78 100644
--- a/docs/src/auto_examples/tutorials/run_fasttext.ipynb
+++ b/docs/src/auto_examples/tutorials/run_fasttext.ipynb
@@ -15,7 +15,7 @@
       "cell_type": "markdown",
       "metadata": {},
       "source": [
-        "\nFastText Model\n==============\n\nIntroduces Gensim's fastText model and demonstrates its use on the Lee Corpus.\n\n"
+        "\n# FastText Model\n\nIntroduces Gensim's fastText model and demonstrates its use on the Lee Corpus.\n"
       ]
     },
     {
@@ -40,14 +40,14 @@
       "cell_type": "markdown",
       "metadata": {},
       "source": [
-        "When to use fastText?\n---------------------\n\nThe main principle behind `fastText <https://github.com/facebookresearch/fastText>`_ is that the\nmorphological structure of a word carries important information about the meaning of the word.\nSuch structure is not taken into account by traditional word embeddings like Word2Vec, which\ntrain a unique word embedding for every individual word.\nThis is especially significant for morphologically rich languages (German, Turkish) in which a\nsingle word can have a large number of morphological forms, each of which might occur rarely,\nthus making it hard to train good word embeddings.\n\n\nfastText attempts to solve this by treating each word as the aggregation of its subwords.\nFor the sake of simplicity and language-independence, subwords are taken to be the character ngrams\nof the word. The vector for a word is simply taken to be the sum of all vectors of its component char-ngrams.\n\n\nAccording to a detailed comparison of Word2Vec and fastText in\n`this notebook <https://github.com/RaRe-Technologies/gensim/blob/develop/docs/notebooks/Word2Vec_FastText_Comparison.ipynb>`__,\nfastText does significantly better on syntactic tasks as compared to the original Word2Vec,\nespecially when the size of the training corpus is small. Word2Vec slightly outperforms fastText\non semantic tasks though. The differences grow smaller as the size of the training corpus increases.\n\n\nfastText can obtain vectors even for out-of-vocabulary (OOV) words, by summing up vectors for its\ncomponent char-ngrams, provided at least one of the char-ngrams was present in the training data.\n\n\n"
+        "## When to use fastText?\n\nThe main principle behind [fastText](https://github.com/facebookresearch/fastText) is that the\nmorphological structure of a word carries important information about the meaning of the word.\nSuch structure is not taken into account by traditional word embeddings like Word2Vec, which\ntrain a unique word embedding for every individual word.\nThis is especially significant for morphologically rich languages (German, Turkish) in which a\nsingle word can have a large number of morphological forms, each of which might occur rarely,\nthus making it hard to train good word embeddings.\n\n\nfastText attempts to solve this by treating each word as the aggregation of its subwords.\nFor the sake of simplicity and language-independence, subwords are taken to be the character ngrams\nof the word. The vector for a word is simply taken to be the sum of all vectors of its component char-ngrams.\n\n\nAccording to a detailed comparison of Word2Vec and fastText in\n[this notebook](https://github.com/RaRe-Technologies/gensim/blob/develop/docs/notebooks/Word2Vec_FastText_Comparison.ipynb)_,\nfastText does significantly better on syntactic tasks as compared to the original Word2Vec,\nespecially when the size of the training corpus is small. Word2Vec slightly outperforms fastText\non semantic tasks though. The differences grow smaller as the size of the training corpus increases.\n\n\nfastText can obtain vectors even for out-of-vocabulary (OOV) words, by summing up vectors for its\ncomponent char-ngrams, provided at least one of the char-ngrams was present in the training data.\n\n\n"
       ]
     },
     {
       "cell_type": "markdown",
       "metadata": {},
       "source": [
-        "Training models\n---------------\n\n\n"
+        "## Training models\n\n\n"
       ]
     },
     {
@@ -72,14 +72,14 @@
       "cell_type": "markdown",
       "metadata": {},
       "source": [
-        "Training hyperparameters\n^^^^^^^^^^^^^^^^^^^^^^^^\n\n\n"
+        "### Training hyperparameters\n\n\n"
       ]
     },
     {
       "cell_type": "markdown",
       "metadata": {},
       "source": [
-        "Hyperparameters for training the model follow the same pattern as Word2Vec. FastText supports the following parameters from the original word2vec:\n\n- model: Training architecture. Allowed values: `cbow`, `skipgram` (Default `cbow`)\n- vector_size: Dimensionality of vector embeddings to be learnt (Default 100)\n- alpha: Initial learning rate (Default 0.025)\n- window: Context window size (Default 5)\n- min_count: Ignore words with number of occurrences below this (Default 5)\n- loss: Training objective. Allowed values: `ns`, `hs`, `softmax` (Default `ns`)\n- sample: Threshold for downsampling higher-frequency words (Default 0.001)\n- negative: Number of negative words to sample, for `ns` (Default 5)\n- epochs: Number of epochs (Default 5)\n- sorted_vocab: Sort vocab by descending frequency (Default 1)\n- threads: Number of threads to use (Default 12)\n\n\nIn addition, fastText has three additional parameters:\n\n- min_n: min length of char ngrams (Default 3)\n- max_n: max length of char ngrams (Default 6)\n- bucket: number of buckets used for hashing ngrams (Default 2000000)\n\n\nParameters ``min_n`` and ``max_n`` control the lengths of character ngrams that each word is broken down into while training and looking up embeddings. If ``max_n`` is set to 0, or to be lesser than ``min_n``\\ , no character ngrams are used, and the model effectively reduces to Word2Vec.\n\n\n\nTo bound the memory requirements of the model being trained, a hashing function is used that maps ngrams to integers in 1 to K. For hashing these character sequences, the `Fowler-Noll-Vo hashing function <http://www.isthe.com/chongo/tech/comp/fnv>`_ (FNV-1a variant) is employed.\n\n\n"
+        "Hyperparameters for training the model follow the same pattern as Word2Vec. FastText supports the following parameters from the original word2vec:\n\n- model: Training architecture. Allowed values: `cbow`, `skipgram` (Default `cbow`)\n- vector_size: Dimensionality of vector embeddings to be learnt (Default 100)\n- alpha: Initial learning rate (Default 0.025)\n- window: Context window size (Default 5)\n- min_count: Ignore words with number of occurrences below this (Default 5)\n- loss: Training objective. Allowed values: `ns`, `hs`, `softmax` (Default `ns`)\n- sample: Threshold for downsampling higher-frequency words (Default 0.001)\n- negative: Number of negative words to sample, for `ns` (Default 5)\n- epochs: Number of epochs (Default 5)\n- sorted_vocab: Sort vocab by descending frequency (Default 1)\n- threads: Number of threads to use (Default 12)\n\n\nIn addition, fastText has three additional parameters:\n\n- min_n: min length of char ngrams (Default 3)\n- max_n: max length of char ngrams (Default 6)\n- bucket: number of buckets used for hashing ngrams (Default 2000000)\n\n\nParameters ``min_n`` and ``max_n`` control the lengths of character ngrams that each word is broken down into while training and looking up embeddings. If ``max_n`` is set to 0, or to be lesser than ``min_n``\\ , no character ngrams are used, and the model effectively reduces to Word2Vec.\n\n\n\nTo bound the memory requirements of the model being trained, a hashing function is used that maps ngrams to integers in 1 to K. For hashing these character sequences, the [Fowler-Noll-Vo hashing function](http://www.isthe.com/chongo/tech/comp/fnv) (FNV-1a variant) is employed.\n\n\n"
       ]
     },
     {
@@ -93,7 +93,7 @@
       "cell_type": "markdown",
       "metadata": {},
       "source": [
-        "Saving/loading models\n---------------------\n\n\n"
+        "## Saving/loading models\n\n\n"
       ]
     },
     {
@@ -125,7 +125,7 @@
       "cell_type": "markdown",
       "metadata": {},
       "source": [
-        "Word vector lookup\n------------------\n\n\nAll information necessary for looking up fastText words (incl. OOV words) is\ncontained in its ``model.wv`` attribute.\n\nIf you don't need to continue training your model, you can export & save this `.wv`\nattribute and discard `model`, to save space and RAM.\n\n\n"
+        "## Word vector lookup\n\n\nAll information necessary for looking up fastText words (incl. OOV words) is\ncontained in its ``model.wv`` attribute.\n\nIf you don't need to continue training your model, you can export & save this `.wv`\nattribute and discard `model`, to save space and RAM.\n\n\n"
       ]
     },
     {
@@ -176,7 +176,7 @@
       "cell_type": "markdown",
       "metadata": {},
       "source": [
-        "Similarity operations\n---------------------\n\n\n"
+        "## Similarity operations\n\n\n"
       ]
     },
     {
@@ -223,14 +223,14 @@
       "cell_type": "markdown",
       "metadata": {},
       "source": [
-        "Syntactically similar words generally have high similarity in fastText models, since a large number of the component char-ngrams will be the same. As a result, fastText generally does better at syntactic tasks than Word2Vec. A detailed comparison is provided `here <Word2Vec_FastText_Comparison.ipynb>`_.\n\n\n"
+        "Syntactically similar words generally have high similarity in fastText models, since a large number of the component char-ngrams will be the same. As a result, fastText generally does better at syntactic tasks than Word2Vec. A detailed comparison is provided [here](Word2Vec_FastText_Comparison.ipynb).\n\n\n"
       ]
     },
     {
       "cell_type": "markdown",
       "metadata": {},
       "source": [
-        "Other similarity operations\n^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\nThe example training corpus is a toy corpus, results are not expected to be good, for proof-of-concept only\n\n"
+        "### Other similarity operations\n\nThe example training corpus is a toy corpus, results are not expected to be good, for proof-of-concept only\n\n"
       ]
     },
     {
@@ -292,7 +292,7 @@
       "cell_type": "markdown",
       "metadata": {},
       "source": [
-        "Word Movers distance\n^^^^^^^^^^^^^^^^^^^^\n\nYou'll need the optional ``pyemd`` library for this section, ``pip install pyemd``.\n\nLet's start with two sentences:\n\n"
+        "### Word Movers distance\n\nYou'll need the optional ``POT`` library for this section, ``pip install POT``.\n\nLet's start with two sentences:\n\n"
       ]
     },
     {
@@ -377,7 +377,7 @@
       "name": "python",
       "nbconvert_exporter": "python",
       "pygments_lexer": "ipython3",
-      "version": "3.6.5"
+      "version": "3.10.6"
     }
   },
   "nbformat": 4,
diff --git a/docs/src/auto_examples/tutorials/run_fasttext.py b/docs/src/auto_examples/tutorials/run_fasttext.py
index 5a03b5d35e..ac3a1bc4c3 100644
--- a/docs/src/auto_examples/tutorials/run_fasttext.py
+++ b/docs/src/auto_examples/tutorials/run_fasttext.py
@@ -248,7 +248,7 @@
 # Word Movers distance
 # ^^^^^^^^^^^^^^^^^^^^
 #
-# You'll need the optional ``pyemd`` library for this section, ``pip install pyemd``.
+# You'll need the optional ``POT`` library for this section, ``pip install POT``.
 #
 # Let's start with two sentences:
 sentence_obama = 'Obama speaks to the media in Illinois'.lower().split()
diff --git a/docs/src/auto_examples/tutorials/run_fasttext.py.md5 b/docs/src/auto_examples/tutorials/run_fasttext.py.md5
index 68b4e4ced3..e227559329 100644
--- a/docs/src/auto_examples/tutorials/run_fasttext.py.md5
+++ b/docs/src/auto_examples/tutorials/run_fasttext.py.md5
@@ -1 +1 @@
-afc57676cfaca4793066a78efb2996f7
\ No newline at end of file
+5f5ac745a06ff512074def4c0eb15f79
\ No newline at end of file
diff --git a/docs/src/auto_examples/tutorials/run_fasttext.rst b/docs/src/auto_examples/tutorials/run_fasttext.rst
index 6d163b7910..539cab39e7 100644
--- a/docs/src/auto_examples/tutorials/run_fasttext.rst
+++ b/docs/src/auto_examples/tutorials/run_fasttext.rst
@@ -1,12 +1,21 @@
+
+.. DO NOT EDIT.
+.. THIS FILE WAS AUTOMATICALLY GENERATED BY SPHINX-GALLERY.
+.. TO MAKE CHANGES, EDIT THE SOURCE PYTHON FILE:
+.. "auto_examples/tutorials/run_fasttext.py"
+.. LINE NUMBERS ARE GIVEN BELOW.
+
 .. only:: html
 
     .. note::
         :class: sphx-glr-download-link-note
 
-        Click :ref:`here <sphx_glr_download_auto_examples_tutorials_run_fasttext.py>`     to download the full example code
-    .. rst-class:: sphx-glr-example-title
+        Click :ref:`here <sphx_glr_download_auto_examples_tutorials_run_fasttext.py>`
+        to download the full example code
 
-    .. _sphx_glr_auto_examples_tutorials_run_fasttext.py:
+.. rst-class:: sphx-glr-example-title
+
+.. _sphx_glr_auto_examples_tutorials_run_fasttext.py:
 
 
 FastText Model
@@ -14,6 +23,7 @@ FastText Model
 
 Introduces Gensim's fastText model and demonstrates its use on the Lee Corpus.
 
+.. GENERATED FROM PYTHON SOURCE LINES 7-11
 
 .. code-block:: default
 
@@ -28,10 +38,14 @@ Introduces Gensim's fastText model and demonstrates its use on the Lee Corpus.
 
 
 
+.. GENERATED FROM PYTHON SOURCE LINES 12-15
+
 Here, we'll learn to work with fastText library for training word-embedding
 models, saving & loading them and performing similarity operations & vector
 lookups analogous to Word2Vec.
 
+.. GENERATED FROM PYTHON SOURCE LINES 18-45
+
 When to use fastText?
 ---------------------
 
@@ -60,15 +74,20 @@ fastText can obtain vectors even for out-of-vocabulary (OOV) words, by summing u
 component char-ngrams, provided at least one of the char-ngrams was present in the training data.
 
 
+.. GENERATED FROM PYTHON SOURCE LINES 49-52
+
 Training models
 ---------------
 
 
+.. GENERATED FROM PYTHON SOURCE LINES 56-60
+
 For the following examples, we'll use the Lee Corpus (which you already have if you've installed Gensim) for training our model.
 
 
 
 
+.. GENERATED FROM PYTHON SOURCE LINES 61-82
 
 .. code-block:: default
 
@@ -99,19 +118,44 @@ For the following examples, we'll use the Lee Corpus (which you already have if
 
 .. rst-class:: sphx-glr-script-out
 
- Out:
-
  .. code-block:: none
 
-    <gensim.models.fasttext.FastText object at 0x20ce0d390>
-
-
-
+    2022-10-23 11:05:20,779 : INFO : adding document #0 to Dictionary<0 unique tokens: []>
+    2022-10-23 11:05:20,779 : INFO : built Dictionary<12 unique tokens: ['computer', 'human', 'interface', 'response', 'survey']...> from 9 documents (total 29 corpus positions)
+    2022-10-23 11:05:20,782 : INFO : Dictionary lifecycle event {'msg': "built Dictionary<12 unique tokens: ['computer', 'human', 'interface', 'response', 'survey']...> from 9 documents (total 29 corpus positions)", 'datetime': '2022-10-23T11:05:20.780094', 'gensim': '4.2.1.dev0', 'python': '3.10.6 (main, Aug 10 2022, 11:40:04) [GCC 11.3.0]', 'platform': 'Linux-5.19.0-76051900-generic-x86_64-with-glibc2.35', 'event': 'created'}
+    2022-10-23 11:05:20,858 : INFO : FastText lifecycle event {'params': 'FastText<vocab=0, vector_size=100, alpha=0.025>', 'datetime': '2022-10-23T11:05:20.858457', 'gensim': '4.2.1.dev0', 'python': '3.10.6 (main, Aug 10 2022, 11:40:04) [GCC 11.3.0]', 'platform': 'Linux-5.19.0-76051900-generic-x86_64-with-glibc2.35', 'event': 'created'}
+    2022-10-23 11:05:20,858 : INFO : collecting all words and their counts
+    2022-10-23 11:05:20,858 : INFO : PROGRESS: at sentence #0, processed 0 words, keeping 0 word types
+    2022-10-23 11:05:20,874 : INFO : collected 10781 word types from a corpus of 59890 raw words and 300 sentences
+    2022-10-23 11:05:20,874 : INFO : Creating a fresh vocabulary
+    2022-10-23 11:05:20,882 : INFO : FastText lifecycle event {'msg': 'effective_min_count=5 retains 1762 unique words (16.34% of original 10781, drops 9019)', 'datetime': '2022-10-23T11:05:20.882842', 'gensim': '4.2.1.dev0', 'python': '3.10.6 (main, Aug 10 2022, 11:40:04) [GCC 11.3.0]', 'platform': 'Linux-5.19.0-76051900-generic-x86_64-with-glibc2.35', 'event': 'prepare_vocab'}
+    2022-10-23 11:05:20,882 : INFO : FastText lifecycle event {'msg': 'effective_min_count=5 leaves 46084 word corpus (76.95% of original 59890, drops 13806)', 'datetime': '2022-10-23T11:05:20.882944', 'gensim': '4.2.1.dev0', 'python': '3.10.6 (main, Aug 10 2022, 11:40:04) [GCC 11.3.0]', 'platform': 'Linux-5.19.0-76051900-generic-x86_64-with-glibc2.35', 'event': 'prepare_vocab'}
+    2022-10-23 11:05:20,892 : INFO : deleting the raw counts dictionary of 10781 items
+    2022-10-23 11:05:20,892 : INFO : sample=0.001 downsamples 45 most-common words
+    2022-10-23 11:05:20,893 : INFO : FastText lifecycle event {'msg': 'downsampling leaves estimated 32610.61883565215 word corpus (70.8%% of prior 46084)', 'datetime': '2022-10-23T11:05:20.893011', 'gensim': '4.2.1.dev0', 'python': '3.10.6 (main, Aug 10 2022, 11:40:04) [GCC 11.3.0]', 'platform': 'Linux-5.19.0-76051900-generic-x86_64-with-glibc2.35', 'event': 'prepare_vocab'}
+    2022-10-23 11:05:20,927 : INFO : estimated required memory for 1762 words, 2000000 buckets and 100 dimensions: 802597824 bytes
+    2022-10-23 11:05:20,927 : INFO : resetting layer weights
+    2022-10-23 11:05:22,169 : INFO : FastText lifecycle event {'update': False, 'trim_rule': 'None', 'datetime': '2022-10-23T11:05:22.169699', 'gensim': '4.2.1.dev0', 'python': '3.10.6 (main, Aug 10 2022, 11:40:04) [GCC 11.3.0]', 'platform': 'Linux-5.19.0-76051900-generic-x86_64-with-glibc2.35', 'event': 'build_vocab'}
+    2022-10-23 11:05:22,169 : INFO : FastText lifecycle event {'msg': 'training model with 3 workers on 1762 vocabulary and 100 features, using sg=0 hs=0 sample=0.001 negative=5 window=5 shrink_windows=True', 'datetime': '2022-10-23T11:05:22.169966', 'gensim': '4.2.1.dev0', 'python': '3.10.6 (main, Aug 10 2022, 11:40:04) [GCC 11.3.0]', 'platform': 'Linux-5.19.0-76051900-generic-x86_64-with-glibc2.35', 'event': 'train'}
+    2022-10-23 11:05:22,273 : INFO : EPOCH 0: training on 60387 raw words (32958 effective words) took 0.1s, 355842 effective words/s
+    2022-10-23 11:05:22,369 : INFO : EPOCH 1: training on 60387 raw words (32906 effective words) took 0.1s, 369792 effective words/s
+    2022-10-23 11:05:22,466 : INFO : EPOCH 2: training on 60387 raw words (32863 effective words) took 0.1s, 361340 effective words/s
+    2022-10-23 11:05:22,563 : INFO : EPOCH 3: training on 60387 raw words (32832 effective words) took 0.1s, 363904 effective words/s
+    2022-10-23 11:05:22,662 : INFO : EPOCH 4: training on 60387 raw words (32827 effective words) took 0.1s, 355536 effective words/s
+    2022-10-23 11:05:22,662 : INFO : FastText lifecycle event {'msg': 'training on 301935 raw words (164386 effective words) took 0.5s, 333704 effective words/s', 'datetime': '2022-10-23T11:05:22.662680', 'gensim': '4.2.1.dev0', 'python': '3.10.6 (main, Aug 10 2022, 11:40:04) [GCC 11.3.0]', 'platform': 'Linux-5.19.0-76051900-generic-x86_64-with-glibc2.35', 'event': 'train'}
+    <gensim.models.fasttext.FastText object at 0x7f112f39db70>
+
+
+
+
+.. GENERATED FROM PYTHON SOURCE LINES 83-86
 
 Training hyperparameters
 ^^^^^^^^^^^^^^^^^^^^^^^^
 
 
+.. GENERATED FROM PYTHON SOURCE LINES 90-118
+
 Hyperparameters for training the model follow the same pattern as Word2Vec. FastText supports the following parameters from the original word2vec:
 
 - model: Training architecture. Allowed values: `cbow`, `skipgram` (Default `cbow`)
@@ -141,17 +185,24 @@ Parameters ``min_n`` and ``max_n`` control the lengths of character ngrams that
 To bound the memory requirements of the model being trained, a hashing function is used that maps ngrams to integers in 1 to K. For hashing these character sequences, the `Fowler-Noll-Vo hashing function <http://www.isthe.com/chongo/tech/comp/fnv>`_ (FNV-1a variant) is employed.
 
 
+.. GENERATED FROM PYTHON SOURCE LINES 122-124
+
 **Note:** You can continue to train your model while using Gensim's native implementation of fastText.
 
 
+.. GENERATED FROM PYTHON SOURCE LINES 128-131
+
 Saving/loading models
 ---------------------
 
 
+.. GENERATED FROM PYTHON SOURCE LINES 135-138
+
 Models can be saved and loaded via the ``load`` and ``save`` methods, just like
 any other model in Gensim.
 
 
+.. GENERATED FROM PYTHON SOURCE LINES 139-153
 
 .. code-block:: default
 
@@ -175,20 +226,35 @@ any other model in Gensim.
 
 .. rst-class:: sphx-glr-script-out
 
- Out:
-
  .. code-block:: none
 
-    <gensim.models.fasttext.FastText object at 0x20cc99d30>
+    2022-10-23 11:05:22,826 : INFO : FastText lifecycle event {'fname_or_handle': '/tmp/saved_model_gensim-grsw1xyt', 'separately': '[]', 'sep_limit': 10485760, 'ignore': frozenset(), 'datetime': '2022-10-23T11:05:22.826086', 'gensim': '4.2.1.dev0', 'python': '3.10.6 (main, Aug 10 2022, 11:40:04) [GCC 11.3.0]', 'platform': 'Linux-5.19.0-76051900-generic-x86_64-with-glibc2.35', 'event': 'saving'}
+    2022-10-23 11:05:22,827 : INFO : storing np array 'vectors_ngrams' to /tmp/saved_model_gensim-grsw1xyt.wv.vectors_ngrams.npy
+    2022-10-23 11:05:24,259 : INFO : not storing attribute vectors
+    2022-10-23 11:05:24,259 : INFO : not storing attribute buckets_word
+    2022-10-23 11:05:24,260 : INFO : not storing attribute cum_table
+    2022-10-23 11:05:24,289 : INFO : saved /tmp/saved_model_gensim-grsw1xyt
+    2022-10-23 11:05:24,289 : INFO : loading FastText object from /tmp/saved_model_gensim-grsw1xyt
+    2022-10-23 11:05:24,292 : INFO : loading wv recursively from /tmp/saved_model_gensim-grsw1xyt.wv.* with mmap=None
+    2022-10-23 11:05:24,292 : INFO : loading vectors_ngrams from /tmp/saved_model_gensim-grsw1xyt.wv.vectors_ngrams.npy with mmap=None
+    2022-10-23 11:05:24,594 : INFO : setting ignored attribute vectors to None
+    2022-10-23 11:05:24,594 : INFO : setting ignored attribute buckets_word to None
+    2022-10-23 11:05:24,673 : INFO : setting ignored attribute cum_table to None
+    2022-10-23 11:05:24,689 : INFO : FastText lifecycle event {'fname': '/tmp/saved_model_gensim-grsw1xyt', 'datetime': '2022-10-23T11:05:24.689800', 'gensim': '4.2.1.dev0', 'python': '3.10.6 (main, Aug 10 2022, 11:40:04) [GCC 11.3.0]', 'platform': 'Linux-5.19.0-76051900-generic-x86_64-with-glibc2.35', 'event': 'loaded'}
+    <gensim.models.fasttext.FastText object at 0x7f112f022620>
+
 
 
 
+.. GENERATED FROM PYTHON SOURCE LINES 154-158
 
 The ``save_word2vec_format`` is also available for fastText models, but will
 cause all vectors for ngrams to be lost.
 As a result, a model loaded in this way will behave as a regular word2vec model.
 
 
+.. GENERATED FROM PYTHON SOURCE LINES 162-172
+
 Word vector lookup
 ------------------
 
@@ -200,6 +266,7 @@ If you don't need to continue training your model, you can export & save this `.
 attribute and discard `model`, to save space and RAM.
 
 
+.. GENERATED FROM PYTHON SOURCE LINES 173-181
 
 .. code-block:: default
 
@@ -217,16 +284,15 @@ attribute and discard `model`, to save space and RAM.
 
 .. rst-class:: sphx-glr-script-out
 
- Out:
-
  .. code-block:: none
 
-    <gensim.models.fasttext.FastTextKeyedVectors object at 0x20ce0d828>
+    <gensim.models.fasttext.FastTextKeyedVectors object at 0x7f112f39c2e0>
     True
 
 
 
 
+.. GENERATED FROM PYTHON SOURCE LINES 183-185
 
 .. code-block:: default
 
@@ -238,8 +304,6 @@ attribute and discard `model`, to save space and RAM.
 
 .. rst-class:: sphx-glr-script-out
 
- Out:
-
  .. code-block:: none
 
     False
@@ -247,6 +311,7 @@ attribute and discard `model`, to save space and RAM.
 
 
 
+.. GENERATED FROM PYTHON SOURCE LINES 187-189
 
 .. code-block:: default
 
@@ -258,35 +323,34 @@ attribute and discard `model`, to save space and RAM.
 
 .. rst-class:: sphx-glr-script-out
 
- Out:
-
  .. code-block:: none
 
-    array([ 0.12453239, -0.26018462, -0.04087191,  0.2563215 ,  0.31401935,
-            0.16155584,  0.39527607,  0.27404118, -0.45236284,  0.06942682,
-            0.36584955,  0.51162827, -0.51161295, -0.192019  , -0.5068029 ,
-           -0.07426998, -0.6276584 ,  0.22271585,  0.19990133,  0.2582401 ,
-            0.14329399, -0.01959469, -0.45576197, -0.06447829,  0.1493489 ,
-            0.17261286, -0.13472046,  0.26546794, -0.34596932,  0.5626187 ,
-           -0.7038802 ,  0.15603925, -0.03104019, -0.06228801, -0.13480644,
-           -0.0684596 ,  0.24728075,  0.55081636,  0.07330963,  0.32814154,
-            0.1574982 ,  0.56742406, -0.31233737,  0.14195296,  0.0540203 ,
-            0.01718009,  0.05519052, -0.04002226,  0.16157456, -0.5134223 ,
-           -0.01033936,  0.05745083, -0.39208183,  0.52553374, -1.0542839 ,
-            0.2145304 , -0.15234643, -0.35197273, -0.6215585 ,  0.01796502,
-            0.21242104,  0.30762967,  0.2787644 , -0.19908747,  0.7144409 ,
-            0.45586124, -0.21344525,  0.26920903, -0.651759  , -0.37096855,
-           -0.16243419, -0.3085725 , -0.70485127, -0.04926324, -0.80278563,
-           -0.24352737,  0.6427129 , -0.3530421 , -0.29960123,  0.01466726,
-           -0.18253349, -0.2489397 ,  0.00648343,  0.18057272, -0.11812428,
-           -0.49044088,  0.1847386 , -0.27946883,  0.3941279 , -0.39211616,
-            0.26847798,  0.41468227, -0.3953728 , -0.25371104,  0.3390468 ,
-           -0.16447693, -0.18722224,  0.2782088 , -0.0696249 ,  0.4313547 ],
+    array([-0.19996722,  0.1813906 , -0.2631422 , -0.09450997,  0.0605551 ,
+            0.38595745,  0.30778143,  0.5067505 ,  0.23698695, -0.23913051,
+            0.02506454, -0.15320891, -0.2434152 ,  0.52560467, -0.38980618,
+           -0.55800015,  0.19291814, -0.23110117, -0.43341738, -0.53108984,
+           -0.4688596 , -0.04782811, -0.46767992, -0.1137548 , -0.20153292,
+           -0.31324366, -0.6708753 , -0.10945056, -0.31843412,  0.26011363,
+           -0.32820454,  0.32238692,  0.8404276 , -0.2502807 ,  0.19792764,
+            0.37759355,  0.40180317, -0.09189364, -0.36985794, -0.33649284,
+            0.46887243, -0.43174997,  0.04100857, -0.39025533, -0.51651365,
+           -0.32087606, -0.05997978,  0.14294061,  0.360094  , -0.02155857,
+            0.37047735, -0.44327876,  0.28450134, -0.4054028 , -0.19731535,
+           -0.21376207, -0.1685454 , -0.12901361,  0.03528974, -0.35231775,
+           -0.35454988, -0.43326724, -0.21185161,  0.3519939 , -0.11108   ,
+            0.69391364,  0.05785353,  0.05663215,  0.42399758,  0.24977471,
+           -0.24918619,  0.3934391 ,  0.5109367 , -0.6553013 ,  0.33610865,
+           -0.09825795,  0.25878346, -0.03377685,  0.06902322,  0.37547323,
+            0.17450804, -0.5030028 , -0.82190335, -0.15457787, -0.12070727,
+           -0.78729135,  0.49075758,  0.19234893, -0.01774574, -0.28116694,
+           -0.02472195,  0.40292844, -0.14185381,  0.07625303, -0.20744859,
+            0.59728205, -0.2217386 , -0.29148448, -0.01873052, -0.2401561 ],
           dtype=float32)
 
 
 
 
+.. GENERATED FROM PYTHON SOURCE LINES 191-194
 
 .. code-block:: default
 
@@ -299,42 +363,45 @@ attribute and discard `model`, to save space and RAM.
 
 .. rst-class:: sphx-glr-script-out
 
- Out:
-
  .. code-block:: none
 
-    array([ 0.10586783, -0.22489995, -0.03636307,  0.22263278,  0.27037606,
-            0.1394871 ,  0.3411114 ,  0.2369042 , -0.38989475,  0.05935   ,
-            0.31713557,  0.44301754, -0.44249156, -0.16652377, -0.4388366 ,
-           -0.06266895, -0.5436303 ,  0.19294666,  0.17363031,  0.22459263,
-            0.12532061, -0.01866964, -0.3936521 , -0.05507145,  0.12905194,
-            0.14942174, -0.11657442,  0.22935589, -0.29934618,  0.4859668 ,
-           -0.6073519 ,  0.13433163, -0.02491274, -0.05468523, -0.11884545,
-           -0.06117092,  0.21444008,  0.4775469 ,  0.06227469,  0.28350767,
-            0.13580805,  0.48993143, -0.27067345,  0.1252003 ,  0.04606731,
-            0.01598426,  0.04640368, -0.03456376,  0.14138013, -0.44429192,
-           -0.00865329,  0.05027836, -0.341311  ,  0.45402458, -0.91097856,
-            0.1868968 , -0.13116683, -0.30361563, -0.5364188 ,  0.01603454,
-            0.18146741,  0.26708448,  0.24074472, -0.17163375,  0.61906886,
-            0.39530373, -0.18259627,  0.23319626, -0.5634787 , -0.31959867,
-           -0.13945322, -0.269441  , -0.60941464, -0.0403638 , -0.69563633,
-           -0.2098089 ,  0.5569868 , -0.30320194, -0.25840232,  0.01436759,
-           -0.15632603, -0.21624804,  0.00434287,  0.15566474, -0.10228094,
-           -0.4249678 ,  0.16197811, -0.24147548,  0.34205705, -0.3391568 ,
-            0.23235887,  0.35860622, -0.34247142, -0.21777524,  0.29318404,
-           -0.1407287 , -0.16115218,  0.24247572, -0.06217333,  0.37221798],
+    array([-0.17333212,  0.15747589, -0.22726758, -0.08140025,  0.05103909,
+            0.33196837,  0.2670658 ,  0.43939307,  0.205082  , -0.20810795,
+            0.02336278, -0.13075203, -0.21126968,  0.45168898, -0.33789524,
+           -0.48235178,  0.16582203, -0.19900155, -0.3727986 , -0.4591713 ,
+           -0.401847  , -0.04239817, -0.40366223, -0.09961417, -0.17264459,
+           -0.26896393, -0.57774097, -0.09225026, -0.27459562,  0.22605109,
+           -0.28136173,  0.27779424,  0.72365224, -0.21562205,  0.17094932,
+            0.3253317 ,  0.34816158, -0.07930711, -0.31941393, -0.29101238,
+            0.40383977, -0.3717381 ,  0.03487907, -0.33628452, -0.4465965 ,
+           -0.27571818, -0.0488493 ,  0.12399682,  0.31216368, -0.01752434,
+            0.32131058, -0.38280696,  0.24619998, -0.34979105, -0.16987896,
+           -0.18326469, -0.14740779, -0.1095791 ,  0.03177686, -0.30144197,
+           -0.30499157, -0.37426412, -0.18248272,  0.3032632 , -0.09528783,
+            0.59990335,  0.05005969,  0.04626458,  0.36565247,  0.21673569,
+           -0.2155152 ,  0.33764148,  0.4421136 , -0.56542957,  0.29158652,
+           -0.08375975,  0.22272962, -0.02998246,  0.05934277,  0.3240713 ,
+            0.1511237 , -0.43450487, -0.7087094 , -0.13446207, -0.10318276,
+           -0.6806781 ,  0.42355484,  0.1661925 , -0.01327086, -0.2432955 ,
+           -0.02126789,  0.34654808, -0.12292334,  0.06645596, -0.1795192 ,
+            0.5156855 , -0.19275527, -0.24794976, -0.01581961, -0.2081413 ],
           dtype=float32)
 
 
 
 
+.. GENERATED FROM PYTHON SOURCE LINES 195-198
+
 Similarity operations
 ---------------------
 
 
+.. GENERATED FROM PYTHON SOURCE LINES 202-204
+
 Similarity operations work the same way as word2vec. **Out-of-vocabulary words can also be used, provided they have at least one character ngram present in the training data.**
 
 
+.. GENERATED FROM PYTHON SOURCE LINES 205-209
 
 .. code-block:: default
 
@@ -348,8 +415,6 @@ Similarity operations work the same way as word2vec. **Out-of-vocabulary words c
 
 .. rst-class:: sphx-glr-script-out
 
- Out:
-
  .. code-block:: none
 
     False
@@ -357,6 +422,7 @@ Similarity operations work the same way as word2vec. **Out-of-vocabulary words c
 
 
 
+.. GENERATED FROM PYTHON SOURCE LINES 211-213
 
 .. code-block:: default
 
@@ -368,8 +434,6 @@ Similarity operations work the same way as word2vec. **Out-of-vocabulary words c
 
 .. rst-class:: sphx-glr-script-out
 
- Out:
-
  .. code-block:: none
 
     True
@@ -377,6 +441,7 @@ Similarity operations work the same way as word2vec. **Out-of-vocabulary words c
 
 
 
+.. GENERATED FROM PYTHON SOURCE LINES 215-217
 
 .. code-block:: default
 
@@ -388,23 +453,26 @@ Similarity operations work the same way as word2vec. **Out-of-vocabulary words c
 
 .. rst-class:: sphx-glr-script-out
 
- Out:
-
  .. code-block:: none
 
-    0.9999929
+    0.9999918
+
 
 
 
+.. GENERATED FROM PYTHON SOURCE LINES 218-220
 
 Syntactically similar words generally have high similarity in fastText models, since a large number of the component char-ngrams will be the same. As a result, fastText generally does better at syntactic tasks than Word2Vec. A detailed comparison is provided `here <Word2Vec_FastText_Comparison.ipynb>`_.
 
 
+.. GENERATED FROM PYTHON SOURCE LINES 224-228
+
 Other similarity operations
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 The example training corpus is a toy corpus, results are not expected to be good, for proof-of-concept only
 
+.. GENERATED FROM PYTHON SOURCE LINES 229-231
 
 .. code-block:: default
 
@@ -416,24 +484,23 @@ The example training corpus is a toy corpus, results are not expected to be good
 
 .. rst-class:: sphx-glr-script-out
 
- Out:
-
  .. code-block:: none
 
-    [('night', 0.9999929070472717),
-     ('night.', 0.9999895095825195),
-     ('flights', 0.999988853931427),
-     ('rights', 0.9999886751174927),
-     ('residents', 0.9999884366989136),
-     ('overnight', 0.9999883770942688),
-     ('commanders', 0.999988317489624),
-     ('reached', 0.9999881386756897),
-     ('commander', 0.9999880790710449),
-     ('leading', 0.999987781047821)]
+    [('night', 0.9999918341636658),
+     ('rights', 0.9999877214431763),
+     ('flights', 0.9999877214431763),
+     ('overnight', 0.999987006187439),
+     ('fighting', 0.9999857544898987),
+     ('fighters', 0.9999855160713196),
+     ('fight', 0.9999852180480957),
+     ('entered', 0.9999851584434509),
+     ('fighter', 0.999984860420227),
+     ('eight', 0.999984622001648)]
 
 
 
 
+.. GENERATED FROM PYTHON SOURCE LINES 233-235
 
 .. code-block:: default
 
@@ -445,15 +512,14 @@ The example training corpus is a toy corpus, results are not expected to be good
 
 .. rst-class:: sphx-glr-script-out
 
- Out:
-
  .. code-block:: none
 
-    0.9999402
+    0.99993986
 
 
 
 
+.. GENERATED FROM PYTHON SOURCE LINES 237-239
 
 .. code-block:: default
 
@@ -465,8 +531,6 @@ The example training corpus is a toy corpus, results are not expected to be good
 
 .. rst-class:: sphx-glr-script-out
 
- Out:
-
  .. code-block:: none
 
     'lunch'
@@ -474,6 +538,7 @@ The example training corpus is a toy corpus, results are not expected to be good
 
 
 
+.. GENERATED FROM PYTHON SOURCE LINES 241-243
 
 .. code-block:: default
 
@@ -485,24 +550,23 @@ The example training corpus is a toy corpus, results are not expected to be good
 
 .. rst-class:: sphx-glr-script-out
 
- Out:
-
  .. code-block:: none
 
-    [('attempt', 0.999660074710846),
-     ('biggest', 0.9996545314788818),
-     ('again', 0.9996527433395386),
-     ('against', 0.9996523857116699),
-     ('doubles', 0.9996522068977356),
-     ('Royal', 0.9996512532234192),
-     ('Airlines', 0.9996494054794312),
-     ('forced', 0.9996494054794312),
-     ('arrest', 0.9996492266654968),
-     ('follows', 0.999649167060852)]
+    [('find', 0.9996394515037537),
+     ('capital,', 0.999639093875885),
+     ('findings', 0.9996339082717896),
+     ('seekers.', 0.9996323585510254),
+     ('field', 0.9996322393417358),
+     ('finding', 0.9996311664581299),
+     ('had', 0.9996305704116821),
+     ('abuse', 0.9996281862258911),
+     ('storm', 0.9996268153190613),
+     ('heading', 0.9996247291564941)]
 
 
 
 
+.. GENERATED FROM PYTHON SOURCE LINES 245-247
 
 .. code-block:: default
 
@@ -514,11 +578,20 @@ The example training corpus is a toy corpus, results are not expected to be good
 
 .. rst-class:: sphx-glr-script-out
 
- Out:
-
  .. code-block:: none
 
-    (0.24489795918367346,
+    2022-10-23 11:05:26,790 : INFO : Evaluating word analogies for top 300000 words in the model on /home/thomas/Documents/FOSS/gensim-tlouf/gensim/test/test_data/questions-words.txt
+    2022-10-23 11:05:26,814 : INFO : family: 0.0% (0/2)
+    2022-10-23 11:05:26,822 : INFO : gram3-comparative: 8.3% (1/12)
+    2022-10-23 11:05:26,827 : INFO : gram4-superlative: 33.3% (4/12)
+    2022-10-23 11:05:26,832 : INFO : gram5-present-participle: 45.0% (9/20)
+    2022-10-23 11:05:26,845 : INFO : gram6-nationality-adjective: 30.0% (6/20)
+    2022-10-23 11:05:26,851 : INFO : gram7-past-tense: 5.0% (1/20)
+    2022-10-23 11:05:26,856 : INFO : gram8-plural: 33.3% (4/12)
+    2022-10-23 11:05:26,858 : INFO : Quadruplets with out-of-vocabulary words: 99.5%
+    2022-10-23 11:05:26,859 : INFO : NB: analogies containing OOV words were skipped from evaluation! To change this behavior, use "dummy4unknown=True"
+    2022-10-23 11:05:26,859 : INFO : Total accuracy: 25.5% (25/98)
+    (0.25510204081632654,
      [{'correct': [], 'incorrect': [], 'section': 'capital-common-countries'},
       {'correct': [], 'incorrect': [], 'section': 'capital-world'},
       {'correct': [], 'incorrect': [], 'section': 'currency'},
@@ -528,81 +601,80 @@ The example training corpus is a toy corpus, results are not expected to be good
        'section': 'family'},
       {'correct': [], 'incorrect': [], 'section': 'gram1-adjective-to-adverb'},
       {'correct': [], 'incorrect': [], 'section': 'gram2-opposite'},
-      {'correct': [('GOOD', 'BETTER', 'LOW', 'LOWER'),
-                   ('GREAT', 'GREATER', 'LOW', 'LOWER'),
-                   ('LONG', 'LONGER', 'LOW', 'LOWER')],
+      {'correct': [('LONG', 'LONGER', 'GREAT', 'GREATER')],
        'incorrect': [('GOOD', 'BETTER', 'GREAT', 'GREATER'),
                      ('GOOD', 'BETTER', 'LONG', 'LONGER'),
+                     ('GOOD', 'BETTER', 'LOW', 'LOWER'),
                      ('GREAT', 'GREATER', 'LONG', 'LONGER'),
+                     ('GREAT', 'GREATER', 'LOW', 'LOWER'),
                      ('GREAT', 'GREATER', 'GOOD', 'BETTER'),
+                     ('LONG', 'LONGER', 'LOW', 'LOWER'),
                      ('LONG', 'LONGER', 'GOOD', 'BETTER'),
-                     ('LONG', 'LONGER', 'GREAT', 'GREATER'),
                      ('LOW', 'LOWER', 'GOOD', 'BETTER'),
                      ('LOW', 'LOWER', 'GREAT', 'GREATER'),
                      ('LOW', 'LOWER', 'LONG', 'LONGER')],
        'section': 'gram3-comparative'},
-      {'correct': [('BIG', 'BIGGEST', 'LARGE', 'LARGEST'),
-                   ('GOOD', 'BEST', 'LARGE', 'LARGEST'),
-                   ('GREAT', 'GREATEST', 'LARGE', 'LARGEST')],
+      {'correct': [('GOOD', 'BEST', 'LARGE', 'LARGEST'),
+                   ('GREAT', 'GREATEST', 'LARGE', 'LARGEST'),
+                   ('GREAT', 'GREATEST', 'BIG', 'BIGGEST'),
+                   ('LARGE', 'LARGEST', 'BIG', 'BIGGEST')],
        'incorrect': [('BIG', 'BIGGEST', 'GOOD', 'BEST'),
                      ('BIG', 'BIGGEST', 'GREAT', 'GREATEST'),
+                     ('BIG', 'BIGGEST', 'LARGE', 'LARGEST'),
                      ('GOOD', 'BEST', 'GREAT', 'GREATEST'),
                      ('GOOD', 'BEST', 'BIG', 'BIGGEST'),
-                     ('GREAT', 'GREATEST', 'BIG', 'BIGGEST'),
                      ('GREAT', 'GREATEST', 'GOOD', 'BEST'),
-                     ('LARGE', 'LARGEST', 'BIG', 'BIGGEST'),
                      ('LARGE', 'LARGEST', 'GOOD', 'BEST'),
                      ('LARGE', 'LARGEST', 'GREAT', 'GREATEST')],
        'section': 'gram4-superlative'},
-      {'correct': [('GO', 'GOING', 'SAY', 'SAYING'),
-                   ('LOOK', 'LOOKING', 'PLAY', 'PLAYING'),
+      {'correct': [('GO', 'GOING', 'PLAY', 'PLAYING'),
+                   ('GO', 'GOING', 'SAY', 'SAYING'),
                    ('LOOK', 'LOOKING', 'SAY', 'SAYING'),
                    ('LOOK', 'LOOKING', 'GO', 'GOING'),
                    ('PLAY', 'PLAYING', 'SAY', 'SAYING'),
                    ('PLAY', 'PLAYING', 'GO', 'GOING'),
-                   ('SAY', 'SAYING', 'GO', 'GOING')],
+                   ('PLAY', 'PLAYING', 'LOOK', 'LOOKING'),
+                   ('SAY', 'SAYING', 'GO', 'GOING'),
+                   ('SAY', 'SAYING', 'PLAY', 'PLAYING')],
        'incorrect': [('GO', 'GOING', 'LOOK', 'LOOKING'),
-                     ('GO', 'GOING', 'PLAY', 'PLAYING'),
                      ('GO', 'GOING', 'RUN', 'RUNNING'),
+                     ('LOOK', 'LOOKING', 'PLAY', 'PLAYING'),
                      ('LOOK', 'LOOKING', 'RUN', 'RUNNING'),
                      ('PLAY', 'PLAYING', 'RUN', 'RUNNING'),
-                     ('PLAY', 'PLAYING', 'LOOK', 'LOOKING'),
                      ('RUN', 'RUNNING', 'SAY', 'SAYING'),
                      ('RUN', 'RUNNING', 'GO', 'GOING'),
                      ('RUN', 'RUNNING', 'LOOK', 'LOOKING'),
                      ('RUN', 'RUNNING', 'PLAY', 'PLAYING'),
                      ('SAY', 'SAYING', 'LOOK', 'LOOKING'),
-                     ('SAY', 'SAYING', 'PLAY', 'PLAYING'),
                      ('SAY', 'SAYING', 'RUN', 'RUNNING')],
        'section': 'gram5-present-participle'},
       {'correct': [('AUSTRALIA', 'AUSTRALIAN', 'INDIA', 'INDIAN'),
                    ('AUSTRALIA', 'AUSTRALIAN', 'ISRAEL', 'ISRAELI'),
                    ('FRANCE', 'FRENCH', 'INDIA', 'INDIAN'),
                    ('INDIA', 'INDIAN', 'ISRAEL', 'ISRAELI'),
-                   ('ISRAEL', 'ISRAELI', 'INDIA', 'INDIAN'),
-                   ('SWITZERLAND', 'SWISS', 'INDIA', 'INDIAN')],
+                   ('INDIA', 'INDIAN', 'AUSTRALIA', 'AUSTRALIAN'),
+                   ('ISRAEL', 'ISRAELI', 'INDIA', 'INDIAN')],
        'incorrect': [('AUSTRALIA', 'AUSTRALIAN', 'FRANCE', 'FRENCH'),
                      ('AUSTRALIA', 'AUSTRALIAN', 'SWITZERLAND', 'SWISS'),
                      ('FRANCE', 'FRENCH', 'ISRAEL', 'ISRAELI'),
                      ('FRANCE', 'FRENCH', 'SWITZERLAND', 'SWISS'),
                      ('FRANCE', 'FRENCH', 'AUSTRALIA', 'AUSTRALIAN'),
                      ('INDIA', 'INDIAN', 'SWITZERLAND', 'SWISS'),
-                     ('INDIA', 'INDIAN', 'AUSTRALIA', 'AUSTRALIAN'),
                      ('INDIA', 'INDIAN', 'FRANCE', 'FRENCH'),
                      ('ISRAEL', 'ISRAELI', 'SWITZERLAND', 'SWISS'),
                      ('ISRAEL', 'ISRAELI', 'AUSTRALIA', 'AUSTRALIAN'),
                      ('ISRAEL', 'ISRAELI', 'FRANCE', 'FRENCH'),
                      ('SWITZERLAND', 'SWISS', 'AUSTRALIA', 'AUSTRALIAN'),
                      ('SWITZERLAND', 'SWISS', 'FRANCE', 'FRENCH'),
+                     ('SWITZERLAND', 'SWISS', 'INDIA', 'INDIAN'),
                      ('SWITZERLAND', 'SWISS', 'ISRAEL', 'ISRAELI')],
        'section': 'gram6-nationality-adjective'},
-      {'correct': [],
+      {'correct': [('PAYING', 'PAID', 'SAYING', 'SAID')],
        'incorrect': [('GOING', 'WENT', 'PAYING', 'PAID'),
                      ('GOING', 'WENT', 'PLAYING', 'PLAYED'),
                      ('GOING', 'WENT', 'SAYING', 'SAID'),
                      ('GOING', 'WENT', 'TAKING', 'TOOK'),
                      ('PAYING', 'PAID', 'PLAYING', 'PLAYED'),
-                     ('PAYING', 'PAID', 'SAYING', 'SAID'),
                      ('PAYING', 'PAID', 'TAKING', 'TOOK'),
                      ('PAYING', 'PAID', 'GOING', 'WENT'),
                      ('PLAYING', 'PLAYED', 'SAYING', 'SAID'),
@@ -618,76 +690,76 @@ The example training corpus is a toy corpus, results are not expected to be good
                      ('TAKING', 'TOOK', 'PLAYING', 'PLAYED'),
                      ('TAKING', 'TOOK', 'SAYING', 'SAID')],
        'section': 'gram7-past-tense'},
-      {'correct': [('BUILDING', 'BUILDINGS', 'CAR', 'CARS'),
-                   ('BUILDING', 'BUILDINGS', 'CHILD', 'CHILDREN'),
-                   ('CAR', 'CARS', 'BUILDING', 'BUILDINGS'),
-                   ('CHILD', 'CHILDREN', 'CAR', 'CARS'),
-                   ('MAN', 'MEN', 'CAR', 'CARS')],
-       'incorrect': [('BUILDING', 'BUILDINGS', 'MAN', 'MEN'),
-                     ('CAR', 'CARS', 'CHILD', 'CHILDREN'),
+      {'correct': [('BUILDING', 'BUILDINGS', 'CHILD', 'CHILDREN'),
+                   ('CAR', 'CARS', 'CHILD', 'CHILDREN'),
+                   ('MAN', 'MEN', 'BUILDING', 'BUILDINGS'),
+                   ('MAN', 'MEN', 'CHILD', 'CHILDREN')],
+       'incorrect': [('BUILDING', 'BUILDINGS', 'CAR', 'CARS'),
+                     ('BUILDING', 'BUILDINGS', 'MAN', 'MEN'),
                      ('CAR', 'CARS', 'MAN', 'MEN'),
+                     ('CAR', 'CARS', 'BUILDING', 'BUILDINGS'),
                      ('CHILD', 'CHILDREN', 'MAN', 'MEN'),
                      ('CHILD', 'CHILDREN', 'BUILDING', 'BUILDINGS'),
-                     ('MAN', 'MEN', 'BUILDING', 'BUILDINGS'),
-                     ('MAN', 'MEN', 'CHILD', 'CHILDREN')],
+                     ('CHILD', 'CHILDREN', 'CAR', 'CARS'),
+                     ('MAN', 'MEN', 'CAR', 'CARS')],
        'section': 'gram8-plural'},
       {'correct': [], 'incorrect': [], 'section': 'gram9-plural-verbs'},
-      {'correct': [('GOOD', 'BETTER', 'LOW', 'LOWER'),
-                   ('GREAT', 'GREATER', 'LOW', 'LOWER'),
-                   ('LONG', 'LONGER', 'LOW', 'LOWER'),
-                   ('BIG', 'BIGGEST', 'LARGE', 'LARGEST'),
+      {'correct': [('LONG', 'LONGER', 'GREAT', 'GREATER'),
                    ('GOOD', 'BEST', 'LARGE', 'LARGEST'),
                    ('GREAT', 'GREATEST', 'LARGE', 'LARGEST'),
+                   ('GREAT', 'GREATEST', 'BIG', 'BIGGEST'),
+                   ('LARGE', 'LARGEST', 'BIG', 'BIGGEST'),
+                   ('GO', 'GOING', 'PLAY', 'PLAYING'),
                    ('GO', 'GOING', 'SAY', 'SAYING'),
-                   ('LOOK', 'LOOKING', 'PLAY', 'PLAYING'),
                    ('LOOK', 'LOOKING', 'SAY', 'SAYING'),
                    ('LOOK', 'LOOKING', 'GO', 'GOING'),
                    ('PLAY', 'PLAYING', 'SAY', 'SAYING'),
                    ('PLAY', 'PLAYING', 'GO', 'GOING'),
+                   ('PLAY', 'PLAYING', 'LOOK', 'LOOKING'),
                    ('SAY', 'SAYING', 'GO', 'GOING'),
+                   ('SAY', 'SAYING', 'PLAY', 'PLAYING'),
                    ('AUSTRALIA', 'AUSTRALIAN', 'INDIA', 'INDIAN'),
                    ('AUSTRALIA', 'AUSTRALIAN', 'ISRAEL', 'ISRAELI'),
                    ('FRANCE', 'FRENCH', 'INDIA', 'INDIAN'),
                    ('INDIA', 'INDIAN', 'ISRAEL', 'ISRAELI'),
+                   ('INDIA', 'INDIAN', 'AUSTRALIA', 'AUSTRALIAN'),
                    ('ISRAEL', 'ISRAELI', 'INDIA', 'INDIAN'),
-                   ('SWITZERLAND', 'SWISS', 'INDIA', 'INDIAN'),
-                   ('BUILDING', 'BUILDINGS', 'CAR', 'CARS'),
+                   ('PAYING', 'PAID', 'SAYING', 'SAID'),
                    ('BUILDING', 'BUILDINGS', 'CHILD', 'CHILDREN'),
-                   ('CAR', 'CARS', 'BUILDING', 'BUILDINGS'),
-                   ('CHILD', 'CHILDREN', 'CAR', 'CARS'),
-                   ('MAN', 'MEN', 'CAR', 'CARS')],
+                   ('CAR', 'CARS', 'CHILD', 'CHILDREN'),
+                   ('MAN', 'MEN', 'BUILDING', 'BUILDINGS'),
+                   ('MAN', 'MEN', 'CHILD', 'CHILDREN')],
        'incorrect': [('HE', 'SHE', 'HIS', 'HER'),
                      ('HIS', 'HER', 'HE', 'SHE'),
                      ('GOOD', 'BETTER', 'GREAT', 'GREATER'),
                      ('GOOD', 'BETTER', 'LONG', 'LONGER'),
+                     ('GOOD', 'BETTER', 'LOW', 'LOWER'),
                      ('GREAT', 'GREATER', 'LONG', 'LONGER'),
+                     ('GREAT', 'GREATER', 'LOW', 'LOWER'),
                      ('GREAT', 'GREATER', 'GOOD', 'BETTER'),
+                     ('LONG', 'LONGER', 'LOW', 'LOWER'),
                      ('LONG', 'LONGER', 'GOOD', 'BETTER'),
-                     ('LONG', 'LONGER', 'GREAT', 'GREATER'),
                      ('LOW', 'LOWER', 'GOOD', 'BETTER'),
                      ('LOW', 'LOWER', 'GREAT', 'GREATER'),
                      ('LOW', 'LOWER', 'LONG', 'LONGER'),
                      ('BIG', 'BIGGEST', 'GOOD', 'BEST'),
                      ('BIG', 'BIGGEST', 'GREAT', 'GREATEST'),
+                     ('BIG', 'BIGGEST', 'LARGE', 'LARGEST'),
                      ('GOOD', 'BEST', 'GREAT', 'GREATEST'),
                      ('GOOD', 'BEST', 'BIG', 'BIGGEST'),
-                     ('GREAT', 'GREATEST', 'BIG', 'BIGGEST'),
                      ('GREAT', 'GREATEST', 'GOOD', 'BEST'),
-                     ('LARGE', 'LARGEST', 'BIG', 'BIGGEST'),
                      ('LARGE', 'LARGEST', 'GOOD', 'BEST'),
                      ('LARGE', 'LARGEST', 'GREAT', 'GREATEST'),
                      ('GO', 'GOING', 'LOOK', 'LOOKING'),
-                     ('GO', 'GOING', 'PLAY', 'PLAYING'),
                      ('GO', 'GOING', 'RUN', 'RUNNING'),
+                     ('LOOK', 'LOOKING', 'PLAY', 'PLAYING'),
                      ('LOOK', 'LOOKING', 'RUN', 'RUNNING'),
                      ('PLAY', 'PLAYING', 'RUN', 'RUNNING'),
-                     ('PLAY', 'PLAYING', 'LOOK', 'LOOKING'),
                      ('RUN', 'RUNNING', 'SAY', 'SAYING'),
                      ('RUN', 'RUNNING', 'GO', 'GOING'),
                      ('RUN', 'RUNNING', 'LOOK', 'LOOKING'),
                      ('RUN', 'RUNNING', 'PLAY', 'PLAYING'),
                      ('SAY', 'SAYING', 'LOOK', 'LOOKING'),
-                     ('SAY', 'SAYING', 'PLAY', 'PLAYING'),
                      ('SAY', 'SAYING', 'RUN', 'RUNNING'),
                      ('AUSTRALIA', 'AUSTRALIAN', 'FRANCE', 'FRENCH'),
                      ('AUSTRALIA', 'AUSTRALIAN', 'SWITZERLAND', 'SWISS'),
@@ -695,20 +767,19 @@ The example training corpus is a toy corpus, results are not expected to be good
                      ('FRANCE', 'FRENCH', 'SWITZERLAND', 'SWISS'),
                      ('FRANCE', 'FRENCH', 'AUSTRALIA', 'AUSTRALIAN'),
                      ('INDIA', 'INDIAN', 'SWITZERLAND', 'SWISS'),
-                     ('INDIA', 'INDIAN', 'AUSTRALIA', 'AUSTRALIAN'),
                      ('INDIA', 'INDIAN', 'FRANCE', 'FRENCH'),
                      ('ISRAEL', 'ISRAELI', 'SWITZERLAND', 'SWISS'),
                      ('ISRAEL', 'ISRAELI', 'AUSTRALIA', 'AUSTRALIAN'),
                      ('ISRAEL', 'ISRAELI', 'FRANCE', 'FRENCH'),
                      ('SWITZERLAND', 'SWISS', 'AUSTRALIA', 'AUSTRALIAN'),
                      ('SWITZERLAND', 'SWISS', 'FRANCE', 'FRENCH'),
+                     ('SWITZERLAND', 'SWISS', 'INDIA', 'INDIAN'),
                      ('SWITZERLAND', 'SWISS', 'ISRAEL', 'ISRAELI'),
                      ('GOING', 'WENT', 'PAYING', 'PAID'),
                      ('GOING', 'WENT', 'PLAYING', 'PLAYED'),
                      ('GOING', 'WENT', 'SAYING', 'SAID'),
                      ('GOING', 'WENT', 'TAKING', 'TOOK'),
                      ('PAYING', 'PAID', 'PLAYING', 'PLAYED'),
-                     ('PAYING', 'PAID', 'SAYING', 'SAID'),
                      ('PAYING', 'PAID', 'TAKING', 'TOOK'),
                      ('PAYING', 'PAID', 'GOING', 'WENT'),
                      ('PLAYING', 'PLAYED', 'SAYING', 'SAID'),
@@ -723,25 +794,29 @@ The example training corpus is a toy corpus, results are not expected to be good
                      ('TAKING', 'TOOK', 'PAYING', 'PAID'),
                      ('TAKING', 'TOOK', 'PLAYING', 'PLAYED'),
                      ('TAKING', 'TOOK', 'SAYING', 'SAID'),
+                     ('BUILDING', 'BUILDINGS', 'CAR', 'CARS'),
                      ('BUILDING', 'BUILDINGS', 'MAN', 'MEN'),
-                     ('CAR', 'CARS', 'CHILD', 'CHILDREN'),
                      ('CAR', 'CARS', 'MAN', 'MEN'),
+                     ('CAR', 'CARS', 'BUILDING', 'BUILDINGS'),
                      ('CHILD', 'CHILDREN', 'MAN', 'MEN'),
                      ('CHILD', 'CHILDREN', 'BUILDING', 'BUILDINGS'),
-                     ('MAN', 'MEN', 'BUILDING', 'BUILDINGS'),
-                     ('MAN', 'MEN', 'CHILD', 'CHILDREN')],
+                     ('CHILD', 'CHILDREN', 'CAR', 'CARS'),
+                     ('MAN', 'MEN', 'CAR', 'CARS')],
        'section': 'Total accuracy'}])
 
 
 
 
+.. GENERATED FROM PYTHON SOURCE LINES 248-254
+
 Word Movers distance
 ^^^^^^^^^^^^^^^^^^^^
 
-You'll need the optional ``pyemd`` library for this section, ``pip install pyemd``.
+You'll need the optional ``POT`` library for this section, ``pip install POT``.
 
 Let's start with two sentences:
 
+.. GENERATED FROM PYTHON SOURCE LINES 254-258
 
 .. code-block:: default
 
@@ -756,9 +831,12 @@ Let's start with two sentences:
 
 
 
+.. GENERATED FROM PYTHON SOURCE LINES 259-261
+
 Remove their stopwords.
 
 
+.. GENERATED FROM PYTHON SOURCE LINES 261-265
 
 .. code-block:: default
 
@@ -773,8 +851,11 @@ Remove their stopwords.
 
 
 
+.. GENERATED FROM PYTHON SOURCE LINES 266-267
+
 Compute the Word Movers Distance between the two sentences.
 
+.. GENERATED FROM PYTHON SOURCE LINES 267-270
 
 .. code-block:: default
 
@@ -787,18 +868,22 @@ Compute the Word Movers Distance between the two sentences.
 
 .. rst-class:: sphx-glr-script-out
 
- Out:
-
  .. code-block:: none
 
-    'Word Movers Distance is 0.015923231075180694 (lower means closer)'
+    2022-10-23 11:05:27,139 : INFO : adding document #0 to Dictionary<0 unique tokens: []>
+    2022-10-23 11:05:27,140 : INFO : built Dictionary<8 unique tokens: ['illinois', 'media', 'obama', 'speaks', 'chicago']...> from 2 documents (total 8 corpus positions)
+    2022-10-23 11:05:27,140 : INFO : Dictionary lifecycle event {'msg': "built Dictionary<8 unique tokens: ['illinois', 'media', 'obama', 'speaks', 'chicago']...> from 2 documents (total 8 corpus positions)", 'datetime': '2022-10-23T11:05:27.140129', 'gensim': '4.2.1.dev0', 'python': '3.10.6 (main, Aug 10 2022, 11:40:04) [GCC 11.3.0]', 'platform': 'Linux-5.19.0-76051900-generic-x86_64-with-glibc2.35', 'event': 'created'}
+    'Word Movers Distance is 0.01600033861640832 (lower means closer)'
 
 
 
 
+.. GENERATED FROM PYTHON SOURCE LINES 271-273
+
 That's all! You've made it to the end of this tutorial.
 
 
+.. GENERATED FROM PYTHON SOURCE LINES 273-278
 
 .. code-block:: default
 
@@ -810,9 +895,10 @@ That's all! You've made it to the end of this tutorial.
 
 
 
-.. image:: /auto_examples/tutorials/images/sphx_glr_run_fasttext_001.png
-    :alt: run fasttext
-    :class: sphx-glr-single-img
+.. image-sg:: /auto_examples/tutorials/images/sphx_glr_run_fasttext_001.png
+   :alt: run fasttext
+   :srcset: /auto_examples/tutorials/images/sphx_glr_run_fasttext_001.png
+   :class: sphx-glr-single-img
 
 
 
@@ -821,30 +907,25 @@ That's all! You've made it to the end of this tutorial.
 
 .. rst-class:: sphx-glr-timing
 
-   **Total running time of the script:** ( 0 minutes  28.645 seconds)
+   **Total running time of the script:** ( 0 minutes  7.208 seconds)
 
-**Estimated memory usage:**  2975 MB
+**Estimated memory usage:**  1619 MB
 
 
 .. _sphx_glr_download_auto_examples_tutorials_run_fasttext.py:
 
+.. only:: html
 
-.. only :: html
-
- .. container:: sphx-glr-footer
-    :class: sphx-glr-footer-example
-
-
-
-  .. container:: sphx-glr-download sphx-glr-download-python
+  .. container:: sphx-glr-footer sphx-glr-footer-example
 
-     :download:`Download Python source code: run_fasttext.py <run_fasttext.py>`
 
+    .. container:: sphx-glr-download sphx-glr-download-python
 
+      :download:`Download Python source code: run_fasttext.py <run_fasttext.py>`
 
-  .. container:: sphx-glr-download sphx-glr-download-jupyter
+    .. container:: sphx-glr-download sphx-glr-download-jupyter
 
-     :download:`Download Jupyter notebook: run_fasttext.ipynb <run_fasttext.ipynb>`
+      :download:`Download Jupyter notebook: run_fasttext.ipynb <run_fasttext.ipynb>`
 
 
 .. only:: html
diff --git a/docs/src/auto_examples/tutorials/run_fasttext_codeobj.pickle b/docs/src/auto_examples/tutorials/run_fasttext_codeobj.pickle
new file mode 100644
index 0000000000000000000000000000000000000000..1be3e19b04597db39ff779f3d4ac6c72e7b74473
GIT binary patch
literal 9038
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
Kf}*_~TmJ&1@-lJ&

literal 0
HcmV?d00001

diff --git a/docs/src/auto_examples/tutorials/run_wmd.ipynb b/docs/src/auto_examples/tutorials/run_wmd.ipynb
index 99711a9278..89a002f539 100644
--- a/docs/src/auto_examples/tutorials/run_wmd.ipynb
+++ b/docs/src/auto_examples/tutorials/run_wmd.ipynb
@@ -15,14 +15,14 @@
       "cell_type": "markdown",
       "metadata": {},
       "source": [
-        "\nWord Mover's Distance\n=====================\n\nDemonstrates using Gensim's implemenation of the WMD.\n"
+        "\n# Word Mover's Distance\n\nDemonstrates using Gensim's implemenation of the WMD.\n"
       ]
     },
     {
       "cell_type": "markdown",
       "metadata": {},
       "source": [
-        "Word Mover's Distance (WMD) is a promising new tool in machine learning that\nallows us to submit a query and return the most relevant documents. This\ntutorial introduces WMD and shows how you can compute the WMD distance\nbetween two documents using ``wmdistance``.\n\nWMD Basics\n----------\n\nWMD enables us to assess the \"distance\" between two documents in a meaningful\nway even when they have no words in common. It uses `word2vec\n<http://rare-technologies.com/word2vec-tutorial/>`_ [4] vector embeddings of\nwords. It been shown to outperform many of the state-of-the-art methods in\nk-nearest neighbors classification [3].\n\nWMD is illustrated below for two very similar sentences (illustration taken\nfrom `Vlad Niculae's blog\n<http://vene.ro/blog/word-movers-distance-in-python.html>`_). The sentences\nhave no words in common, but by matching the relevant words, WMD is able to\naccurately measure the (dis)similarity between the two sentences. The method\nalso uses the bag-of-words representation of the documents (simply put, the\nword's frequencies in the documents), noted as $d$ in the figure below. The\nintuition behind the method is that we find the minimum \"traveling distance\"\nbetween documents, in other words the most efficient way to \"move\" the\ndistribution of document 1 to the distribution of document 2.\n\n\n"
+        "Word Mover's Distance (WMD) is a promising new tool in machine learning that\nallows us to submit a query and return the most relevant documents. This\ntutorial introduces WMD and shows how you can compute the WMD distance\nbetween two documents using ``wmdistance``.\n\n## WMD Basics\n\nWMD enables us to assess the \"distance\" between two documents in a meaningful\nway even when they have no words in common. It uses [word2vec](http://rare-technologies.com/word2vec-tutorial/) [4] vector embeddings of\nwords. It been shown to outperform many of the state-of-the-art methods in\nk-nearest neighbors classification [3].\n\nWMD is illustrated below for two very similar sentences (illustration taken\nfrom [Vlad Niculae's blog](http://vene.ro/blog/word-movers-distance-in-python.html)). The sentences\nhave no words in common, but by matching the relevant words, WMD is able to\naccurately measure the (dis)similarity between the two sentences. The method\nalso uses the bag-of-words representation of the documents (simply put, the\nword's frequencies in the documents), noted as $d$ in the figure below. The\nintuition behind the method is that we find the minimum \"traveling distance\"\nbetween documents, in other words the most efficient way to \"move\" the\ndistribution of document 1 to the distribution of document 2.\n\n\n"
       ]
     },
     {
@@ -40,7 +40,7 @@
       "cell_type": "markdown",
       "metadata": {},
       "source": [
-        "This method was introduced in the article \"From Word Embeddings To Document\nDistances\" by Matt Kusner et al. (\\ `link to PDF\n<http://jmlr.org/proceedings/papers/v37/kusnerb15.pdf>`_\\ ). It is inspired\nby the \"Earth Mover's Distance\", and employs a solver of the \"transportation\nproblem\".\n\nIn this tutorial, we will learn how to use Gensim's WMD functionality, which\nconsists of the ``wmdistance`` method for distance computation, and the\n``WmdSimilarity`` class for corpus based similarity queries.\n\n.. Important::\n   If you use Gensim's WMD functionality, please consider citing [1], [2] and [3].\n\nComputing the Word Mover's Distance\n-----------------------------------\n\nTo use WMD, you need some existing word embeddings.\nYou could train your own Word2Vec model, but that is beyond the scope of this tutorial\n(check out `sphx_glr_auto_examples_tutorials_run_word2vec.py` if you're interested).\nFor this tutorial, we'll be using an existing Word2Vec model.\n\nLet's take some sentences to compute the distance between.\n\n\n"
+        "This method was introduced in the article \"From Word Embeddings To Document\nDistances\" by Matt Kusner et al. (\\ [link to PDF](http://jmlr.org/proceedings/papers/v37/kusnerb15.pdf)\\ ). It is inspired\nby the \"Earth Mover's Distance\", and employs a solver of the \"transportation\nproblem\".\n\nIn this tutorial, we will learn how to use Gensim's WMD functionality, which\nconsists of the ``wmdistance`` method for distance computation, and the\n``WmdSimilarity`` class for corpus based similarity queries.\n\n.. Important::\n   If you use Gensim's WMD functionality, please consider citing [1] and [2].\n\n## Computing the Word Mover's Distance\n\nTo use WMD, you need some existing word embeddings.\nYou could train your own Word2Vec model, but that is beyond the scope of this tutorial\n(check out `sphx_glr_auto_examples_tutorials_run_word2vec.py` if you're interested).\nFor this tutorial, we'll be using an existing Word2Vec model.\n\nLet's take some sentences to compute the distance between.\n\n\n"
       ]
     },
     {
@@ -130,7 +130,7 @@
       "cell_type": "markdown",
       "metadata": {},
       "source": [
-        "References\n----------\n\n1. Ofir Pele and Michael Werman, *A linear time histogram metric for improved SIFT matching*, 2008.\n2. Ofir Pele and Michael Werman, *Fast and robust earth mover's distances*, 2009.\n3. Matt Kusner et al. *From Embeddings To Document Distances*, 2015.\n4. Tom\u00e1\u0161 Mikolov et al. *Efficient Estimation of Word Representations in Vector Space*, 2013.\n\n\n"
+        "## References\n\n1. R\u00e9mi Flamary et al. *POT: Python Optimal Transport*, 2021.\n2. Matt Kusner et al. *From Embeddings To Document Distances*, 2015.\n3. Tom\u00e1\u0161 Mikolov et al. *Efficient Estimation of Word Representations in Vector Space*, 2013.\n\n\n"
       ]
     }
   ],
@@ -150,7 +150,7 @@
       "name": "python",
       "nbconvert_exporter": "python",
       "pygments_lexer": "ipython3",
-      "version": "3.7.3"
+      "version": "3.10.6"
     }
   },
   "nbformat": 4,
diff --git a/docs/src/auto_examples/tutorials/run_wmd.py b/docs/src/auto_examples/tutorials/run_wmd.py
index 06e263063a..c037ef697b 100644
--- a/docs/src/auto_examples/tutorials/run_wmd.py
+++ b/docs/src/auto_examples/tutorials/run_wmd.py
@@ -53,7 +53,7 @@
 # ``WmdSimilarity`` class for corpus based similarity queries.
 #
 # .. Important::
-#    If you use Gensim's WMD functionality, please consider citing [1], [2] and [3].
+#    If you use Gensim's WMD functionality, please consider citing [1] and [2].
 #
 # Computing the Word Mover's Distance
 # -----------------------------------
@@ -118,8 +118,7 @@ def preprocess(sentence):
 # References
 # ----------
 #
-# 1. Ofir Pele and Michael Werman, *A linear time histogram metric for improved SIFT matching*, 2008.
-# 2. Ofir Pele and Michael Werman, *Fast and robust earth mover's distances*, 2009.
-# 3. Matt Kusner et al. *From Embeddings To Document Distances*, 2015.
-# 4. Tomáš Mikolov et al. *Efficient Estimation of Word Representations in Vector Space*, 2013.
+# 1. Rémi Flamary et al. *POT: Python Optimal Transport*, 2021.
+# 2. Matt Kusner et al. *From Embeddings To Document Distances*, 2015.
+# 3. Tomáš Mikolov et al. *Efficient Estimation of Word Representations in Vector Space*, 2013.
 #
diff --git a/docs/src/auto_examples/tutorials/run_wmd.py.md5 b/docs/src/auto_examples/tutorials/run_wmd.py.md5
index 382c5b9954..b6772e20fb 100644
--- a/docs/src/auto_examples/tutorials/run_wmd.py.md5
+++ b/docs/src/auto_examples/tutorials/run_wmd.py.md5
@@ -1 +1 @@
-45521a352637a0f53e62f3e19e61fc07
\ No newline at end of file
+a087a5b43fbba9a3e71c2384ddc264af
\ No newline at end of file
diff --git a/docs/src/auto_examples/tutorials/run_wmd.rst b/docs/src/auto_examples/tutorials/run_wmd.rst
index cc62e120dd..6a04bcc412 100644
--- a/docs/src/auto_examples/tutorials/run_wmd.rst
+++ b/docs/src/auto_examples/tutorials/run_wmd.rst
@@ -1,7 +1,18 @@
-.. note::
-    :class: sphx-glr-download-link-note
 
-    Click :ref:`here <sphx_glr_download_auto_examples_tutorials_run_wmd.py>` to download the full example code
+.. DO NOT EDIT.
+.. THIS FILE WAS AUTOMATICALLY GENERATED BY SPHINX-GALLERY.
+.. TO MAKE CHANGES, EDIT THE SOURCE PYTHON FILE:
+.. "auto_examples/tutorials/run_wmd.py"
+.. LINE NUMBERS ARE GIVEN BELOW.
+
+.. only:: html
+
+    .. note::
+        :class: sphx-glr-download-link-note
+
+        Click :ref:`here <sphx_glr_download_auto_examples_tutorials_run_wmd.py>`
+        to download the full example code
+
 .. rst-class:: sphx-glr-example-title
 
 .. _sphx_glr_auto_examples_tutorials_run_wmd.py:
@@ -12,6 +23,8 @@ Word Mover's Distance
 
 Demonstrates using Gensim's implemenation of the WMD.
 
+.. GENERATED FROM PYTHON SOURCE LINES 10-35
+
 Word Mover's Distance (WMD) is a promising new tool in machine learning that
 allows us to submit a query and return the most relevant documents. This
 tutorial introduces WMD and shows how you can compute the WMD distance
@@ -38,6 +51,7 @@ between documents, in other words the most efficient way to "move" the
 distribution of document 1 to the distribution of document 2.
 
 
+.. GENERATED FROM PYTHON SOURCE LINES 35-44
 
 .. code-block:: default
 
@@ -53,11 +67,16 @@ distribution of document 1 to the distribution of document 2.
 
 
 
-.. image:: /auto_examples/tutorials/images/sphx_glr_run_wmd_001.png
-    :class: sphx-glr-single-img
+.. image-sg:: /auto_examples/tutorials/images/sphx_glr_run_wmd_001.png
+   :alt: run wmd
+   :srcset: /auto_examples/tutorials/images/sphx_glr_run_wmd_001.png
+   :class: sphx-glr-single-img
+
+
 
 
 
+.. GENERATED FROM PYTHON SOURCE LINES 45-68
 
 This method was introduced in the article "From Word Embeddings To Document
 Distances" by Matt Kusner et al. (\ `link to PDF
@@ -70,7 +89,7 @@ consists of the ``wmdistance`` method for distance computation, and the
 ``WmdSimilarity`` class for corpus based similarity queries.
 
 .. Important::
-   If you use Gensim's WMD functionality, please consider citing [1], [2] and [3].
+   If you use Gensim's WMD functionality, please consider citing [1] and [2].
 
 Computing the Word Mover's Distance
 -----------------------------------
@@ -83,6 +102,7 @@ For this tutorial, we'll be using an existing Word2Vec model.
 Let's take some sentences to compute the distance between.
 
 
+.. GENERATED FROM PYTHON SOURCE LINES 68-76
 
 .. code-block:: default
 
@@ -100,11 +120,15 @@ Let's take some sentences to compute the distance between.
 
 
 
+
+.. GENERATED FROM PYTHON SOURCE LINES 77-81
+
 These sentences have very similar content, and as such the WMD should be low.
 Before we compute the WMD, we want to remove stopwords ("the", "to", etc.),
 as these do not contribute a lot to the information in the sentences.
 
 
+.. GENERATED FROM PYTHON SOURCE LINES 81-94
 
 .. code-block:: default
 
@@ -127,45 +151,16 @@ as these do not contribute a lot to the information in the sentences.
 
 .. rst-class:: sphx-glr-script-out
 
- Out:
-
  .. code-block:: none
 
-    /home/witiko/.virtualenvs/gensim4/lib/python3.7/site-packages/sklearn/feature_extraction/image.py:167: DeprecationWarning: `np.int` is a deprecated alias for the builtin `int`. To silence this warning, use `int` by itself. Doing this will not modify any behavior and is safe. When replacing `np.int`, you may wish to use e.g. `np.int64` or `np.int32` to specify the precision. If you wish to review your current use, check the release note link for additional information.
-    Deprecated in NumPy 1.20; for more details and guidance: https://numpy.org/devdocs/release/1.20.0-notes.html#deprecations
-      dtype=np.int):
-    /home/witiko/.virtualenvs/gensim4/lib/python3.7/site-packages/sklearn/linear_model/least_angle.py:30: DeprecationWarning: `np.float` is a deprecated alias for the builtin `float`. To silence this warning, use `float` by itself. Doing this will not modify any behavior and is safe. If you specifically wanted the numpy scalar type, use `np.float64` here.
-    Deprecated in NumPy 1.20; for more details and guidance: https://numpy.org/devdocs/release/1.20.0-notes.html#deprecations
-      method='lar', copy_X=True, eps=np.finfo(np.float).eps,
-    /home/witiko/.virtualenvs/gensim4/lib/python3.7/site-packages/sklearn/linear_model/least_angle.py:167: DeprecationWarning: `np.float` is a deprecated alias for the builtin `float`. To silence this warning, use `float` by itself. Doing this will not modify any behavior and is safe. If you specifically wanted the numpy scalar type, use `np.float64` here.
-    Deprecated in NumPy 1.20; for more details and guidance: https://numpy.org/devdocs/release/1.20.0-notes.html#deprecations
-      method='lar', copy_X=True, eps=np.finfo(np.float).eps,
-    /home/witiko/.virtualenvs/gensim4/lib/python3.7/site-packages/sklearn/linear_model/least_angle.py:284: DeprecationWarning: `np.float` is a deprecated alias for the builtin `float`. To silence this warning, use `float` by itself. Doing this will not modify any behavior and is safe. If you specifically wanted the numpy scalar type, use `np.float64` here.
-    Deprecated in NumPy 1.20; for more details and guidance: https://numpy.org/devdocs/release/1.20.0-notes.html#deprecations
-      eps=np.finfo(np.float).eps, copy_Gram=True, verbose=0,
-    /home/witiko/.virtualenvs/gensim4/lib/python3.7/site-packages/sklearn/linear_model/least_angle.py:862: DeprecationWarning: `np.float` is a deprecated alias for the builtin `float`. To silence this warning, use `float` by itself. Doing this will not modify any behavior and is safe. If you specifically wanted the numpy scalar type, use `np.float64` here.
-    Deprecated in NumPy 1.20; for more details and guidance: https://numpy.org/devdocs/release/1.20.0-notes.html#deprecations
-      eps=np.finfo(np.float).eps, copy_X=True, fit_path=True,
-    /home/witiko/.virtualenvs/gensim4/lib/python3.7/site-packages/sklearn/linear_model/least_angle.py:1101: DeprecationWarning: `np.float` is a deprecated alias for the builtin `float`. To silence this warning, use `float` by itself. Doing this will not modify any behavior and is safe. If you specifically wanted the numpy scalar type, use `np.float64` here.
-    Deprecated in NumPy 1.20; for more details and guidance: https://numpy.org/devdocs/release/1.20.0-notes.html#deprecations
-      eps=np.finfo(np.float).eps, copy_X=True, fit_path=True,
-    /home/witiko/.virtualenvs/gensim4/lib/python3.7/site-packages/sklearn/linear_model/least_angle.py:1127: DeprecationWarning: `np.float` is a deprecated alias for the builtin `float`. To silence this warning, use `float` by itself. Doing this will not modify any behavior and is safe. If you specifically wanted the numpy scalar type, use `np.float64` here.
-    Deprecated in NumPy 1.20; for more details and guidance: https://numpy.org/devdocs/release/1.20.0-notes.html#deprecations
-      eps=np.finfo(np.float).eps, positive=False):
-    /home/witiko/.virtualenvs/gensim4/lib/python3.7/site-packages/sklearn/linear_model/least_angle.py:1362: DeprecationWarning: `np.float` is a deprecated alias for the builtin `float`. To silence this warning, use `float` by itself. Doing this will not modify any behavior and is safe. If you specifically wanted the numpy scalar type, use `np.float64` here.
-    Deprecated in NumPy 1.20; for more details and guidance: https://numpy.org/devdocs/release/1.20.0-notes.html#deprecations
-      max_n_alphas=1000, n_jobs=None, eps=np.finfo(np.float).eps,
-    /home/witiko/.virtualenvs/gensim4/lib/python3.7/site-packages/sklearn/linear_model/least_angle.py:1602: DeprecationWarning: `np.float` is a deprecated alias for the builtin `float`. To silence this warning, use `float` by itself. Doing this will not modify any behavior and is safe. If you specifically wanted the numpy scalar type, use `np.float64` here.
-    Deprecated in NumPy 1.20; for more details and guidance: https://numpy.org/devdocs/release/1.20.0-notes.html#deprecations
-      max_n_alphas=1000, n_jobs=None, eps=np.finfo(np.float).eps,
-    /home/witiko/.virtualenvs/gensim4/lib/python3.7/site-packages/sklearn/linear_model/least_angle.py:1738: DeprecationWarning: `np.float` is a deprecated alias for the builtin `float`. To silence this warning, use `float` by itself. Doing this will not modify any behavior and is safe. If you specifically wanted the numpy scalar type, use `np.float64` here.
-    Deprecated in NumPy 1.20; for more details and guidance: https://numpy.org/devdocs/release/1.20.0-notes.html#deprecations
-      eps=np.finfo(np.float).eps, copy_X=True, positive=False):
-    [nltk_data] Downloading package stopwords to /home/witiko/nltk_data...
+    [nltk_data] Downloading package stopwords to /home/thomas/nltk_data...
     [nltk_data]   Package stopwords is already up-to-date!
 
 
 
+
+.. GENERATED FROM PYTHON SOURCE LINES 95-101
+
 Now, as mentioned earlier, we will be using some downloaded pre-trained
 embeddings. We load these into a Gensim Word2Vec model class.
 
@@ -173,6 +168,7 @@ embeddings. We load these into a Gensim Word2Vec model class.
   The embeddings we have chosen here require a lot of memory.
 
 
+.. GENERATED FROM PYTHON SOURCE LINES 101-104
 
 .. code-block:: default
 
@@ -183,11 +179,22 @@ embeddings. We load these into a Gensim Word2Vec model class.
 
 
 
+.. rst-class:: sphx-glr-script-out
+
+ .. code-block:: none
 
+    2022-10-23 11:18:41,292 : INFO : loading projection weights from /home/thomas/gensim-data/word2vec-google-news-300/word2vec-google-news-300.gz
+    2022-10-23 11:19:12,793 : INFO : KeyedVectors lifecycle event {'msg': 'loaded (3000000, 300) matrix of type float32 from /home/thomas/gensim-data/word2vec-google-news-300/word2vec-google-news-300.gz', 'binary': True, 'encoding': 'utf8', 'datetime': '2022-10-23T11:19:12.755440', 'gensim': '4.2.1.dev0', 'python': '3.10.6 (main, Aug 10 2022, 11:40:04) [GCC 11.3.0]', 'platform': 'Linux-5.19.0-76051900-generic-x86_64-with-glibc2.35', 'event': 'load_word2vec_format'}
+
+
+
+
+.. GENERATED FROM PYTHON SOURCE LINES 105-107
 
 So let's compute WMD using the ``wmdistance`` method.
 
 
+.. GENERATED FROM PYTHON SOURCE LINES 107-110
 
 .. code-block:: default
 
@@ -200,17 +207,22 @@ So let's compute WMD using the ``wmdistance`` method.
 
 .. rst-class:: sphx-glr-script-out
 
- Out:
-
  .. code-block:: none
 
+    2022-10-23 11:19:12,860 : INFO : adding document #0 to Dictionary<0 unique tokens: []>
+    2022-10-23 11:19:12,861 : INFO : built Dictionary<8 unique tokens: ['illinois', 'media', 'obama', 'speaks', 'chicago']...> from 2 documents (total 8 corpus positions)
+    2022-10-23 11:19:12,861 : INFO : Dictionary lifecycle event {'msg': "built Dictionary<8 unique tokens: ['illinois', 'media', 'obama', 'speaks', 'chicago']...> from 2 documents (total 8 corpus positions)", 'datetime': '2022-10-23T11:19:12.861331', 'gensim': '4.2.1.dev0', 'python': '3.10.6 (main, Aug 10 2022, 11:40:04) [GCC 11.3.0]', 'platform': 'Linux-5.19.0-76051900-generic-x86_64-with-glibc2.35', 'event': 'created'}
     distance = 1.0175
 
 
 
+
+.. GENERATED FROM PYTHON SOURCE LINES 111-113
+
 Let's try the same thing with two completely unrelated sentences. Notice that the distance is larger.
 
 
+.. GENERATED FROM PYTHON SOURCE LINES 113-117
 
 .. code-block:: default
 
@@ -224,50 +236,48 @@ Let's try the same thing with two completely unrelated sentences. Notice that th
 
 .. rst-class:: sphx-glr-script-out
 
- Out:
-
  .. code-block:: none
 
-    distance = 1.3663
+    2022-10-23 11:19:15,303 : INFO : adding document #0 to Dictionary<0 unique tokens: []>
+    2022-10-23 11:19:15,304 : INFO : built Dictionary<7 unique tokens: ['illinois', 'media', 'obama', 'speaks', 'favorite']...> from 2 documents (total 7 corpus positions)
+    2022-10-23 11:19:15,304 : INFO : Dictionary lifecycle event {'msg': "built Dictionary<7 unique tokens: ['illinois', 'media', 'obama', 'speaks', 'favorite']...> from 2 documents (total 7 corpus positions)", 'datetime': '2022-10-23T11:19:15.304338', 'gensim': '4.2.1.dev0', 'python': '3.10.6 (main, Aug 10 2022, 11:40:04) [GCC 11.3.0]', 'platform': 'Linux-5.19.0-76051900-generic-x86_64-with-glibc2.35', 'event': 'created'}
+    distance = 1.3664
 
 
 
+
+.. GENERATED FROM PYTHON SOURCE LINES 118-125
+
 References
 ----------
 
-1. Ofir Pele and Michael Werman, *A linear time histogram metric for improved SIFT matching*, 2008.
-2. Ofir Pele and Michael Werman, *Fast and robust earth mover's distances*, 2009.
-3. Matt Kusner et al. *From Embeddings To Document Distances*, 2015.
-4. Tomáš Mikolov et al. *Efficient Estimation of Word Representations in Vector Space*, 2013.
+1. Rémi Flamary et al. *POT: Python Optimal Transport*, 2021.
+2. Matt Kusner et al. *From Embeddings To Document Distances*, 2015.
+3. Tomáš Mikolov et al. *Efficient Estimation of Word Representations in Vector Space*, 2013.
 
 
 
 .. rst-class:: sphx-glr-timing
 
-   **Total running time of the script:** ( 0 minutes  55.983 seconds)
+   **Total running time of the script:** ( 0 minutes  36.418 seconds)
 
-**Estimated memory usage:**  7537 MB
+**Estimated memory usage:**  7551 MB
 
 
 .. _sphx_glr_download_auto_examples_tutorials_run_wmd.py:
 
+.. only:: html
 
-.. only :: html
-
- .. container:: sphx-glr-footer
-    :class: sphx-glr-footer-example
-
-
-
-  .. container:: sphx-glr-download
+  .. container:: sphx-glr-footer sphx-glr-footer-example
 
-     :download:`Download Python source code: run_wmd.py <run_wmd.py>`
 
+    .. container:: sphx-glr-download sphx-glr-download-python
 
+      :download:`Download Python source code: run_wmd.py <run_wmd.py>`
 
-  .. container:: sphx-glr-download
+    .. container:: sphx-glr-download sphx-glr-download-jupyter
 
-     :download:`Download Jupyter notebook: run_wmd.ipynb <run_wmd.ipynb>`
+      :download:`Download Jupyter notebook: run_wmd.ipynb <run_wmd.ipynb>`
 
 
 .. only:: html
diff --git a/docs/src/auto_examples/tutorials/run_wmd_codeobj.pickle b/docs/src/auto_examples/tutorials/run_wmd_codeobj.pickle
new file mode 100644
index 0000000000000000000000000000000000000000..9df7517582979fe33a256db7c95ad592c142ed0c
GIT binary patch
literal 2602
zcmbtWOK;RL5Ju|0y4lipE2vZsa4ZLM;L52gLaL}JYNaA1(8`;*u~jFI;-tGhRO*F8
zQEmhwA#vf#l?(rlvEw|vk9OPcDQnO7eKX_nj4zwtpLQRpUurp=G3>;Y2O>+YgUH1Z
zc3)E`&c0>O53}v`p};|m0|yWI5cw$koL#_bBS1dR(gvd<&eE38-Gssa&M=`Yrjo0d
zuMGs@QJj%(+M#0LFeF5Fm0IwP$04H*jkBu+rCky8a4_PLD{=+W*5qWl#!4*GC%r4O
zqA($gZR&%-2r%2=7Jxb@Nua{XCV`t8nA^295UkdH6o-t*j1KMaTz+N5nz@=Q<Fw;K
z*a&h``r15U906{^*=MD*O-Ki3m7l%0_#C^(ka`{oiQDpUAgFIEJ7J&7?XzOrN>_~S
z%!p-*Yts0Z@K&w`Ss*X85X3CAy=bmq8vZpD>~5Kss%T7QRor;OuS``1yOZjwtVUIg
zc2SaAeCq?0=sukOE|0=Q9AX3)MjL_DlYqsiwxjm!sM=K51d7V4?VD$K1986w)Wot#
z@62Zc??Kd%j>$@SZzR7zJ3o)7!?00ECH`m;{OmN4<3+F&A(M}bfXeVb8P?6bEXZ>D
zs2)*SHZq`rM&NXVanGZHXAhB}&Mps5sJBQxyN0G!M}u-(vq~+m)atl=6hJR>D}k1e
zW5V63=EMy83JBa~*t{feQ{Pj)vAl@OJ7X;NeB@zCy;kd@G+(r4E#^HmZ^9-+w_=bn
zjZ5iXk-xonZw{)smS`~DaW9OZ8VWIytjm&kwVG`a3Lp+O+~$s+FB*u_B}hhT+zwn6
zMd(~+p&2B82wxWYS{kpZmTr&y+SJhPWV1d6>J~tCkAZL<?d@j6bxgG}@x#da#t}Nh
z`%r@u5%u&8OJd4k=2_(DLa>_7FAc!(ya?e8VEoH2Th+w;@&DV<g7L3_w=P^5gwU{T
z^M=h={bQ&$6bv-ibta0-iX%wJ%+=z_(G4RUM%=;hek!VTzU*Hui_(5s;y@s%3y--H
SpTFL~o$A>Jhw`t$CiZ`!Oxq0r

literal 0
HcmV?d00001

diff --git a/docs/src/auto_examples/tutorials/sg_execution_times.rst b/docs/src/auto_examples/tutorials/sg_execution_times.rst
index 0dfaf2783f..0b10d0ae69 100644
--- a/docs/src/auto_examples/tutorials/sg_execution_times.rst
+++ b/docs/src/auto_examples/tutorials/sg_execution_times.rst
@@ -5,22 +5,22 @@
 
 Computation times
 =================
-**04:13.971** total execution time for **auto_examples_tutorials** files:
+**00:36.418** total execution time for **auto_examples_tutorials** files:
 
-+-------------------------------------------------------------------------------------+-----------+----------+
-| :ref:`sphx_glr_auto_examples_tutorials_run_lda.py` (``run_lda.py``)                 | 04:13.971 | 664.3 MB |
-+-------------------------------------------------------------------------------------+-----------+----------+
-| :ref:`sphx_glr_auto_examples_tutorials_run_annoy.py` (``run_annoy.py``)             | 00:00.000 | 0.0 MB   |
-+-------------------------------------------------------------------------------------+-----------+----------+
-| :ref:`sphx_glr_auto_examples_tutorials_run_doc2vec_lee.py` (``run_doc2vec_lee.py``) | 00:00.000 | 0.0 MB   |
-+-------------------------------------------------------------------------------------+-----------+----------+
-| :ref:`sphx_glr_auto_examples_tutorials_run_ensemblelda.py` (``run_ensemblelda.py``) | 00:00.000 | 0.0 MB   |
-+-------------------------------------------------------------------------------------+-----------+----------+
-| :ref:`sphx_glr_auto_examples_tutorials_run_fasttext.py` (``run_fasttext.py``)       | 00:00.000 | 0.0 MB   |
-+-------------------------------------------------------------------------------------+-----------+----------+
-| :ref:`sphx_glr_auto_examples_tutorials_run_scm.py` (``run_scm.py``)                 | 00:00.000 | 0.0 MB   |
-+-------------------------------------------------------------------------------------+-----------+----------+
-| :ref:`sphx_glr_auto_examples_tutorials_run_wmd.py` (``run_wmd.py``)                 | 00:00.000 | 0.0 MB   |
-+-------------------------------------------------------------------------------------+-----------+----------+
-| :ref:`sphx_glr_auto_examples_tutorials_run_word2vec.py` (``run_word2vec.py``)       | 00:00.000 | 0.0 MB   |
-+-------------------------------------------------------------------------------------+-----------+----------+
++-------------------------------------------------------------------------------------+-----------+-----------+
+| :ref:`sphx_glr_auto_examples_tutorials_run_wmd.py` (``run_wmd.py``)                 | 00:36.418 | 7551.3 MB |
++-------------------------------------------------------------------------------------+-----------+-----------+
+| :ref:`sphx_glr_auto_examples_tutorials_run_annoy.py` (``run_annoy.py``)             | 00:00.000 | 0.0 MB    |
++-------------------------------------------------------------------------------------+-----------+-----------+
+| :ref:`sphx_glr_auto_examples_tutorials_run_doc2vec_lee.py` (``run_doc2vec_lee.py``) | 00:00.000 | 0.0 MB    |
++-------------------------------------------------------------------------------------+-----------+-----------+
+| :ref:`sphx_glr_auto_examples_tutorials_run_ensemblelda.py` (``run_ensemblelda.py``) | 00:00.000 | 0.0 MB    |
++-------------------------------------------------------------------------------------+-----------+-----------+
+| :ref:`sphx_glr_auto_examples_tutorials_run_fasttext.py` (``run_fasttext.py``)       | 00:00.000 | 0.0 MB    |
++-------------------------------------------------------------------------------------+-----------+-----------+
+| :ref:`sphx_glr_auto_examples_tutorials_run_lda.py` (``run_lda.py``)                 | 00:00.000 | 0.0 MB    |
++-------------------------------------------------------------------------------------+-----------+-----------+
+| :ref:`sphx_glr_auto_examples_tutorials_run_scm.py` (``run_scm.py``)                 | 00:00.000 | 0.0 MB    |
++-------------------------------------------------------------------------------------+-----------+-----------+
+| :ref:`sphx_glr_auto_examples_tutorials_run_word2vec.py` (``run_word2vec.py``)       | 00:00.000 | 0.0 MB    |
++-------------------------------------------------------------------------------------+-----------+-----------+
diff --git a/docs/src/gallery/tutorials/run_fasttext.py b/docs/src/gallery/tutorials/run_fasttext.py
index 5a03b5d35e..ac3a1bc4c3 100644
--- a/docs/src/gallery/tutorials/run_fasttext.py
+++ b/docs/src/gallery/tutorials/run_fasttext.py
@@ -248,7 +248,7 @@
 # Word Movers distance
 # ^^^^^^^^^^^^^^^^^^^^
 #
-# You'll need the optional ``pyemd`` library for this section, ``pip install pyemd``.
+# You'll need the optional ``POT`` library for this section, ``pip install POT``.
 #
 # Let's start with two sentences:
 sentence_obama = 'Obama speaks to the media in Illinois'.lower().split()
diff --git a/docs/src/gallery/tutorials/run_wmd.py b/docs/src/gallery/tutorials/run_wmd.py
index 06e263063a..c037ef697b 100644
--- a/docs/src/gallery/tutorials/run_wmd.py
+++ b/docs/src/gallery/tutorials/run_wmd.py
@@ -53,7 +53,7 @@
 # ``WmdSimilarity`` class for corpus based similarity queries.
 #
 # .. Important::
-#    If you use Gensim's WMD functionality, please consider citing [1], [2] and [3].
+#    If you use Gensim's WMD functionality, please consider citing [1] and [2].
 #
 # Computing the Word Mover's Distance
 # -----------------------------------
@@ -118,8 +118,7 @@ def preprocess(sentence):
 # References
 # ----------
 #
-# 1. Ofir Pele and Michael Werman, *A linear time histogram metric for improved SIFT matching*, 2008.
-# 2. Ofir Pele and Michael Werman, *Fast and robust earth mover's distances*, 2009.
-# 3. Matt Kusner et al. *From Embeddings To Document Distances*, 2015.
-# 4. Tomáš Mikolov et al. *Efficient Estimation of Word Representations in Vector Space*, 2013.
+# 1. Rémi Flamary et al. *POT: Python Optimal Transport*, 2021.
+# 2. Matt Kusner et al. *From Embeddings To Document Distances*, 2015.
+# 3. Tomáš Mikolov et al. *Efficient Estimation of Word Representations in Vector Space*, 2013.
 #
diff --git a/gensim/models/keyedvectors.py b/gensim/models/keyedvectors.py
index 6b31496bb5..e8045bcd97 100644
--- a/gensim/models/keyedvectors.py
+++ b/gensim/models/keyedvectors.py
@@ -918,10 +918,8 @@ def wmdistance(self, document1, document2, norm=True):
 
         When using this code, please consider citing the following papers:
 
-        * `Ofir Pele and Michael Werman "A linear time histogram metric for improved SIFT matching"
-          <http://www.cs.huji.ac.il/~werman/Papers/ECCV2008.pdf>`_
-        * `Ofir Pele and Michael Werman "Fast and robust earth mover's distances"
-          <https://ieeexplore.ieee.org/document/5459199/>`_
+        * `Rémi Flamary et al. "POT: Python Optimal Transport"
+          <https://jmlr.org/papers/v22/20-451.html>`_
         * `Matt Kusner et al. "From Word Embeddings To Document Distances"
           <http://proceedings.mlr.press/v37/kusnerb15.pdf>`_.
 
@@ -942,7 +940,7 @@ def wmdistance(self, document1, document2, norm=True):
 
         Warnings
         --------
-        This method only works if `pyemd <https://pypi.org/project/pyemd/>`_ is installed.
+        This method only works if `POT <https://pypi.org/project/POT/>`_ is installed.
 
         If one of the documents have no words that exist in the vocab, `float('inf')` (i.e. infinity)
         will be returned.
@@ -950,12 +948,11 @@ def wmdistance(self, document1, document2, norm=True):
         Raises
         ------
         ImportError
-            If `pyemd <https://pypi.org/project/pyemd/>`_  isn't installed.
+            If `POT <https://pypi.org/project/POT/>`_  isn't installed.
 
         """
-        # If pyemd C extension is available, import it.
-        # If pyemd is attempted to be used, but isn't installed, ImportError will be raised in wmdistance
-        from pyemd import emd
+        # If POT is attempted to be used, but isn't installed, ImportError will be raised in wmdistance
+        from ot import emd2
 
         # Remove out-of-vocabulary words.
         len_pre_oov1 = len(document1)
@@ -1002,12 +999,12 @@ def nbow(document):
                 d[idx] = freq / float(doc_len)  # Normalized word frequencies.
             return d
 
-        # Compute nBOW representation of documents. This is what pyemd expects on input.
+        # Compute nBOW representation of documents. This is what POT expects on input.
         d1 = nbow(document1)
         d2 = nbow(document2)
 
         # Compute WMD.
-        return emd(d1, d2, distance_matrix)
+        return emd2(d1, d2, distance_matrix)
 
     def most_similar_cosmul(
             self, positive=None, negative=None, topn=10, restrict_vocab=None
diff --git a/gensim/similarities/docsim.py b/gensim/similarities/docsim.py
index a6d5e21bce..2e46479f87 100644
--- a/gensim/similarities/docsim.py
+++ b/gensim/similarities/docsim.py
@@ -1014,10 +1014,8 @@ class WmdSimilarity(interfaces.SimilarityABC):
 
     When using this code, please consider citing the following papers:
 
-    * `Ofir Pele and Michael Werman, "A linear time histogram metric for improved SIFT matching"
-      <http://www.cs.huji.ac.il/~werman/Papers/ECCV2008.pdf>`_
-    * `Ofir Pele and Michael Werman, "Fast and robust earth mover's distances"
-      <http://www.cs.huji.ac.il/~werman/Papers/ICCV2009.pdf>`_
+    * `Rémi Flamary et al. "POT: Python Optimal Transport"
+      <https://jmlr.org/papers/v22/20-451.html>`_
     * `Matt Kusner et al. "From Word Embeddings To Document Distances"
       <http://proceedings.mlr.press/v37/kusnerb15.pdf>`_
 
diff --git a/gensim/test/test_fasttext.py b/gensim/test/test_fasttext.py
index ecc44a30e4..64bd636b3a 100644
--- a/gensim/test/test_fasttext.py
+++ b/gensim/test/test_fasttext.py
@@ -30,10 +30,10 @@
 import gensim.models.fasttext
 
 try:
-    from pyemd import emd  # noqa:F401
-    PYEMD_EXT = True
+    from ot import emd2  # noqa:F401
+    POT_EXT = True
 except (ImportError, ValueError):
-    PYEMD_EXT = False
+    POT_EXT = False
 
 logger = logging.getLogger(__name__)
 
@@ -394,7 +394,7 @@ def test_contains(self):
         self.assertFalse('nights' in self.test_model.wv.key_to_index)
         self.assertTrue('nights' in self.test_model.wv)
 
-    @unittest.skipIf(PYEMD_EXT is False, "pyemd not installed")
+    @unittest.skipIf(POT_EXT is False, "POT not installed")
     def test_wm_distance(self):
         doc = ['night', 'payment']
         oov_doc = ['nights', 'forests', 'payments']
diff --git a/gensim/test/test_similarities.py b/gensim/test/test_similarities.py
index 0b917980d2..a7fdfdf7bc 100644
--- a/gensim/test/test_similarities.py
+++ b/gensim/test/test_similarities.py
@@ -36,10 +36,10 @@
 from gensim.similarities.fastss import editdist
 
 try:
-    from pyemd import emd  # noqa:F401
-    PYEMD_EXT = True
+    from ot import emd2  # noqa:F401
+    POT_EXT = True
 except (ImportError, ValueError):
-    PYEMD_EXT = False
+    POT_EXT = False
 
 SENTENCES = [doc2vec.TaggedDocument(words, [i]) for i, words in enumerate(TEXTS)]
 
@@ -88,8 +88,8 @@ def test_full(self, num_best=None, shardsize=100):
             index.destroy()
 
     def test_num_best(self):
-        if self.cls == similarities.WmdSimilarity and not PYEMD_EXT:
-            self.skipTest("pyemd not installed")
+        if self.cls == similarities.WmdSimilarity and not POT_EXT:
+            self.skipTest("POT not installed")
 
         for num_best in [None, 0, 1, 9, 1000]:
             self.testFull(num_best=num_best)
@@ -119,8 +119,8 @@ def test_scipy2scipy_clipped(self):
 
     def test_empty_query(self):
         index = self.factoryMethod()
-        if isinstance(index, similarities.WmdSimilarity) and not PYEMD_EXT:
-            self.skipTest("pyemd not installed")
+        if isinstance(index, similarities.WmdSimilarity) and not POT_EXT:
+            self.skipTest("POT not installed")
 
         query = []
         try:
@@ -177,8 +177,8 @@ def test_iter(self):
             index.destroy()
 
     def test_persistency(self):
-        if self.cls == similarities.WmdSimilarity and not PYEMD_EXT:
-            self.skipTest("pyemd not installed")
+        if self.cls == similarities.WmdSimilarity and not POT_EXT:
+            self.skipTest("POT not installed")
 
         fname = get_tmpfile('gensim_similarities.tst.pkl')
         index = self.factoryMethod()
@@ -197,8 +197,8 @@ def test_persistency(self):
             self.assertEqual(index.num_best, index2.num_best)
 
     def test_persistency_compressed(self):
-        if self.cls == similarities.WmdSimilarity and not PYEMD_EXT:
-            self.skipTest("pyemd not installed")
+        if self.cls == similarities.WmdSimilarity and not POT_EXT:
+            self.skipTest("POT not installed")
 
         fname = get_tmpfile('gensim_similarities.tst.pkl.gz')
         index = self.factoryMethod()
@@ -217,8 +217,8 @@ def test_persistency_compressed(self):
             self.assertEqual(index.num_best, index2.num_best)
 
     def test_large(self):
-        if self.cls == similarities.WmdSimilarity and not PYEMD_EXT:
-            self.skipTest("pyemd not installed")
+        if self.cls == similarities.WmdSimilarity and not POT_EXT:
+            self.skipTest("POT not installed")
 
         fname = get_tmpfile('gensim_similarities.tst.pkl')
         index = self.factoryMethod()
@@ -239,8 +239,8 @@ def test_large(self):
             self.assertEqual(index.num_best, index2.num_best)
 
     def test_large_compressed(self):
-        if self.cls == similarities.WmdSimilarity and not PYEMD_EXT:
-            self.skipTest("pyemd not installed")
+        if self.cls == similarities.WmdSimilarity and not POT_EXT:
+            self.skipTest("POT not installed")
 
         fname = get_tmpfile('gensim_similarities.tst.pkl.gz')
         index = self.factoryMethod()
@@ -261,8 +261,8 @@ def test_large_compressed(self):
             self.assertEqual(index.num_best, index2.num_best)
 
     def test_mmap(self):
-        if self.cls == similarities.WmdSimilarity and not PYEMD_EXT:
-            self.skipTest("pyemd not installed")
+        if self.cls == similarities.WmdSimilarity and not POT_EXT:
+            self.skipTest("POT not installed")
 
         fname = get_tmpfile('gensim_similarities.tst.pkl')
         index = self.factoryMethod()
@@ -284,8 +284,8 @@ def test_mmap(self):
             self.assertEqual(index.num_best, index2.num_best)
 
     def test_mmap_compressed(self):
-        if self.cls == similarities.WmdSimilarity and not PYEMD_EXT:
-            self.skipTest("pyemd not installed")
+        if self.cls == similarities.WmdSimilarity and not POT_EXT:
+            self.skipTest("POT not installed")
 
         fname = get_tmpfile('gensim_similarities.tst.pkl.gz')
         index = self.factoryMethod()
@@ -310,7 +310,7 @@ def factoryMethod(self):
         # Override factoryMethod.
         return self.cls(TEXTS, self.w2v_model)
 
-    @unittest.skipIf(PYEMD_EXT is False, "pyemd not installed")
+    @unittest.skipIf(POT_EXT is False, "POT not installed")
     def test_full(self, num_best=None):
         # Override testFull.
 
@@ -329,7 +329,7 @@ def test_full(self, num_best=None):
             self.assertTrue(numpy.alltrue(sims[1:] > 0.0))
             self.assertTrue(numpy.alltrue(sims[1:] < 1.0))
 
-    @unittest.skipIf(PYEMD_EXT is False, "pyemd not installed")
+    @unittest.skipIf(POT_EXT is False, "POT not installed")
     def test_non_increasing(self):
         ''' Check that similarities are non-increasing when `num_best` is not
         `None`.'''
@@ -345,7 +345,7 @@ def test_non_increasing(self):
         cond = sum(numpy.diff(sims2) < 0) == len(sims2) - 1
         self.assertTrue(cond)
 
-    @unittest.skipIf(PYEMD_EXT is False, "pyemd not installed")
+    @unittest.skipIf(POT_EXT is False, "POT not installed")
     def test_chunking(self):
         # Override testChunking.
 
@@ -364,7 +364,7 @@ def test_chunking(self):
                 self.assertTrue(numpy.alltrue(sim > 0.0))
                 self.assertTrue(numpy.alltrue(sim <= 1.0))
 
-    @unittest.skipIf(PYEMD_EXT is False, "pyemd not installed")
+    @unittest.skipIf(POT_EXT is False, "POT not installed")
     def test_iter(self):
         # Override testIter.
 
@@ -373,7 +373,7 @@ def test_iter(self):
             self.assertTrue(numpy.alltrue(sims >= 0.0))
             self.assertTrue(numpy.alltrue(sims <= 1.0))
 
-    @unittest.skipIf(PYEMD_EXT is False, "pyemd not installed")
+    @unittest.skipIf(POT_EXT is False, "POT not installed")
     def test_str(self):
         index = self.cls(TEXTS, self.w2v_model)
         self.assertTrue(str(index))
diff --git a/gensim/test/test_word2vec.py b/gensim/test/test_word2vec.py
index 7e58275208..d1749e4bfa 100644
--- a/gensim/test/test_word2vec.py
+++ b/gensim/test/test_word2vec.py
@@ -21,10 +21,10 @@
 from testfixtures import log_capture
 
 try:
-    from pyemd import emd  # noqa:F401
-    PYEMD_EXT = True
+    from ot import emd2  # noqa:F401
+    POT_EXT = True
 except (ImportError, ValueError):
-    PYEMD_EXT = False
+    POT_EXT = False
 
 from gensim import utils
 from gensim.models import word2vec, keyedvectors
@@ -1084,7 +1084,7 @@ def test_negative_ns_exp(self):
 
 class TestWMD(unittest.TestCase):
 
-    @unittest.skipIf(PYEMD_EXT is False, "pyemd not installed")
+    @unittest.skipIf(POT_EXT is False, "POT not installed")
     def test_nonzero(self):
         '''Test basic functionality with a test sentence.'''
 
@@ -1096,7 +1096,7 @@ def test_nonzero(self):
         # Check that distance is non-zero.
         self.assertFalse(distance == 0.0)
 
-    @unittest.skipIf(PYEMD_EXT is False, "pyemd not installed")
+    @unittest.skipIf(POT_EXT is False, "POT not installed")
     def test_symmetry(self):
         '''Check that distance is symmetric.'''
 
@@ -1107,7 +1107,7 @@ def test_symmetry(self):
         distance2 = model.wv.wmdistance(sentence2, sentence1)
         self.assertTrue(np.allclose(distance1, distance2))
 
-    @unittest.skipIf(PYEMD_EXT is False, "pyemd not installed")
+    @unittest.skipIf(POT_EXT is False, "POT not installed")
     def test_identical_sentences(self):
         '''Check that the distance from a sentence to itself is zero.'''
 
diff --git a/requirements_docs.txt b/requirements_docs.txt
index 3e41db0927..dc8b44b173 100644
--- a/requirements_docs.txt
+++ b/requirements_docs.txt
@@ -5,7 +5,7 @@ memory-profiler==0.55.0
 nltk==3.4.5
 nmslib==2.1.1
 pandas==1.2.3
-pyemd==0.5.1
+POT==0.8.1
 scikit-learn==0.24.1
 sphinx-gallery==0.8.2
 sphinxcontrib-napoleon==0.7
diff --git a/setup.py b/setup.py
index de9e0bfb36..4c87887f3c 100644
--- a/setup.py
+++ b/setup.py
@@ -274,7 +274,7 @@ def run(self):
 
 if not (sys.platform.lower().startswith("win") and sys.version_info[:2] >= (3, 9)):
     core_testenv.extend([
-        'pyemd',
+        'POT',
         'nmslib',
     ])
 

From c93eb0b647ec9de7cfcb43c74c37f295f2944821 Mon Sep 17 00:00:00 2001
From: Tal Ifargan <65530510+TalIfargan@users.noreply.github.com>
Date: Thu, 3 Nov 2022 15:49:57 +0200
Subject: [PATCH 17/34] Fixed bug in loss computation for Word2Vec with
 hierarchical softmax (#3397)

* fixed loss computation for sg, hs

* fixed loss computation for cbow, hs
---
 gensim/models/word2vec_inner.pyx | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/gensim/models/word2vec_inner.pyx b/gensim/models/word2vec_inner.pyx
index ffdc908b5c..3692e3e5b8 100755
--- a/gensim/models/word2vec_inner.pyx
+++ b/gensim/models/word2vec_inner.pyx
@@ -126,7 +126,7 @@ cdef void w2v_fast_sentence_sg_hs(
 
         if _compute_loss == 1:
             sgn = (-1)**word_code[b]  # ch function: 0-> 1, 1 -> -1
-            lprob = -1*sgn*f_dot
+            lprob = sgn*f_dot
             if lprob <= -MAX_EXP or lprob >= MAX_EXP:
                 continue
             lprob = LOG_TABLE[<int>((lprob + MAX_EXP) * (EXP_TABLE_SIZE / MAX_EXP / 2))]
@@ -326,7 +326,7 @@ cdef void w2v_fast_sentence_cbow_hs(
 
         if _compute_loss == 1:
             sgn = (-1)**word_code[b]  # ch function: 0-> 1, 1 -> -1
-            lprob = -1*sgn*f_dot
+            lprob = sgn*f_dot
             if lprob <= -MAX_EXP or lprob >= MAX_EXP:
                 continue
             lprob = LOG_TABLE[<int>((lprob + MAX_EXP) * (EXP_TABLE_SIZE / MAX_EXP / 2))]

From b17e6af9bb40f0bb5dfcf083f6253905336ecbd9 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Viktor=20Martinovi=C4=87?=
 <53435298+martino-vic@users.noreply.github.com>
Date: Sat, 3 Dec 2022 14:49:18 +0100
Subject: [PATCH 18/34] fix deprecation warning from pytest (#3354)

gensim/matutils.py:22: DeprecationWarning: Please use `triu` from the `scipy.linalg` namespace, the `scipy.linalg.special_matrices` namespace is deprecated.
    from scipy.linalg.special_matrices import triu
---
 gensim/matutils.py | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/gensim/matutils.py b/gensim/matutils.py
index 4d4064acc0..fdd1a6b592 100644
--- a/gensim/matutils.py
+++ b/gensim/matutils.py
@@ -17,9 +17,8 @@
 import numpy as np
 import scipy.sparse
 from scipy.stats import entropy
-import scipy.linalg
+from scipy.linalg import get_blas_funcs, triu
 from scipy.linalg.lapack import get_lapack_funcs
-from scipy.linalg.special_matrices import triu
 from scipy.special import psi  # gamma function utils
 
 
@@ -42,7 +41,7 @@ def blas(name, ndarray):
         BLAS function for the needed operation on the given data type.
 
     """
-    return scipy.linalg.get_blas_funcs((name,), (ndarray,))[0]
+    return get_blas_funcs((name,), (ndarray,))[0]
 
 
 def argsort(x, topn=None, reverse=False):

From b6ea788bce74ad958476c2638e2b728641ec19fb Mon Sep 17 00:00:00 2001
From: Paul Wise <pabs3@bonedaddy.net>
Date: Sat, 3 Dec 2022 22:11:22 +0800
Subject: [PATCH 19/34] Switch to Cython language level 3 (#3344)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* Switch to Cython language level 3

Python 2 is not supported by gensim, so
switching to language level 3 should be fine.

Silences a warning from Cython:

FutureWarning: Cython directive 'language_level' not set, using 2 for now (Py2). This will change in a later release!

* fix cythonization with language_level=3

Co-authored-by: Radim Řehůřek <radimrehurek@seznam.cz>
---
 gensim/_matutils.pyx                  |  1 +
 gensim/corpora/_mmreader.pyx          |  1 +
 gensim/models/doc2vec_corpusfile.pyx  |  1 +
 gensim/models/doc2vec_inner.pxd       |  3 ++-
 gensim/models/doc2vec_inner.pyx       |  3 ++-
 gensim/models/fasttext_corpusfile.pyx |  1 +
 gensim/models/fasttext_inner.pxd      |  3 ++-
 gensim/models/fasttext_inner.pyx      |  3 ++-
 gensim/models/nmf_pgd.pyx             |  1 +
 gensim/models/word2vec_corpusfile.pxd |  1 +
 gensim/models/word2vec_corpusfile.pyx |  1 +
 gensim/models/word2vec_inner.pxd      |  1 +
 gensim/models/word2vec_inner.pyx      |  8 ++-----
 setup.py                              | 33 ++++++++++++++-------------
 14 files changed, 35 insertions(+), 26 deletions(-)

diff --git a/gensim/_matutils.pyx b/gensim/_matutils.pyx
index 6c79020832..0162202224 100644
--- a/gensim/_matutils.pyx
+++ b/gensim/_matutils.pyx
@@ -1,6 +1,7 @@
 #!/usr/bin/env cython
 # coding: utf-8
 # cython: embedsignature=True
+# cython: language_level=3
 
 from __future__ import division
 cimport cython
diff --git a/gensim/corpora/_mmreader.pyx b/gensim/corpora/_mmreader.pyx
index 3c32797de8..16edc070c8 100644
--- a/gensim/corpora/_mmreader.pyx
+++ b/gensim/corpora/_mmreader.pyx
@@ -1,5 +1,6 @@
 # Copyright (C) 2018 Radim Rehurek <radimrehurek@seznam.cz>
 # cython: embedsignature=True
+# cython: language_level=3
 
 """Reader for corpus in the Matrix Market format."""
 import logging
diff --git a/gensim/models/doc2vec_corpusfile.pyx b/gensim/models/doc2vec_corpusfile.pyx
index 9216d13bd4..50a07fc3ab 100644
--- a/gensim/models/doc2vec_corpusfile.pyx
+++ b/gensim/models/doc2vec_corpusfile.pyx
@@ -1,4 +1,5 @@
 #!/usr/bin/env cython
+# cython: language_level=3
 # cython: boundscheck=False
 # cython: wraparound=False
 # cython: cdivision=True
diff --git a/gensim/models/doc2vec_inner.pxd b/gensim/models/doc2vec_inner.pxd
index 77da86f449..41635b47a0 100644
--- a/gensim/models/doc2vec_inner.pxd
+++ b/gensim/models/doc2vec_inner.pxd
@@ -1,5 +1,6 @@
 #!/usr/bin/env cython
 # distutils: language = c++
+# cython: language_level=3
 # cython: boundscheck=False
 # cython: wraparound=False
 # cython: cdivision=True
@@ -15,7 +16,7 @@
 import numpy as np
 cimport numpy as np
 
-from word2vec_inner cimport REAL_t
+from gensim.models.word2vec_inner cimport REAL_t
 
 DEF MAX_DOCUMENT_LEN = 10000
 
diff --git a/gensim/models/doc2vec_inner.pyx b/gensim/models/doc2vec_inner.pyx
index 1657c59787..804a3ac28d 100644
--- a/gensim/models/doc2vec_inner.pyx
+++ b/gensim/models/doc2vec_inner.pyx
@@ -1,4 +1,5 @@
 #!/usr/bin/env cython
+# cython: language_level=3
 # cython: boundscheck=False
 # cython: wraparound=False
 # cython: cdivision=True
@@ -24,7 +25,7 @@ except ImportError:
     # in scipy > 0.15, fblas function has been removed
     import scipy.linalg.blas as fblas
 
-from word2vec_inner cimport bisect_left, random_int32, sscal, REAL_t, EXP_TABLE, our_dot, our_saxpy
+from gensim.models.word2vec_inner cimport bisect_left, random_int32, sscal, REAL_t, EXP_TABLE, our_dot, our_saxpy
 
 DEF MAX_DOCUMENT_LEN = 10000
 
diff --git a/gensim/models/fasttext_corpusfile.pyx b/gensim/models/fasttext_corpusfile.pyx
index 5d275b42b6..2b5344e2d5 100644
--- a/gensim/models/fasttext_corpusfile.pyx
+++ b/gensim/models/fasttext_corpusfile.pyx
@@ -1,5 +1,6 @@
 #!/usr/bin/env cython
 # distutils: language = c++
+# cython: language_level=3
 # cython: boundscheck=False
 # cython: wraparound=False
 # cython: cdivision=True
diff --git a/gensim/models/fasttext_inner.pxd b/gensim/models/fasttext_inner.pxd
index 31a1b1d35f..af7a531116 100644
--- a/gensim/models/fasttext_inner.pxd
+++ b/gensim/models/fasttext_inner.pxd
@@ -1,4 +1,5 @@
 #!/usr/bin/env cython
+# cython: language_level=3
 # cython: boundscheck=False
 # cython: wraparound=False
 # cython: cdivision=True
@@ -13,7 +14,7 @@
 import numpy as np
 cimport numpy as np
 
-from word2vec_inner cimport REAL_t
+from gensim.models.word2vec_inner cimport REAL_t
 
 
 DEF MAX_SENTENCE_LEN = 10000
diff --git a/gensim/models/fasttext_inner.pyx b/gensim/models/fasttext_inner.pyx
index e27bd62feb..6e246b3579 100644
--- a/gensim/models/fasttext_inner.pyx
+++ b/gensim/models/fasttext_inner.pyx
@@ -1,4 +1,5 @@
 #!/usr/bin/env cython
+# cython: language_level=3
 # cython: boundscheck=False
 # cython: wraparound=False
 # cython: cdivision=True
@@ -55,7 +56,7 @@ from libc.string cimport memset
 #
 # The versions are as chosen in word2vec_inner.pyx, and aliased to `our_` functions
 
-from word2vec_inner cimport bisect_left, random_int32, scopy, sscal, \
+from gensim.models.word2vec_inner cimport bisect_left, random_int32, scopy, sscal, \
      REAL_t, our_dot, our_saxpy
 
 DEF MAX_SENTENCE_LEN = 10000
diff --git a/gensim/models/nmf_pgd.pyx b/gensim/models/nmf_pgd.pyx
index dff480cdb4..2419272e5b 100644
--- a/gensim/models/nmf_pgd.pyx
+++ b/gensim/models/nmf_pgd.pyx
@@ -1,5 +1,6 @@
 # Author: Timofey Yefimov
 
+# cython: language_level=3
 # cython: cdivision=True
 # cython: boundscheck=False
 # cython: wraparound=False
diff --git a/gensim/models/word2vec_corpusfile.pxd b/gensim/models/word2vec_corpusfile.pxd
index 7030686916..56e8cb64ee 100644
--- a/gensim/models/word2vec_corpusfile.pxd
+++ b/gensim/models/word2vec_corpusfile.pxd
@@ -1,4 +1,5 @@
 # distutils: language = c++
+# cython: language_level=3
 # cython: boundscheck=False
 # cython: wraparound=False
 # cython: cdivision=True
diff --git a/gensim/models/word2vec_corpusfile.pyx b/gensim/models/word2vec_corpusfile.pyx
index 5d7f5004e4..a2b962aed6 100644
--- a/gensim/models/word2vec_corpusfile.pyx
+++ b/gensim/models/word2vec_corpusfile.pyx
@@ -1,5 +1,6 @@
 #!/usr/bin/env cython
 # distutils: language = c++
+# cython: language_level=3
 # cython: boundscheck=False
 # cython: wraparound=False
 # cython: cdivision=True
diff --git a/gensim/models/word2vec_inner.pxd b/gensim/models/word2vec_inner.pxd
index 82abad2f05..4b4523dc55 100644
--- a/gensim/models/word2vec_inner.pxd
+++ b/gensim/models/word2vec_inner.pxd
@@ -1,3 +1,4 @@
+# cython: language_level=3
 # cython: boundscheck=False
 # cython: wraparound=False
 # cython: cdivision=True
diff --git a/gensim/models/word2vec_inner.pyx b/gensim/models/word2vec_inner.pyx
index 3692e3e5b8..1c0807ee0f 100755
--- a/gensim/models/word2vec_inner.pyx
+++ b/gensim/models/word2vec_inner.pyx
@@ -1,4 +1,5 @@
 #!/usr/bin/env cython
+# cython: language_level=3
 # cython: boundscheck=False
 # cython: wraparound=False
 # cython: cdivision=True
@@ -19,12 +20,7 @@ from libc.math cimport exp
 from libc.math cimport log
 from libc.string cimport memset
 
-# scipy <= 0.15
-try:
-    from scipy.linalg.blas import fblas
-except ImportError:
-    # in scipy > 0.15, fblas function has been removed
-    import scipy.linalg.blas as fblas
+import scipy.linalg.blas as fblas
 
 REAL = np.float32
 
diff --git a/setup.py b/setup.py
index 4c87887f3c..6d35665dc8 100644
--- a/setup.py
+++ b/setup.py
@@ -15,25 +15,26 @@
 import platform
 import shutil
 import sys
+from collections import OrderedDict
 
 from setuptools import Extension, find_packages, setup, distutils
 from setuptools.command.build_ext import build_ext
 
-c_extensions = {
-    'gensim.models.word2vec_inner': 'gensim/models/word2vec_inner.c',
-    'gensim.corpora._mmreader': 'gensim/corpora/_mmreader.c',
-    'gensim.models.fasttext_inner': 'gensim/models/fasttext_inner.c',
-    'gensim._matutils': 'gensim/_matutils.c',
-    'gensim.models.nmf_pgd': 'gensim/models/nmf_pgd.c',
-    'gensim.similarities.fastss': 'gensim/similarities/fastss.c',
-}
+c_extensions = OrderedDict([
+    ('gensim.models.word2vec_inner', 'gensim/models/word2vec_inner.c'),
+    ('gensim.corpora._mmreader', 'gensim/corpora/_mmreader.c'),
+    ('gensim.models.fasttext_inner', 'gensim/models/fasttext_inner.c'),
+    ('gensim._matutils', 'gensim/_matutils.c'),
+    ('gensim.models.nmf_pgd', 'gensim/models/nmf_pgd.c'),
+    ('gensim.similarities.fastss', 'gensim/similarities/fastss.c'),
+])
 
-cpp_extensions = {
-    'gensim.models.doc2vec_inner': 'gensim/models/doc2vec_inner.cpp',
-    'gensim.models.word2vec_corpusfile': 'gensim/models/word2vec_corpusfile.cpp',
-    'gensim.models.fasttext_corpusfile': 'gensim/models/fasttext_corpusfile.cpp',
-    'gensim.models.doc2vec_corpusfile': 'gensim/models/doc2vec_corpusfile.cpp',
-}
+cpp_extensions = OrderedDict([
+    ('gensim.models.doc2vec_inner', 'gensim/models/doc2vec_inner.cpp'),
+    ('gensim.models.word2vec_corpusfile', 'gensim/models/word2vec_corpusfile.cpp'),
+    ('gensim.models.fasttext_corpusfile', 'gensim/models/fasttext_corpusfile.cpp'),
+    ('gensim.models.doc2vec_corpusfile', 'gensim/models/doc2vec_corpusfile.cpp'),
+])
 
 
 def need_cython():
@@ -111,8 +112,8 @@ def finalize_options(self):
 
         if need_cython():
             import Cython.Build
-            Cython.Build.cythonize(list(make_c_ext(use_cython=True)))
-            Cython.Build.cythonize(list(make_cpp_ext(use_cython=True)))
+            Cython.Build.cythonize(list(make_c_ext(use_cython=True)), language_level=3)
+            Cython.Build.cythonize(list(make_cpp_ext(use_cython=True)), language_level=3)
 
 
 class CleanExt(distutils.cmd.Command):

From 3331b824d2e3f7a65f5df7903382a0c0a30dcc61 Mon Sep 17 00:00:00 2001
From: Jayme Gordon <jayme_gordon@icloud.com>
Date: Sat, 3 Dec 2022 08:34:57 -0700
Subject: [PATCH 20/34] Implement numpy hack in setup.py to enable install
 under Poetry (#3363)

* Closes #3362: Install issue poetry

* get rid of redundant exception handling

this code can never raise an exception, so we shouldn't be expecting
them

Co-authored-by: Michael Penkov <m@penkov.dev>
---
 setup.py | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/setup.py b/setup.py
index 6d35665dc8..aeef499c8f 100644
--- a/setup.py
+++ b/setup.py
@@ -99,13 +99,14 @@ class CustomBuildExt(build_ext):
     importing them at module level, because they may not be available yet.
     """
     #
+    # Prevent numpy from thinking it is still in its setup process
     # http://stackoverflow.com/questions/19919905/how-to-bootstrap-numpy-installation-in-setup-py
     #
     def finalize_options(self):
         build_ext.finalize_options(self)
-        # Prevent numpy from thinking it is still in its setup process:
-        # https://docs.python.org/2/library/__builtin__.html#module-__builtin__
-        __builtins__.__NUMPY_SETUP__ = False
+
+        import builtins
+        builtins.__NUMPY_SETUP__ = False
 
         import numpy
         self.include_dirs.append(numpy.get_include())

From cc70a6c31d6f01b9293999607129d349ed45a6b3 Mon Sep 17 00:00:00 2001
From: Aswin Shailajan <72661784+aswin2108@users.noreply.github.com>
Date: Tue, 6 Dec 2022 05:37:26 +0530
Subject: [PATCH 21/34] Fixed the broken link in readme.md (#3409)

---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index f1cb9f3ddd..b4bd542f65 100644
--- a/README.md
+++ b/README.md
@@ -132,7 +132,7 @@ Adopters
 | [Tailwind](https://www.tailwindapp.com/) | ![tailwind](docs/src/readme_images/tailwind.png) | Media | Post interesting and relevant content to Pinterest. |
 | [Issuu](https://issuu.com/) | ![issuu](docs/src/readme_images/issuu.png) | Media | Gensim's LDA module lies at the very core of the analysis we perform on each uploaded publication to figure out what it's all about. |
 | [Search Metrics](http://www.searchmetrics.com/) | ![search-metrics](docs/src/readme_images/search-metrics.png) | Content Marketing | Gensim word2vec used for entity disambiguation in Search Engine Optimisation. |
-| [12K Research](https://12k.co/) | ![12k](docs/src/readme_images/12k.png)| Media |   Document similarity analysis on media articles. |
+| [12K Research](https://12k.com/) | ![12k](docs/src/readme_images/12k.png)| Media |   Document similarity analysis on media articles. |
 | [Stillwater Supercomputing](http://www.stillwater-sc.com/) | ![stillwater](docs/src/readme_images/stillwater.png) | Hardware | Document comprehension and association with word2vec. |
 | [SiteGround](https://www.siteground.com/) |  ![siteground](docs/src/readme_images/siteground.png) | Web hosting | An ensemble search engine which uses different embeddings models and similarities, including word2vec, WMD, and LDA. |
 | [Capital One](https://www.capitalone.com/) | ![capitalone](docs/src/readme_images/capitalone.png) | Finance | Topic modeling for customer complaints exploration. |

From 3f536fbc394bab8345ca72ac57a9c4a5614eb71a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Primo=C5=BE=20Godec?= <p.godec9@gmail.com>
Date: Tue, 6 Dec 2022 08:38:16 +0100
Subject: [PATCH 22/34] Coherence Model - work on documents without tokens
 (#3406)

---
 gensim/test/test_coherencemodel.py      | 6 ++++++
 gensim/topic_coherence/text_analysis.py | 3 ++-
 2 files changed, 8 insertions(+), 1 deletion(-)

diff --git a/gensim/test/test_coherencemodel.py b/gensim/test/test_coherencemodel.py
index 2b111f7306..9927851a93 100644
--- a/gensim/test/test_coherencemodel.py
+++ b/gensim/test/test_coherencemodel.py
@@ -305,6 +305,12 @@ def testCompareCoherenceForModels(self):
         self.assertAlmostEqual(np.mean(coherence_topics2), coherence2, 4)
         self.assertAlmostEqual(coherence1, coherence2, places=4)
 
+    def testEmptyList(self):
+        """Test if CoherenceModel works with document without tokens"""
+        texts = self.texts + [[]]
+        cm = CoherenceModel(model=self.ldamodel, texts=texts, coherence="c_v", processes=1)
+        cm.get_coherence()
+
 
 if __name__ == '__main__':
     logging.basicConfig(format='%(asctime)s : %(levelname)s : %(message)s', level=logging.DEBUG)
diff --git a/gensim/topic_coherence/text_analysis.py b/gensim/topic_coherence/text_analysis.py
index 2c06185a0b..58bdc2c35f 100644
--- a/gensim/topic_coherence/text_analysis.py
+++ b/gensim/topic_coherence/text_analysis.py
@@ -293,7 +293,8 @@ def accumulate(self, texts, window_size):
             relevant_texts, window_size, ignore_below_size=False, include_doc_num=True)
 
         for doc_num, virtual_document in windows:
-            self.analyze_text(virtual_document, doc_num)
+            if len(virtual_document) > 0:
+                self.analyze_text(virtual_document, doc_num)
             self.num_docs += 1
         return self
 

From a9b9714294ba61486849af940ea7b3465d66d0cc Mon Sep 17 00:00:00 2001
From: "Samsul Rahmadani (munggok)" <56231298+acul3@users.noreply.github.com>
Date: Tue, 6 Dec 2022 20:24:42 +0800
Subject: [PATCH 23/34] Add support for Python 3.11 and drop support for Python
 3.7 (#3402)

* add support for python 3.11

* change to oldest version numpy and scipy that support 3.11

* add build for python3.11

* disable nmslib test for python 3.11

* fix formatting

* fix formatting

* change build for 3.8

* drop Py3.7 support and builds

Co-authored-by: Michael Penkov <m@penkov.dev>
---
 .github/workflows/build-wheels.yml | 48 ++++++++++++++----------------
 .github/workflows/tests.yml        | 21 +++++--------
 .gitmodules                        |  2 +-
 .travis.yml                        | 12 +++++---
 multibuild                         |  2 +-
 setup.py                           | 16 +++++-----
 6 files changed, 49 insertions(+), 52 deletions(-)

diff --git a/.github/workflows/build-wheels.yml b/.github/workflows/build-wheels.yml
index a9f0fd7ef2..cf8016e9ab 100644
--- a/.github/workflows/build-wheels.yml
+++ b/.github/workflows/build-wheels.yml
@@ -15,10 +15,10 @@ jobs:
   linters:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v2
+      - uses: actions/checkout@v3
 
       - name: Setup up Python ${{ matrix.python }}
-        uses: actions/setup-python@v2
+        uses: actions/setup-python@v4
         with:
           python-version: ${{ matrix.python }}
 
@@ -48,7 +48,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        python-version: ['3.7', '3.8', '3.9', '3.10']
+        python-version: ['3.8', '3.9', '3.10', '3.11']
         os: [ubuntu-latest, macos-latest, windows-latest]
         platform: [x64]
         include:
@@ -74,11 +74,6 @@ jobs:
         # https://github.com/scipy/oldest-supported-numpy/blob/master/setup.cfg
         # with the exception that we enforce the minimum version to be 1.17.0.
         #
-        - os: ubuntu-latest
-          manylinux-version: 2010
-          python-version: 3.7
-          build-depends: numpy==1.17.0
-
         - os: ubuntu-latest
           manylinux-version: 2010
           python-version: 3.8
@@ -93,12 +88,11 @@ jobs:
           manylinux-version: 2014
           python-version: "3.10"
           build-depends: numpy==1.22.2 scipy==1.8.0
-
-        - os: macos-latest
-          travis-os-name: osx
-          manylinux-version: 1
-          python-version: 3.7
-          build-depends: numpy==1.17.0
+        
+        - os: ubuntu-latest
+          manylinux-version: 2014
+          python-version: "3.11"
+          build-depends: numpy==1.23.2 scipy==1.9.2
 
         - os: macos-latest
           travis-os-name: osx
@@ -117,11 +111,12 @@ jobs:
           manylinux-version: 1
           python-version: "3.10"
           build-depends: numpy==1.22.2 scipy==1.8.0
-
-        - os: windows-latest
-          manylinux-version: 2010
-          python-version: 3.7
-          build-depends: numpy==1.17.0
+        
+        - os: macos-latest
+          travis-os-name: osx
+          manylinux-version: 1
+          python-version: "3.11"
+          build-depends: numpy==1.23.2 scipy==1.9.2
 
         - os: windows-latest
           manylinux-version: 2010
@@ -137,6 +132,11 @@ jobs:
           manylinux-version: 2010
           python-version: "3.10"
           build-depends: numpy==1.22.2 scipy==1.8.0
+        
+        - os: windows-latest
+          manylinux-version: 2010
+          python-version: "3.11"
+          build-depends: numpy==1.23.2 scipy==1.9.2
 
     env:
       PKG_NAME: gensim
@@ -155,7 +155,7 @@ jobs:
       BUILD_DEPENDS: ${{ matrix.build-depends }}
 
     steps:
-    - uses: actions/checkout@v2
+    - uses: actions/checkout@v3
       with:
         submodules: recursive
         fetch-depth: 0
@@ -168,7 +168,7 @@ jobs:
         echo "TRAVIS_OS_NAME: ${TRAVIS_OS_NAME}"
         echo "SKIP_NETWORK_TESTS: ${SKIP_NETWORK_TESTS}"
     - name: Set up Python ${{ matrix.python-version }}
-      uses: actions/setup-python@v2
+      uses: actions/setup-python@v4
       with:
         python-version: ${{ matrix.python-version }}
     - name: Install dependencies
@@ -202,19 +202,15 @@ jobs:
         echo ::group::Set up dependencies
         python --version
         python -c "import struct; print(struct.calcsize('P') * 8)"
-
         python -m pip install -U pip setuptools wheel wheelhouse_uploader ${{ env.BUILD_DEPENDS }}
         echo ::endgroup::
-
         echo ::group::Build wheel
         python setup.py bdist_wheel
         echo ::endgroup
-
         echo ::group::Install run
         ls dist
         python continuous_integration/install_wheel.py
         echo ::endgroup::
-
         #
         # For consistency with the multibuild step.
         #
@@ -240,6 +236,7 @@ jobs:
       if: matrix.os != 'windows-latest'
       run: |
         . test_environment/bin/activate
+        python -m pip install --upgrade pip
         pip install pytest testfixtures mock
         pip install wheelhouse/*.whl
         cd test_environment
@@ -258,6 +255,7 @@ jobs:
       if: matrix.os == 'windows-latest'
       run: |
         test_environment/Scripts/activate.bat
+        python -m pip install --upgrade pip
         pip install pytest testfixtures mock
         pip install wheelhouse/*.whl
         cd test_environment
diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml
index 3cb54fe8be..9d52759538 100644
--- a/.github/workflows/tests.yml
+++ b/.github/workflows/tests.yml
@@ -9,10 +9,10 @@ jobs:
   linters:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v2
+      - uses: actions/checkout@v3
 
       - name: Setup up Python ${{ matrix.python }}
-        uses: actions/setup-python@v2
+        uses: actions/setup-python@v4
         with:
           python-version: ${{ matrix.python }}
 
@@ -47,9 +47,9 @@ jobs:
     needs: [linters]
 
     steps:
-      - uses: actions/checkout@v2
+      - uses: actions/checkout@v3
       - name: Setup up Python ${{ matrix.python }}
-        uses: actions/setup-python@v2
+        uses: actions/setup-python@v4
         with:
           #
           # We use Py3.8 here for historical reasons.
@@ -65,7 +65,6 @@ jobs:
           sudo apt-get -yq remove texlive-binaries --purge
           sudo apt-get -yq --no-install-suggests --no-install-recommends --force-yes install dvipng texlive-latex-base texlive-latex-extra texlive-latex-recommended texlive-latex-extra texlive-fonts-recommended latexmk
           sudo apt-get -yq install build-essential python3.8-dev
-
       - name: Install gensim and its dependencies
         run: pip install -e .[docs]
 
@@ -73,7 +72,6 @@ jobs:
         run: |
           python setup.py build_ext --inplace
           make -C docs/src clean html
-
       #
       # FIXME: do we want to store the built documentation somewhere, or is
       # knowing that the docs built successfully enough?
@@ -90,15 +88,15 @@ jobs:
       fail-fast: false
       matrix:
         include:
-          - {python: 3.7, os: ubuntu-20.04}
           - {python: 3.8, os: ubuntu-20.04}
           - {python: 3.9, os: ubuntu-20.04}
           - {python: '3.10', os: ubuntu-20.04}
+          - {python: '3.11', os: ubuntu-20.04}
 
-          - {python: 3.7, os: windows-2019}
           - {python: 3.8, os: windows-2019}
           - {python: 3.9, os: windows-2019}
           - {python: '3.10', os: windows-2019}
+          - {python: '3.11', os: windows-2019}
 
     #
     # Don't run this job unless the linters have succeeded.
@@ -108,9 +106,9 @@ jobs:
     needs: [linters]
 
     steps:
-      - uses: actions/checkout@v2
+      - uses: actions/checkout@v3
       - name: Setup up Python ${{ matrix.python }}
-        uses: actions/setup-python@v2
+        uses: actions/setup-python@v4
         with:
           python-version: ${{ matrix.python }}
       - name: Update pip
@@ -129,14 +127,12 @@ jobs:
           curl -sL "https://keyserver.ubuntu.com/pks/lookup?op=get&search=0x2EE0EA64E40A89B84B2DF73499E82A75642AC823" | sudo apt-key add
           sudo apt-get update -y
           sudo apt-get install -y sbt
-
       - name: Install GDB & enable core dumps
         if: matrix.os == 'ubuntu-20.04'
         run: |
           sudo apt-get update -y
           sudo apt-get install -y gdb
           ulimit -c unlimited -S  # enable core dumps
-
       - name: Install gensim and its dependencies
         if: matrix.os != 'windows'
         run: pip install -e .[test]
@@ -150,7 +146,6 @@ jobs:
           python --version
           pip --version
           python setup.py build_ext --inplace
-
       #
       # Some of our tests are hanging, and I strongly suspect it's because of the coverage plugin.
       #
diff --git a/.gitmodules b/.gitmodules
index 347fe93043..52a1b1716c 100644
--- a/.gitmodules
+++ b/.gitmodules
@@ -1,3 +1,3 @@
 [submodule "multibuild"]
 	path = multibuild
-	url = https://github.com/matthew-brett/multibuild.git
+	url = https://github.com/multi-build/multibuild
diff --git a/.travis.yml b/.travis.yml
index d27d176f58..8937c0c74c 100644
--- a/.travis.yml
+++ b/.travis.yml
@@ -33,10 +33,6 @@ matrix:
       # See .github/workflows/build-wheels.yml for a discussion of why we
       # handle numpy versions explicitly.
       #
-    - os: linux
-      env:
-        - MB_PYTHON_VERSION=3.7
-        - BUILD_DEPENDS="numpy==1.19.2 scipy==1.7.0"
     - os: linux
       env:
         - MB_PYTHON_VERSION=3.8
@@ -50,6 +46,14 @@ matrix:
         # this numpy release are available via PyPI.
         #
         - BUILD_DEPENDS="numpy==1.19.3 scipy==1.7.0"
+    - os: linux
+      env:
+        - MB_PYTHON_VERSION=3.10
+        - BUILD_DEPENDS="numpy==1.19.3 scipy==1.7.0"
+    - os: linux
+      env:
+        - MB_PYTHON_VERSION=3.11
+        - BUILD_DEPENDS="numpy==1.19.3 scipy==1.7.0"
 
 before_install:
     - source multibuild/common_utils.sh
diff --git a/multibuild b/multibuild
index 4e30a05764..d4b02ce8c7 160000
--- a/multibuild
+++ b/multibuild
@@ -1 +1 @@
-Subproject commit 4e30a057646d9e70d5e6e7c354e85cfb740d2ca1
+Subproject commit d4b02ce8c707c8a2bcc721e29f2385149f994b1f
diff --git a/setup.py b/setup.py
index aeef499c8f..485cf08294 100644
--- a/setup.py
+++ b/setup.py
@@ -274,7 +274,7 @@ def run(self):
     'testfixtures',
 ]
 
-if not (sys.platform.lower().startswith("win") and sys.version_info[:2] >= (3, 9)):
+if not sys.platform.lower().startswith("win") and sys.version_info[:2] < (3, 11):
     core_testenv.extend([
         'POT',
         'nmslib',
@@ -282,7 +282,6 @@ def run(self):
 
 # Add additional requirements for testing on Linux that are skipped on Windows.
 linux_testenv = core_testenv[:] + visdom_req
-
 # Skip problematic/uninstallable  packages (& thus related conditional tests) in Windows builds.
 # We still test them in Linux via Travis, see linux_testenv above.
 # See https://github.com/RaRe-Technologies/gensim/pull/2814
@@ -320,20 +319,20 @@ def run(self):
     'pandas',
 ]
 
-NUMPY_STR = 'numpy >= 1.17.0'
+NUMPY_STR = 'numpy >= 1.18.5'
 #
 # We pin the Cython version for reproducibility.  We expect our extensions
 # to build with any sane version of Cython, so we should update this pin
 # periodically.
 #
-CYTHON_STR = 'Cython==0.29.28'
+CYTHON_STR = 'Cython==0.29.32'
 
 # Allow overriding the Cython version requirement
 CYTHON_STR = os.environ.get('GENSIM_CYTHON_REQUIRES', CYTHON_STR)
 
 install_requires = [
     NUMPY_STR,
-    'scipy >= 0.18.1',
+    'scipy >= 1.7.0',
     'smart_open >= 1.8.1',
 ]
 
@@ -378,9 +377,10 @@ def run(self):
         'Environment :: Console',
         'Intended Audience :: Science/Research',
         'Operating System :: OS Independent',
-        'Programming Language :: Python :: 3.6',
-        'Programming Language :: Python :: 3.7',
         'Programming Language :: Python :: 3.8',
+        'Programming Language :: Python :: 3.9',
+        'Programming Language :: Python :: 3.10',
+        'Programming Language :: Python :: 3.11',
         'Programming Language :: Python :: 3 :: Only',
         'Topic :: Scientific/Engineering :: Artificial Intelligence',
         'Topic :: Scientific/Engineering :: Information Analysis',
@@ -388,7 +388,7 @@ def run(self):
     ],
 
     test_suite="gensim.test",
-    python_requires='>=3.6',
+    python_requires='>=3.8',
     setup_requires=setup_requires,
     install_requires=install_requires,
     tests_require=linux_testenv,

From 985a3bd06e68ed649016c791df2763f5c5a62ad1 Mon Sep 17 00:00:00 2001
From: Michael Penkov <m@penkov.dev>
Date: Tue, 6 Dec 2022 23:13:29 +0900
Subject: [PATCH 24/34] fix pip invokation

Seems to consistently fail for MacOS Py3.11
---
 .github/workflows/build-wheels.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/build-wheels.yml b/.github/workflows/build-wheels.yml
index cf8016e9ab..cd0548fe83 100644
--- a/.github/workflows/build-wheels.yml
+++ b/.github/workflows/build-wheels.yml
@@ -274,6 +274,6 @@ jobs:
       #
       if: ${{ always() && env.WHEELHOUSE_UPLOADER_USERNAME && env.WHEELHOUSE_UPLOADER_SECRET }}
       run: |
-        pip install wheelhouse-uploader
+        python -m pip install wheelhouse-uploader
         ls wheelhouse/*.whl
         python -m wheelhouse_uploader upload --local-folder wheelhouse/ --no-ssl-check gensim-wheels --provider S3 --no-enable-cdn

From 68fdbf9cd66895e200f618b3bd2a6629608971df Mon Sep 17 00:00:00 2001
From: Gordon Mohr <gojogit@gmail.com>
Date: Tue, 6 Dec 2022 22:50:22 -0400
Subject: [PATCH 25/34] clarify runtime expectations (#3381)

* clarify runtime expectations

* update doc files made stale by this PR

Co-authored-by: Michael Penkov <m@penkov.dev>
---
 .../tutorials/run_doc2vec_lee.ipynb           |  18 +-
 .../tutorials/run_doc2vec_lee.py              |  12 +-
 .../tutorials/run_doc2vec_lee.py.md5          |   2 +-
 .../tutorials/run_doc2vec_lee.rst             | 398 +++++++-----------
 .../tutorials/sg_execution_times.rst          |  35 +-
 docs/src/gallery/tutorials/run_doc2vec_lee.py |  12 +-
 6 files changed, 206 insertions(+), 271 deletions(-)

diff --git a/docs/src/auto_examples/tutorials/run_doc2vec_lee.ipynb b/docs/src/auto_examples/tutorials/run_doc2vec_lee.ipynb
index 5314bea335..a886f2f526 100644
--- a/docs/src/auto_examples/tutorials/run_doc2vec_lee.ipynb
+++ b/docs/src/auto_examples/tutorials/run_doc2vec_lee.ipynb
@@ -15,7 +15,7 @@
       "cell_type": "markdown",
       "metadata": {},
       "source": [
-        "\nDoc2Vec Model\n=============\n\nIntroduces Gensim's Doc2Vec model and demonstrates its use on the\n`Lee Corpus <https://hekyll.services.adelaide.edu.au/dspace/bitstream/2440/28910/1/hdl_28910.pdf>`__.\n\n\n"
+        "\n# Doc2Vec Model\n\nIntroduces Gensim's Doc2Vec model and demonstrates its use on the\n[Lee Corpus](https://hekyll.services.adelaide.edu.au/dspace/bitstream/2440/28910/1/hdl_28910.pdf)_.\n"
       ]
     },
     {
@@ -33,7 +33,7 @@
       "cell_type": "markdown",
       "metadata": {},
       "source": [
-        "Doc2Vec is a `core_concepts_model` that represents each\n`core_concepts_document` as a `core_concepts_vector`.  This\ntutorial introduces the model and demonstrates how to train and assess it.\n\nHere's a list of what we'll be doing:\n\n0. Review the relevant models: bag-of-words, Word2Vec, Doc2Vec\n1. Load and preprocess the training and test corpora (see `core_concepts_corpus`)\n2. Train a Doc2Vec `core_concepts_model` model using the training corpus\n3. Demonstrate how the trained model can be used to infer a `core_concepts_vector`\n4. Assess the model\n5. Test the model on the test corpus\n\nReview: Bag-of-words\n--------------------\n\n.. Note:: Feel free to skip these review sections if you're already familiar with the models.\n\nYou may be familiar with the `bag-of-words model\n<https://en.wikipedia.org/wiki/Bag-of-words_model>`_ from the\n`core_concepts_vector` section.\nThis model transforms each document to a fixed-length vector of integers.\nFor example, given the sentences:\n\n- ``John likes to watch movies. Mary likes movies too.``\n- ``John also likes to watch football games. Mary hates football.``\n\nThe model outputs the vectors:\n\n- ``[1, 2, 1, 1, 2, 1, 1, 0, 0, 0, 0]``\n- ``[1, 1, 1, 1, 0, 1, 0, 1, 2, 1, 1]``\n\nEach vector has 10 elements, where each element counts the number of times a\nparticular word occurred in the document.\nThe order of elements is arbitrary.\nIn the example above, the order of the elements corresponds to the words:\n``[\"John\", \"likes\", \"to\", \"watch\", \"movies\", \"Mary\", \"too\", \"also\", \"football\", \"games\", \"hates\"]``.\n\nBag-of-words models are surprisingly effective, but have several weaknesses.\n\nFirst, they lose all information about word order: \"John likes Mary\" and\n\"Mary likes John\" correspond to identical vectors. There is a solution: bag\nof `n-grams <https://en.wikipedia.org/wiki/N-gram>`__\nmodels consider word phrases of length n to represent documents as\nfixed-length vectors to capture local word order but suffer from data\nsparsity and high dimensionality.\n\nSecond, the model does not attempt to learn the meaning of the underlying\nwords, and as a consequence, the distance between vectors doesn't always\nreflect the difference in meaning.  The ``Word2Vec`` model addresses this\nsecond problem.\n\nReview: ``Word2Vec`` Model\n--------------------------\n\n``Word2Vec`` is a more recent model that embeds words in a lower-dimensional\nvector space using a shallow neural network. The result is a set of\nword-vectors where vectors close together in vector space have similar\nmeanings based on context, and word-vectors distant to each other have\ndiffering meanings. For example, ``strong`` and ``powerful`` would be close\ntogether and ``strong`` and ``Paris`` would be relatively far.\n\nGensim's :py:class:`~gensim.models.word2vec.Word2Vec` class implements this model.\n\nWith the ``Word2Vec`` model, we can calculate the vectors for each **word** in a document.\nBut what if we want to calculate a vector for the **entire document**\\ ?\nWe could average the vectors for each word in the document - while this is quick and crude, it can often be useful.\nHowever, there is a better way...\n\nIntroducing: Paragraph Vector\n-----------------------------\n\n.. Important:: In Gensim, we refer to the Paragraph Vector model as ``Doc2Vec``.\n\nLe and Mikolov in 2014 introduced the `Doc2Vec algorithm <https://cs.stanford.edu/~quocle/paragraph_vector.pdf>`__,\nwhich usually outperforms such simple-averaging of ``Word2Vec`` vectors.\n\nThe basic idea is: act as if a document has another floating word-like\nvector, which contributes to all training predictions, and is updated like\nother word-vectors, but we will call it a doc-vector. Gensim's\n:py:class:`~gensim.models.doc2vec.Doc2Vec` class implements this algorithm.\n\nThere are two implementations:\n\n1. Paragraph Vector - Distributed Memory (PV-DM)\n2. Paragraph Vector - Distributed Bag of Words (PV-DBOW)\n\n.. Important::\n  Don't let the implementation details below scare you.\n  They're advanced material: if it's too much, then move on to the next section.\n\nPV-DM is analogous to Word2Vec CBOW. The doc-vectors are obtained by training\na neural network on the synthetic task of predicting a center word based an\naverage of both context word-vectors and the full document's doc-vector.\n\nPV-DBOW is analogous to Word2Vec SG. The doc-vectors are obtained by training\na neural network on the synthetic task of predicting a target word just from\nthe full document's doc-vector. (It is also common to combine this with\nskip-gram testing, using both the doc-vector and nearby word-vectors to\npredict a single target word, but only one at a time.)\n\nPrepare the Training and Test Data\n----------------------------------\n\nFor this tutorial, we'll be training our model using the `Lee Background\nCorpus\n<https://hekyll.services.adelaide.edu.au/dspace/bitstream/2440/28910/1/hdl_28910.pdf>`_\nincluded in gensim. This corpus contains 314 documents selected from the\nAustralian Broadcasting Corporation\u2019s news mail service, which provides text\ne-mails of headline stories and covers a number of broad topics.\n\nAnd we'll test our model by eye using the much shorter `Lee Corpus\n<https://hekyll.services.adelaide.edu.au/dspace/bitstream/2440/28910/1/hdl_28910.pdf>`_\nwhich contains 50 documents.\n\n\n"
+        "Doc2Vec is a `core_concepts_model` that represents each\n`core_concepts_document` as a `core_concepts_vector`.  This\ntutorial introduces the model and demonstrates how to train and assess it.\n\nHere's a list of what we'll be doing:\n\n0. Review the relevant models: bag-of-words, Word2Vec, Doc2Vec\n1. Load and preprocess the training and test corpora (see `core_concepts_corpus`)\n2. Train a Doc2Vec `core_concepts_model` model using the training corpus\n3. Demonstrate how the trained model can be used to infer a `core_concepts_vector`\n4. Assess the model\n5. Test the model on the test corpus\n\n## Review: Bag-of-words\n\n.. Note:: Feel free to skip these review sections if you're already familiar with the models.\n\nYou may be familiar with the [bag-of-words model](https://en.wikipedia.org/wiki/Bag-of-words_model) from the\n`core_concepts_vector` section.\nThis model transforms each document to a fixed-length vector of integers.\nFor example, given the sentences:\n\n- ``John likes to watch movies. Mary likes movies too.``\n- ``John also likes to watch football games. Mary hates football.``\n\nThe model outputs the vectors:\n\n- ``[1, 2, 1, 1, 2, 1, 1, 0, 0, 0, 0]``\n- ``[1, 1, 1, 1, 0, 1, 0, 1, 2, 1, 1]``\n\nEach vector has 10 elements, where each element counts the number of times a\nparticular word occurred in the document.\nThe order of elements is arbitrary.\nIn the example above, the order of the elements corresponds to the words:\n``[\"John\", \"likes\", \"to\", \"watch\", \"movies\", \"Mary\", \"too\", \"also\", \"football\", \"games\", \"hates\"]``.\n\nBag-of-words models are surprisingly effective, but have several weaknesses.\n\nFirst, they lose all information about word order: \"John likes Mary\" and\n\"Mary likes John\" correspond to identical vectors. There is a solution: bag\nof [n-grams](https://en.wikipedia.org/wiki/N-gram)_\nmodels consider word phrases of length n to represent documents as\nfixed-length vectors to capture local word order but suffer from data\nsparsity and high dimensionality.\n\nSecond, the model does not attempt to learn the meaning of the underlying\nwords, and as a consequence, the distance between vectors doesn't always\nreflect the difference in meaning.  The ``Word2Vec`` model addresses this\nsecond problem.\n\n## Review: ``Word2Vec`` Model\n\n``Word2Vec`` is a more recent model that embeds words in a lower-dimensional\nvector space using a shallow neural network. The result is a set of\nword-vectors where vectors close together in vector space have similar\nmeanings based on context, and word-vectors distant to each other have\ndiffering meanings. For example, ``strong`` and ``powerful`` would be close\ntogether and ``strong`` and ``Paris`` would be relatively far.\n\nGensim's :py:class:`~gensim.models.word2vec.Word2Vec` class implements this model.\n\nWith the ``Word2Vec`` model, we can calculate the vectors for each **word** in a document.\nBut what if we want to calculate a vector for the **entire document**\\ ?\nWe could average the vectors for each word in the document - while this is quick and crude, it can often be useful.\nHowever, there is a better way...\n\n## Introducing: Paragraph Vector\n\n.. Important:: In Gensim, we refer to the Paragraph Vector model as ``Doc2Vec``.\n\nLe and Mikolov in 2014 introduced the [Doc2Vec algorithm](https://cs.stanford.edu/~quocle/paragraph_vector.pdf)_,\nwhich usually outperforms such simple-averaging of ``Word2Vec`` vectors.\n\nThe basic idea is: act as if a document has another floating word-like\nvector, which contributes to all training predictions, and is updated like\nother word-vectors, but we will call it a doc-vector. Gensim's\n:py:class:`~gensim.models.doc2vec.Doc2Vec` class implements this algorithm.\n\nThere are two implementations:\n\n1. Paragraph Vector - Distributed Memory (PV-DM)\n2. Paragraph Vector - Distributed Bag of Words (PV-DBOW)\n\n.. Important::\n  Don't let the implementation details below scare you.\n  They're advanced material: if it's too much, then move on to the next section.\n\nPV-DM is analogous to Word2Vec CBOW. The doc-vectors are obtained by training\na neural network on the synthetic task of predicting a center word based an\naverage of both context word-vectors and the full document's doc-vector.\n\nPV-DBOW is analogous to Word2Vec SG. The doc-vectors are obtained by training\na neural network on the synthetic task of predicting a target word just from\nthe full document's doc-vector. (It is also common to combine this with\nskip-gram testing, using both the doc-vector and nearby word-vectors to\npredict a single target word, but only one at a time.)\n\n## Prepare the Training and Test Data\n\nFor this tutorial, we'll be training our model using the [Lee Background\nCorpus](https://hekyll.services.adelaide.edu.au/dspace/bitstream/2440/28910/1/hdl_28910.pdf)\nincluded in gensim. This corpus contains 314 documents selected from the\nAustralian Broadcasting Corporation\u2019s news mail service, which provides text\ne-mails of headline stories and covers a number of broad topics.\n\nAnd we'll test our model by eye using the much shorter [Lee Corpus](https://hekyll.services.adelaide.edu.au/dspace/bitstream/2440/28910/1/hdl_28910.pdf)\nwhich contains 50 documents.\n\n\n"
       ]
     },
     {
@@ -51,7 +51,7 @@
       "cell_type": "markdown",
       "metadata": {},
       "source": [
-        "Define a Function to Read and Preprocess Text\n---------------------------------------------\n\nBelow, we define a function to:\n\n- open the train/test file (with latin encoding)\n- read the file line-by-line\n- pre-process each line (tokenize text into individual words, remove punctuation, set to lowercase, etc)\n\nThe file we're reading is a **corpus**.\nEach line of the file is a **document**.\n\n.. Important::\n  To train the model, we'll need to associate a tag/number with each document\n  of the training corpus. In our case, the tag is simply the zero-based line\n  number.\n\n\n"
+        "## Define a Function to Read and Preprocess Text\n\nBelow, we define a function to:\n\n- open the train/test file (with latin encoding)\n- read the file line-by-line\n- pre-process each line (tokenize text into individual words, remove punctuation, set to lowercase, etc)\n\nThe file we're reading is a **corpus**.\nEach line of the file is a **document**.\n\n.. Important::\n  To train the model, we'll need to associate a tag/number with each document\n  of the training corpus. In our case, the tag is simply the zero-based line\n  number.\n\n\n"
       ]
     },
     {
@@ -112,7 +112,7 @@
       "cell_type": "markdown",
       "metadata": {},
       "source": [
-        "Training the Model\n------------------\n\nNow, we'll instantiate a Doc2Vec model with a vector size with 50 dimensions and\niterating over the training corpus 40 times. We set the minimum word count to\n2 in order to discard words with very few occurrences. (Without a variety of\nrepresentative examples, retaining such infrequent words can often make a\nmodel worse!) Typical iteration counts in the published `Paragraph Vector paper <https://cs.stanford.edu/~quocle/paragraph_vector.pdf>`__\nresults, using 10s-of-thousands to millions of docs, are 10-20. More\niterations take more time and eventually reach a point of diminishing\nreturns.\n\nHowever, this is a very very small dataset (300 documents) with shortish\ndocuments (a few hundred words). Adding training passes can sometimes help\nwith such small datasets.\n\n\n"
+        "## Training the Model\n\nNow, we'll instantiate a Doc2Vec model with a vector size with 50 dimensions and\niterating over the training corpus 40 times. We set the minimum word count to\n2 in order to discard words with very few occurrences. (Without a variety of\nrepresentative examples, retaining such infrequent words can often make a\nmodel worse!) Typical iteration counts in the published [Paragraph Vector paper](https://cs.stanford.edu/~quocle/paragraph_vector.pdf)_\nresults, using 10s-of-thousands to millions of docs, are 10-20. More\niterations take more time and eventually reach a point of diminishing\nreturns.\n\nHowever, this is a very very small dataset (300 documents) with shortish\ndocuments (a few hundred words). Adding training passes can sometimes help\nwith such small datasets.\n\n\n"
       ]
     },
     {
@@ -166,7 +166,7 @@
       "cell_type": "markdown",
       "metadata": {},
       "source": [
-        "Next, train the model on the corpus.\nIf optimized Gensim (with BLAS library) is being used, this should take no more than 3 seconds.\nIf the BLAS library is not being used, this should take no more than 2\nminutes, so use optimized Gensim with BLAS if you value your time.\n\n\n"
+        "Next, train the model on the corpus.\nIn the usual case, where Gensim installation found a BLAS library for optimized\nbulk vector operations, this training on this tiny 300 document, ~60k word corpus \nshould take just a few seconds. (More realistic datasets of tens-of-millions\nof words or more take proportionately longer.) If for some reason a BLAS library \nisn't available, training uses a fallback approach that takes 60x-120x longer, \nso even this tiny training will take minutes rather than seconds. (And, in that \ncase, you should also notice a warning in the logging letting you know there's \nsomething worth fixing.) So, be sure your installation uses the BLAS-optimized \nGensim if you value your time.\n\n\n"
       ]
     },
     {
@@ -209,7 +209,7 @@
       "cell_type": "markdown",
       "metadata": {},
       "source": [
-        "Assessing the Model\n-------------------\n\nTo assess our new model, we'll first infer new vectors for each document of\nthe training corpus, compare the inferred vectors with the training corpus,\nand then returning the rank of the document based on self-similarity.\nBasically, we're pretending as if the training corpus is some new unseen data\nand then seeing how they compare with the trained model. The expectation is\nthat we've likely overfit our model (i.e., all of the ranks will be less than\n2) and so we should be able to find similar documents very easily.\nAdditionally, we'll keep track of the second ranks for a comparison of less\nsimilar documents.\n\n\n"
+        "## Assessing the Model\n\nTo assess our new model, we'll first infer new vectors for each document of\nthe training corpus, compare the inferred vectors with the training corpus,\nand then returning the rank of the document based on self-similarity.\nBasically, we're pretending as if the training corpus is some new unseen data\nand then seeing how they compare with the trained model. The expectation is\nthat we've likely overfit our model (i.e., all of the ranks will be less than\n2) and so we should be able to find similar documents very easily.\nAdditionally, we'll keep track of the second ranks for a comparison of less\nsimilar documents.\n\n\n"
       ]
     },
     {
@@ -281,7 +281,7 @@
       "cell_type": "markdown",
       "metadata": {},
       "source": [
-        "Testing the Model\n-----------------\n\nUsing the same approach above, we'll infer the vector for a randomly chosen\ntest document, and compare the document to our model by eye.\n\n\n"
+        "## Testing the Model\n\nUsing the same approach above, we'll infer the vector for a randomly chosen\ntest document, and compare the document to our model by eye.\n\n\n"
       ]
     },
     {
@@ -299,7 +299,7 @@
       "cell_type": "markdown",
       "metadata": {},
       "source": [
-        "Conclusion\n----------\n\nLet's review what we've seen in this tutorial:\n\n0. Review the relevant models: bag-of-words, Word2Vec, Doc2Vec\n1. Load and preprocess the training and test corpora (see `core_concepts_corpus`)\n2. Train a Doc2Vec `core_concepts_model` model using the training corpus\n3. Demonstrate how the trained model can be used to infer a `core_concepts_vector`\n4. Assess the model\n5. Test the model on the test corpus\n\nThat's it! Doc2Vec is a great way to explore relationships between documents.\n\nAdditional Resources\n--------------------\n\nIf you'd like to know more about the subject matter of this tutorial, check out the links below.\n\n* `Word2Vec Paper <https://papers.nips.cc/paper/5021-distributed-representations-of-words-and-phrases-and-their-compositionality.pdf>`_\n* `Doc2Vec Paper <https://cs.stanford.edu/~quocle/paragraph_vector.pdf>`_\n* `Dr. Michael D. Lee's Website <http://faculty.sites.uci.edu/mdlee>`_\n* `Lee Corpus <http://faculty.sites.uci.edu/mdlee/similarity-data/>`__\n* `IMDB Doc2Vec Tutorial <doc2vec-IMDB.ipynb>`_\n\n\n"
+        "## Conclusion\n\nLet's review what we've seen in this tutorial:\n\n0. Review the relevant models: bag-of-words, Word2Vec, Doc2Vec\n1. Load and preprocess the training and test corpora (see `core_concepts_corpus`)\n2. Train a Doc2Vec `core_concepts_model` model using the training corpus\n3. Demonstrate how the trained model can be used to infer a `core_concepts_vector`\n4. Assess the model\n5. Test the model on the test corpus\n\nThat's it! Doc2Vec is a great way to explore relationships between documents.\n\n## Additional Resources\n\nIf you'd like to know more about the subject matter of this tutorial, check out the links below.\n\n* [Word2Vec Paper](https://papers.nips.cc/paper/5021-distributed-representations-of-words-and-phrases-and-their-compositionality.pdf)\n* [Doc2Vec Paper](https://cs.stanford.edu/~quocle/paragraph_vector.pdf)\n* [Dr. Michael D. Lee's Website](http://faculty.sites.uci.edu/mdlee)\n* [Lee Corpus](http://faculty.sites.uci.edu/mdlee/similarity-data/)_\n* [IMDB Doc2Vec Tutorial](doc2vec-IMDB.ipynb)\n\n\n"
       ]
     }
   ],
@@ -319,7 +319,7 @@
       "name": "python",
       "nbconvert_exporter": "python",
       "pygments_lexer": "ipython3",
-      "version": "3.6.5"
+      "version": "3.8.10"
     }
   },
   "nbformat": 4,
diff --git a/docs/src/auto_examples/tutorials/run_doc2vec_lee.py b/docs/src/auto_examples/tutorials/run_doc2vec_lee.py
index 7012d38f66..18f4ee7b16 100644
--- a/docs/src/auto_examples/tutorials/run_doc2vec_lee.py
+++ b/docs/src/auto_examples/tutorials/run_doc2vec_lee.py
@@ -215,9 +215,15 @@ def read_corpus(fname, tokens_only=False):
 
 ###############################################################################
 # Next, train the model on the corpus.
-# If optimized Gensim (with BLAS library) is being used, this should take no more than 3 seconds.
-# If the BLAS library is not being used, this should take no more than 2
-# minutes, so use optimized Gensim with BLAS if you value your time.
+# In the usual case, where Gensim installation found a BLAS library for optimized
+# bulk vector operations, this training on this tiny 300 document, ~60k word corpus 
+# should take just a few seconds. (More realistic datasets of tens-of-millions
+# of words or more take proportionately longer.) If for some reason a BLAS library 
+# isn't available, training uses a fallback approach that takes 60x-120x longer, 
+# so even this tiny training will take minutes rather than seconds. (And, in that 
+# case, you should also notice a warning in the logging letting you know there's 
+# something worth fixing.) So, be sure your installation uses the BLAS-optimized 
+# Gensim if you value your time.
 #
 model.train(train_corpus, total_examples=model.corpus_count, epochs=model.epochs)
 
diff --git a/docs/src/auto_examples/tutorials/run_doc2vec_lee.py.md5 b/docs/src/auto_examples/tutorials/run_doc2vec_lee.py.md5
index f1b58e756c..5c0d021557 100644
--- a/docs/src/auto_examples/tutorials/run_doc2vec_lee.py.md5
+++ b/docs/src/auto_examples/tutorials/run_doc2vec_lee.py.md5
@@ -1 +1 @@
-7d0ee86f6eb9d1e2f55b9f295eec3060
\ No newline at end of file
+581caa67e8496a210a030c2886fb8bbc
\ No newline at end of file
diff --git a/docs/src/auto_examples/tutorials/run_doc2vec_lee.rst b/docs/src/auto_examples/tutorials/run_doc2vec_lee.rst
index 6e99a47a13..68a6fc7d3f 100644
--- a/docs/src/auto_examples/tutorials/run_doc2vec_lee.rst
+++ b/docs/src/auto_examples/tutorials/run_doc2vec_lee.rst
@@ -1,12 +1,21 @@
+
+.. DO NOT EDIT.
+.. THIS FILE WAS AUTOMATICALLY GENERATED BY SPHINX-GALLERY.
+.. TO MAKE CHANGES, EDIT THE SOURCE PYTHON FILE:
+.. "auto_examples/tutorials/run_doc2vec_lee.py"
+.. LINE NUMBERS ARE GIVEN BELOW.
+
 .. only:: html
 
     .. note::
         :class: sphx-glr-download-link-note
 
-        Click :ref:`here <sphx_glr_download_auto_examples_tutorials_run_doc2vec_lee.py>`     to download the full example code
-    .. rst-class:: sphx-glr-example-title
+        Click :ref:`here <sphx_glr_download_auto_examples_tutorials_run_doc2vec_lee.py>`
+        to download the full example code
+
+.. rst-class:: sphx-glr-example-title
 
-    .. _sphx_glr_auto_examples_tutorials_run_doc2vec_lee.py:
+.. _sphx_glr_auto_examples_tutorials_run_doc2vec_lee.py:
 
 
 Doc2Vec Model
@@ -15,7 +24,7 @@ Doc2Vec Model
 Introduces Gensim's Doc2Vec model and demonstrates its use on the
 `Lee Corpus <https://hekyll.services.adelaide.edu.au/dspace/bitstream/2440/28910/1/hdl_28910.pdf>`__.
 
-
+.. GENERATED FROM PYTHON SOURCE LINES 9-13
 
 .. code-block:: default
 
@@ -30,6 +39,8 @@ Introduces Gensim's Doc2Vec model and demonstrates its use on the
 
 
 
+.. GENERATED FROM PYTHON SOURCE LINES 14-129
+
 Doc2Vec is a :ref:`core_concepts_model` that represents each
 :ref:`core_concepts_document` as a :ref:`core_concepts_vector`.  This
 tutorial introduces the model and demonstrates how to train and assess it.
@@ -146,6 +157,7 @@ And we'll test our model by eye using the much shorter `Lee Corpus
 which contains 50 documents.
 
 
+.. GENERATED FROM PYTHON SOURCE LINES 129-137
 
 .. code-block:: default
 
@@ -164,6 +176,8 @@ which contains 50 documents.
 
 
 
+.. GENERATED FROM PYTHON SOURCE LINES 138-155
+
 Define a Function to Read and Preprocess Text
 ---------------------------------------------
 
@@ -182,6 +196,7 @@ Each line of the file is a **document**.
   number.
 
 
+.. GENERATED FROM PYTHON SOURCE LINES 155-170
 
 .. code-block:: default
 
@@ -207,9 +222,12 @@ Each line of the file is a **document**.
 
 
 
+.. GENERATED FROM PYTHON SOURCE LINES 171-173
+
 Let's take a look at the training corpus
 
 
+.. GENERATED FROM PYTHON SOURCE LINES 173-175
 
 .. code-block:: default
 
@@ -221,8 +239,6 @@ Let's take a look at the training corpus
 
 .. rst-class:: sphx-glr-script-out
 
- Out:
-
  .. code-block:: none
 
     [TaggedDocument(words=['hundreds', 'of', 'people', 'have', 'been', 'forced', 'to', 'vacate', 'their', 'homes', 'in', 'the', 'southern', 'highlands', 'of', 'new', 'south', 'wales', 'as', 'strong', 'winds', 'today', 'pushed', 'huge', 'bushfire', 'towards', 'the', 'town', 'of', 'hill', 'top', 'new', 'blaze', 'near', 'goulburn', 'south', 'west', 'of', 'sydney', 'has', 'forced', 'the', 'closure', 'of', 'the', 'hume', 'highway', 'at', 'about', 'pm', 'aedt', 'marked', 'deterioration', 'in', 'the', 'weather', 'as', 'storm', 'cell', 'moved', 'east', 'across', 'the', 'blue', 'mountains', 'forced', 'authorities', 'to', 'make', 'decision', 'to', 'evacuate', 'people', 'from', 'homes', 'in', 'outlying', 'streets', 'at', 'hill', 'top', 'in', 'the', 'new', 'south', 'wales', 'southern', 'highlands', 'an', 'estimated', 'residents', 'have', 'left', 'their', 'homes', 'for', 'nearby', 'mittagong', 'the', 'new', 'south', 'wales', 'rural', 'fire', 'service', 'says', 'the', 'weather', 'conditions', 'which', 'caused', 'the', 'fire', 'to', 'burn', 'in', 'finger', 'formation', 'have', 'now', 'eased', 'and', 'about', 'fire', 'units', 'in', 'and', 'around', 'hill', 'top', 'are', 'optimistic', 'of', 'defending', 'all', 'properties', 'as', 'more', 'than', 'blazes', 'burn', 'on', 'new', 'year', 'eve', 'in', 'new', 'south', 'wales', 'fire', 'crews', 'have', 'been', 'called', 'to', 'new', 'fire', 'at', 'gunning', 'south', 'of', 'goulburn', 'while', 'few', 'details', 'are', 'available', 'at', 'this', 'stage', 'fire', 'authorities', 'says', 'it', 'has', 'closed', 'the', 'hume', 'highway', 'in', 'both', 'directions', 'meanwhile', 'new', 'fire', 'in', 'sydney', 'west', 'is', 'no', 'longer', 'threatening', 'properties', 'in', 'the', 'cranebrook', 'area', 'rain', 'has', 'fallen', 'in', 'some', 'parts', 'of', 'the', 'illawarra', 'sydney', 'the', 'hunter', 'valley', 'and', 'the', 'north', 'coast', 'but', 'the', 'bureau', 'of', 'meteorology', 'claire', 'richards', 'says', 'the', 'rain', 'has', 'done', 'little', 'to', 'ease', 'any', 'of', 'the', 'hundred', 'fires', 'still', 'burning', 'across', 'the', 'state', 'the', 'falls', 'have', 'been', 'quite', 'isolated', 'in', 'those', 'areas', 'and', 'generally', 'the', 'falls', 'have', 'been', 'less', 'than', 'about', 'five', 'millimetres', 'she', 'said', 'in', 'some', 'places', 'really', 'not', 'significant', 'at', 'all', 'less', 'than', 'millimetre', 'so', 'there', 'hasn', 'been', 'much', 'relief', 'as', 'far', 'as', 'rain', 'is', 'concerned', 'in', 'fact', 'they', 've', 'probably', 'hampered', 'the', 'efforts', 'of', 'the', 'firefighters', 'more', 'because', 'of', 'the', 'wind', 'gusts', 'that', 'are', 'associated', 'with', 'those', 'thunderstorms'], tags=[0]), TaggedDocument(words=['indian', 'security', 'forces', 'have', 'shot', 'dead', 'eight', 'suspected', 'militants', 'in', 'night', 'long', 'encounter', 'in', 'southern', 'kashmir', 'the', 'shootout', 'took', 'place', 'at', 'dora', 'village', 'some', 'kilometers', 'south', 'of', 'the', 'kashmiri', 'summer', 'capital', 'srinagar', 'the', 'deaths', 'came', 'as', 'pakistani', 'police', 'arrested', 'more', 'than', 'two', 'dozen', 'militants', 'from', 'extremist', 'groups', 'accused', 'of', 'staging', 'an', 'attack', 'on', 'india', 'parliament', 'india', 'has', 'accused', 'pakistan', 'based', 'lashkar', 'taiba', 'and', 'jaish', 'mohammad', 'of', 'carrying', 'out', 'the', 'attack', 'on', 'december', 'at', 'the', 'behest', 'of', 'pakistani', 'military', 'intelligence', 'military', 'tensions', 'have', 'soared', 'since', 'the', 'raid', 'with', 'both', 'sides', 'massing', 'troops', 'along', 'their', 'border', 'and', 'trading', 'tit', 'for', 'tat', 'diplomatic', 'sanctions', 'yesterday', 'pakistan', 'announced', 'it', 'had', 'arrested', 'lashkar', 'taiba', 'chief', 'hafiz', 'mohammed', 'saeed', 'police', 'in', 'karachi', 'say', 'it', 'is', 'likely', 'more', 'raids', 'will', 'be', 'launched', 'against', 'the', 'two', 'groups', 'as', 'well', 'as', 'other', 'militant', 'organisations', 'accused', 'of', 'targetting', 'india', 'military', 'tensions', 'between', 'india', 'and', 'pakistan', 'have', 'escalated', 'to', 'level', 'not', 'seen', 'since', 'their', 'war'], tags=[1])]
@@ -230,9 +246,12 @@ Let's take a look at the training corpus
 
 
 
+.. GENERATED FROM PYTHON SOURCE LINES 176-178
+
 And the testing corpus looks like this:
 
 
+.. GENERATED FROM PYTHON SOURCE LINES 178-180
 
 .. code-block:: default
 
@@ -244,8 +263,6 @@ And the testing corpus looks like this:
 
 .. rst-class:: sphx-glr-script-out
 
- Out:
-
  .. code-block:: none
 
     [['the', 'national', 'executive', 'of', 'the', 'strife', 'torn', 'democrats', 'last', 'night', 'appointed', 'little', 'known', 'west', 'australian', 'senator', 'brian', 'greig', 'as', 'interim', 'leader', 'shock', 'move', 'likely', 'to', 'provoke', 'further', 'conflict', 'between', 'the', 'party', 'senators', 'and', 'its', 'organisation', 'in', 'move', 'to', 'reassert', 'control', 'over', 'the', 'party', 'seven', 'senators', 'the', 'national', 'executive', 'last', 'night', 'rejected', 'aden', 'ridgeway', 'bid', 'to', 'become', 'interim', 'leader', 'in', 'favour', 'of', 'senator', 'greig', 'supporter', 'of', 'deposed', 'leader', 'natasha', 'stott', 'despoja', 'and', 'an', 'outspoken', 'gay', 'rights', 'activist'], ['cash', 'strapped', 'financial', 'services', 'group', 'amp', 'has', 'shelved', 'million', 'plan', 'to', 'buy', 'shares', 'back', 'from', 'investors', 'and', 'will', 'raise', 'million', 'in', 'fresh', 'capital', 'after', 'profits', 'crashed', 'in', 'the', 'six', 'months', 'to', 'june', 'chief', 'executive', 'paul', 'batchelor', 'said', 'the', 'result', 'was', 'solid', 'in', 'what', 'he', 'described', 'as', 'the', 'worst', 'conditions', 'for', 'stock', 'markets', 'in', 'years', 'amp', 'half', 'year', 'profit', 'sank', 'per', 'cent', 'to', 'million', 'or', 'share', 'as', 'australia', 'largest', 'investor', 'and', 'fund', 'manager', 'failed', 'to', 'hit', 'projected', 'per', 'cent', 'earnings', 'growth', 'targets', 'and', 'was', 'battered', 'by', 'falling', 'returns', 'on', 'share', 'markets']]
@@ -253,10 +270,14 @@ And the testing corpus looks like this:
 
 
 
+.. GENERATED FROM PYTHON SOURCE LINES 181-184
+
 Notice that the testing corpus is just a list of lists and does not contain
 any tags.
 
 
+.. GENERATED FROM PYTHON SOURCE LINES 186-202
+
 Training the Model
 ------------------
 
@@ -274,6 +295,7 @@ documents (a few hundred words). Adding training passes can sometimes help
 with such small datasets.
 
 
+.. GENERATED FROM PYTHON SOURCE LINES 202-204
 
 .. code-block:: default
 
@@ -283,11 +305,20 @@ with such small datasets.
 
 
 
+.. rst-class:: sphx-glr-script-out
+
+ .. code-block:: none
+
+    2022-12-07 10:59:00,578 : INFO : Doc2Vec lifecycle event {'params': 'Doc2Vec<dm/m,d50,n5,w5,mc2,s0.001,t3>', 'datetime': '2022-12-07T10:59:00.540082', 'gensim': '4.2.1.dev0', 'python': '3.8.10 (default, Jun 22 2022, 20:18:18) \n[GCC 9.4.0]', 'platform': 'Linux-5.4.0-135-generic-x86_64-with-glibc2.29', 'event': 'created'}
+
 
 
 
+.. GENERATED FROM PYTHON SOURCE LINES 205-206
+
 Build a vocabulary
 
+.. GENERATED FROM PYTHON SOURCE LINES 206-208
 
 .. code-block:: default
 
@@ -299,24 +330,24 @@ Build a vocabulary
 
 .. rst-class:: sphx-glr-script-out
 
- Out:
-
  .. code-block:: none
 
-    2020-09-30 21:08:55,026 : INFO : collecting all words and their counts
-    2020-09-30 21:08:55,027 : INFO : PROGRESS: at example #0, processed 0 words (0/s), 0 word types, 0 tags
-    2020-09-30 21:08:55,043 : INFO : collected 6981 word types and 300 unique tags from a corpus of 300 examples and 58152 words
-    2020-09-30 21:08:55,043 : INFO : Loading a fresh vocabulary
-    2020-09-30 21:08:55,064 : INFO : effective_min_count=2 retains 3955 unique words (56% of original 6981, drops 3026)
-    2020-09-30 21:08:55,064 : INFO : effective_min_count=2 leaves 55126 word corpus (94% of original 58152, drops 3026)
-    2020-09-30 21:08:55,098 : INFO : deleting the raw counts dictionary of 6981 items
-    2020-09-30 21:08:55,100 : INFO : sample=0.001 downsamples 46 most-common words
-    2020-09-30 21:08:55,100 : INFO : downsampling leaves estimated 42390 word corpus (76.9% of prior 55126)
-    2020-09-30 21:08:55,149 : INFO : estimated required memory for 3955 words and 50 dimensions: 3679500 bytes
-    2020-09-30 21:08:55,149 : INFO : resetting layer weights
+    2022-12-07 10:59:00,806 : INFO : collecting all words and their counts
+    2022-12-07 10:59:00,808 : INFO : PROGRESS: at example #0, processed 0 words (0 words/s), 0 word types, 0 tags
+    2022-12-07 10:59:00,850 : INFO : collected 6981 word types and 300 unique tags from a corpus of 300 examples and 58152 words
+    2022-12-07 10:59:00,850 : INFO : Creating a fresh vocabulary
+    2022-12-07 10:59:00,887 : INFO : Doc2Vec lifecycle event {'msg': 'effective_min_count=2 retains 3955 unique words (56.65% of original 6981, drops 3026)', 'datetime': '2022-12-07T10:59:00.886953', 'gensim': '4.2.1.dev0', 'python': '3.8.10 (default, Jun 22 2022, 20:18:18) \n[GCC 9.4.0]', 'platform': 'Linux-5.4.0-135-generic-x86_64-with-glibc2.29', 'event': 'prepare_vocab'}
+    2022-12-07 10:59:00,887 : INFO : Doc2Vec lifecycle event {'msg': 'effective_min_count=2 leaves 55126 word corpus (94.80% of original 58152, drops 3026)', 'datetime': '2022-12-07T10:59:00.887466', 'gensim': '4.2.1.dev0', 'python': '3.8.10 (default, Jun 22 2022, 20:18:18) \n[GCC 9.4.0]', 'platform': 'Linux-5.4.0-135-generic-x86_64-with-glibc2.29', 'event': 'prepare_vocab'}
+    2022-12-07 10:59:00,917 : INFO : deleting the raw counts dictionary of 6981 items
+    2022-12-07 10:59:00,918 : INFO : sample=0.001 downsamples 46 most-common words
+    2022-12-07 10:59:00,918 : INFO : Doc2Vec lifecycle event {'msg': 'downsampling leaves estimated 42390.98914085061 word corpus (76.9%% of prior 55126)', 'datetime': '2022-12-07T10:59:00.918276', 'gensim': '4.2.1.dev0', 'python': '3.8.10 (default, Jun 22 2022, 20:18:18) \n[GCC 9.4.0]', 'platform': 'Linux-5.4.0-135-generic-x86_64-with-glibc2.29', 'event': 'prepare_vocab'}
+    2022-12-07 10:59:00,965 : INFO : estimated required memory for 3955 words and 50 dimensions: 3679500 bytes
+    2022-12-07 10:59:00,965 : INFO : resetting layer weights
+
 
 
 
+.. GENERATED FROM PYTHON SOURCE LINES 209-214
 
 Essentially, the vocabulary is a list (accessible via
 ``model.wv.index_to_key``) of all of the unique words extracted from the training corpus.
@@ -324,6 +355,7 @@ Additional attributes for each word are available using the ``model.wv.get_vecat
 For example, to see how many times ``penalty`` appeared in the training corpus:
 
 
+.. GENERATED FROM PYTHON SOURCE LINES 214-216
 
 .. code-block:: default
 
@@ -335,8 +367,6 @@ For example, to see how many times ``penalty`` appeared in the training corpus:
 
 .. rst-class:: sphx-glr-script-out
 
- Out:
-
  .. code-block:: none
 
     Word 'penalty' appeared 4 times in the training corpus.
@@ -344,12 +374,21 @@ For example, to see how many times ``penalty`` appeared in the training corpus:
 
 
 
+.. GENERATED FROM PYTHON SOURCE LINES 217-228
+
 Next, train the model on the corpus.
-If optimized Gensim (with BLAS library) is being used, this should take no more than 3 seconds.
-If the BLAS library is not being used, this should take no more than 2
-minutes, so use optimized Gensim with BLAS if you value your time.
+In the usual case, where Gensim installation found a BLAS library for optimized
+bulk vector operations, this training on this tiny 300 document, ~60k word corpus 
+should take just a few seconds. (More realistic datasets of tens-of-millions
+of words or more take proportionately longer.) If for some reason a BLAS library 
+isn't available, training uses a fallback approach that takes 60x-120x longer, 
+so even this tiny training will take minutes rather than seconds. (And, in that 
+case, you should also notice a warning in the logging letting you know there's 
+something worth fixing.) So, be sure your installation uses the BLAS-optimized 
+Gensim if you value your time.
 
 
+.. GENERATED FROM PYTHON SOURCE LINES 228-230
 
 .. code-block:: default
 
@@ -361,181 +400,62 @@ minutes, so use optimized Gensim with BLAS if you value your time.
 
 .. rst-class:: sphx-glr-script-out
 
- Out:
-
  .. code-block:: none
 
-    2020-09-30 21:08:55,553 : INFO : training model with 3 workers on 3955 vocabulary and 50 features, using sg=0 hs=0 sample=0.001 negative=5 window=5
-    2020-09-30 21:08:55,613 : INFO : worker thread finished; awaiting finish of 2 more threads
-    2020-09-30 21:08:55,614 : INFO : worker thread finished; awaiting finish of 1 more threads
-    2020-09-30 21:08:55,614 : INFO : worker thread finished; awaiting finish of 0 more threads
-    2020-09-30 21:08:55,614 : INFO : EPOCH - 1 : training on 58152 raw words (42784 effective words) took 0.1s, 751479 effective words/s
-    2020-09-30 21:08:55,664 : INFO : worker thread finished; awaiting finish of 2 more threads
-    2020-09-30 21:08:55,666 : INFO : worker thread finished; awaiting finish of 1 more threads
-    2020-09-30 21:08:55,666 : INFO : worker thread finished; awaiting finish of 0 more threads
-    2020-09-30 21:08:55,666 : INFO : EPOCH - 2 : training on 58152 raw words (42745 effective words) took 0.1s, 845101 effective words/s
-    2020-09-30 21:08:55,718 : INFO : worker thread finished; awaiting finish of 2 more threads
-    2020-09-30 21:08:55,719 : INFO : worker thread finished; awaiting finish of 1 more threads
-    2020-09-30 21:08:55,720 : INFO : worker thread finished; awaiting finish of 0 more threads
-    2020-09-30 21:08:55,720 : INFO : EPOCH - 3 : training on 58152 raw words (42605 effective words) took 0.1s, 810845 effective words/s
-    2020-09-30 21:08:55,781 : INFO : worker thread finished; awaiting finish of 2 more threads
-    2020-09-30 21:08:55,783 : INFO : worker thread finished; awaiting finish of 1 more threads
-    2020-09-30 21:08:55,784 : INFO : worker thread finished; awaiting finish of 0 more threads
-    2020-09-30 21:08:55,784 : INFO : EPOCH - 4 : training on 58152 raw words (42723 effective words) took 0.1s, 677810 effective words/s
-    2020-09-30 21:08:55,846 : INFO : worker thread finished; awaiting finish of 2 more threads
-    2020-09-30 21:08:55,847 : INFO : worker thread finished; awaiting finish of 1 more threads
-    2020-09-30 21:08:55,848 : INFO : worker thread finished; awaiting finish of 0 more threads
-    2020-09-30 21:08:55,848 : INFO : EPOCH - 5 : training on 58152 raw words (42641 effective words) took 0.1s, 682513 effective words/s
-    2020-09-30 21:08:55,903 : INFO : worker thread finished; awaiting finish of 2 more threads
-    2020-09-30 21:08:55,905 : INFO : worker thread finished; awaiting finish of 1 more threads
-    2020-09-30 21:08:55,905 : INFO : worker thread finished; awaiting finish of 0 more threads
-    2020-09-30 21:08:55,905 : INFO : EPOCH - 6 : training on 58152 raw words (42654 effective words) took 0.1s, 760381 effective words/s
-    2020-09-30 21:08:55,960 : INFO : worker thread finished; awaiting finish of 2 more threads
-    2020-09-30 21:08:55,962 : INFO : worker thread finished; awaiting finish of 1 more threads
-    2020-09-30 21:08:55,964 : INFO : worker thread finished; awaiting finish of 0 more threads
-    2020-09-30 21:08:55,964 : INFO : EPOCH - 7 : training on 58152 raw words (42751 effective words) took 0.1s, 741994 effective words/s
-    2020-09-30 21:08:56,018 : INFO : worker thread finished; awaiting finish of 2 more threads
-    2020-09-30 21:08:56,020 : INFO : worker thread finished; awaiting finish of 1 more threads
-    2020-09-30 21:08:56,020 : INFO : worker thread finished; awaiting finish of 0 more threads
-    2020-09-30 21:08:56,020 : INFO : EPOCH - 8 : training on 58152 raw words (42692 effective words) took 0.1s, 773631 effective words/s
-    2020-09-30 21:08:56,076 : INFO : worker thread finished; awaiting finish of 2 more threads
-    2020-09-30 21:08:56,078 : INFO : worker thread finished; awaiting finish of 1 more threads
-    2020-09-30 21:08:56,081 : INFO : worker thread finished; awaiting finish of 0 more threads
-    2020-09-30 21:08:56,081 : INFO : EPOCH - 9 : training on 58152 raw words (42745 effective words) took 0.1s, 719453 effective words/s
-    2020-09-30 21:08:56,137 : INFO : worker thread finished; awaiting finish of 2 more threads
-    2020-09-30 21:08:56,137 : INFO : worker thread finished; awaiting finish of 1 more threads
-    2020-09-30 21:08:56,137 : INFO : worker thread finished; awaiting finish of 0 more threads
-    2020-09-30 21:08:56,138 : INFO : EPOCH - 10 : training on 58152 raw words (42733 effective words) took 0.1s, 770082 effective words/s
-    2020-09-30 21:08:56,195 : INFO : worker thread finished; awaiting finish of 2 more threads
-    2020-09-30 21:08:56,196 : INFO : worker thread finished; awaiting finish of 1 more threads
-    2020-09-30 21:08:56,197 : INFO : worker thread finished; awaiting finish of 0 more threads
-    2020-09-30 21:08:56,197 : INFO : EPOCH - 11 : training on 58152 raw words (42791 effective words) took 0.1s, 734171 effective words/s
-    2020-09-30 21:08:56,253 : INFO : worker thread finished; awaiting finish of 2 more threads
-    2020-09-30 21:08:56,255 : INFO : worker thread finished; awaiting finish of 1 more threads
-    2020-09-30 21:08:56,255 : INFO : worker thread finished; awaiting finish of 0 more threads
-    2020-09-30 21:08:56,255 : INFO : EPOCH - 12 : training on 58152 raw words (42773 effective words) took 0.1s, 745248 effective words/s
-    2020-09-30 21:08:56,316 : INFO : worker thread finished; awaiting finish of 2 more threads
-    2020-09-30 21:08:56,318 : INFO : worker thread finished; awaiting finish of 1 more threads
-    2020-09-30 21:08:56,318 : INFO : worker thread finished; awaiting finish of 0 more threads
-    2020-09-30 21:08:56,318 : INFO : EPOCH - 13 : training on 58152 raw words (42793 effective words) took 0.1s, 702300 effective words/s
-    2020-09-30 21:08:56,369 : INFO : worker thread finished; awaiting finish of 2 more threads
-    2020-09-30 21:08:56,371 : INFO : worker thread finished; awaiting finish of 1 more threads
-    2020-09-30 21:08:56,373 : INFO : worker thread finished; awaiting finish of 0 more threads
-    2020-09-30 21:08:56,373 : INFO : EPOCH - 14 : training on 58152 raw words (42637 effective words) took 0.1s, 802259 effective words/s
-    2020-09-30 21:08:56,421 : INFO : worker thread finished; awaiting finish of 2 more threads
-    2020-09-30 21:08:56,425 : INFO : worker thread finished; awaiting finish of 1 more threads
-    2020-09-30 21:08:56,426 : INFO : worker thread finished; awaiting finish of 0 more threads
-    2020-09-30 21:08:56,426 : INFO : EPOCH - 15 : training on 58152 raw words (42686 effective words) took 0.1s, 820787 effective words/s
-    2020-09-30 21:08:56,475 : INFO : worker thread finished; awaiting finish of 2 more threads
-    2020-09-30 21:08:56,478 : INFO : worker thread finished; awaiting finish of 1 more threads
-    2020-09-30 21:08:56,479 : INFO : worker thread finished; awaiting finish of 0 more threads
-    2020-09-30 21:08:56,479 : INFO : EPOCH - 16 : training on 58152 raw words (42799 effective words) took 0.1s, 829690 effective words/s
-    2020-09-30 21:08:56,530 : INFO : worker thread finished; awaiting finish of 2 more threads
-    2020-09-30 21:08:56,530 : INFO : worker thread finished; awaiting finish of 1 more threads
-    2020-09-30 21:08:56,533 : INFO : worker thread finished; awaiting finish of 0 more threads
-    2020-09-30 21:08:56,534 : INFO : EPOCH - 17 : training on 58152 raw words (42733 effective words) took 0.1s, 794744 effective words/s
-    2020-09-30 21:08:56,583 : INFO : worker thread finished; awaiting finish of 2 more threads
-    2020-09-30 21:08:56,585 : INFO : worker thread finished; awaiting finish of 1 more threads
-    2020-09-30 21:08:56,587 : INFO : worker thread finished; awaiting finish of 0 more threads
-    2020-09-30 21:08:56,587 : INFO : EPOCH - 18 : training on 58152 raw words (42703 effective words) took 0.1s, 813146 effective words/s
-    2020-09-30 21:08:56,638 : INFO : worker thread finished; awaiting finish of 2 more threads
-    2020-09-30 21:08:56,640 : INFO : worker thread finished; awaiting finish of 1 more threads
-    2020-09-30 21:08:56,640 : INFO : worker thread finished; awaiting finish of 0 more threads
-    2020-09-30 21:08:56,641 : INFO : EPOCH - 19 : training on 58152 raw words (42763 effective words) took 0.1s, 822300 effective words/s
-    2020-09-30 21:08:56,696 : INFO : worker thread finished; awaiting finish of 2 more threads
-    2020-09-30 21:08:56,700 : INFO : worker thread finished; awaiting finish of 1 more threads
-    2020-09-30 21:08:56,700 : INFO : worker thread finished; awaiting finish of 0 more threads
-    2020-09-30 21:08:56,700 : INFO : EPOCH - 20 : training on 58152 raw words (42649 effective words) took 0.1s, 733047 effective words/s
-    2020-09-30 21:08:56,752 : INFO : worker thread finished; awaiting finish of 2 more threads
-    2020-09-30 21:08:56,753 : INFO : worker thread finished; awaiting finish of 1 more threads
-    2020-09-30 21:08:56,754 : INFO : worker thread finished; awaiting finish of 0 more threads
-    2020-09-30 21:08:56,754 : INFO : EPOCH - 21 : training on 58152 raw words (42701 effective words) took 0.1s, 822006 effective words/s
-    2020-09-30 21:08:56,803 : INFO : worker thread finished; awaiting finish of 2 more threads
-    2020-09-30 21:08:56,805 : INFO : worker thread finished; awaiting finish of 1 more threads
-    2020-09-30 21:08:56,805 : INFO : worker thread finished; awaiting finish of 0 more threads
-    2020-09-30 21:08:56,805 : INFO : EPOCH - 22 : training on 58152 raw words (42714 effective words) took 0.1s, 848390 effective words/s
-    2020-09-30 21:08:56,857 : INFO : worker thread finished; awaiting finish of 2 more threads
-    2020-09-30 21:08:56,857 : INFO : worker thread finished; awaiting finish of 1 more threads
-    2020-09-30 21:08:56,859 : INFO : worker thread finished; awaiting finish of 0 more threads
-    2020-09-30 21:08:56,860 : INFO : EPOCH - 23 : training on 58152 raw words (42740 effective words) took 0.1s, 811758 effective words/s
-    2020-09-30 21:08:56,907 : INFO : worker thread finished; awaiting finish of 2 more threads
-    2020-09-30 21:08:56,909 : INFO : worker thread finished; awaiting finish of 1 more threads
-    2020-09-30 21:08:56,910 : INFO : worker thread finished; awaiting finish of 0 more threads
-    2020-09-30 21:08:56,910 : INFO : EPOCH - 24 : training on 58152 raw words (42754 effective words) took 0.0s, 873741 effective words/s
-    2020-09-30 21:08:56,959 : INFO : worker thread finished; awaiting finish of 2 more threads
-    2020-09-30 21:08:56,960 : INFO : worker thread finished; awaiting finish of 1 more threads
-    2020-09-30 21:08:56,960 : INFO : worker thread finished; awaiting finish of 0 more threads
-    2020-09-30 21:08:56,960 : INFO : EPOCH - 25 : training on 58152 raw words (42704 effective words) took 0.0s, 862291 effective words/s
-    2020-09-30 21:08:57,009 : INFO : worker thread finished; awaiting finish of 2 more threads
-    2020-09-30 21:08:57,010 : INFO : worker thread finished; awaiting finish of 1 more threads
-    2020-09-30 21:08:57,011 : INFO : worker thread finished; awaiting finish of 0 more threads
-    2020-09-30 21:08:57,011 : INFO : EPOCH - 26 : training on 58152 raw words (42741 effective words) took 0.0s, 868076 effective words/s
-    2020-09-30 21:08:57,059 : INFO : worker thread finished; awaiting finish of 2 more threads
-    2020-09-30 21:08:57,062 : INFO : worker thread finished; awaiting finish of 1 more threads
-    2020-09-30 21:08:57,063 : INFO : worker thread finished; awaiting finish of 0 more threads
-    2020-09-30 21:08:57,063 : INFO : EPOCH - 27 : training on 58152 raw words (42610 effective words) took 0.1s, 830699 effective words/s
-    2020-09-30 21:08:57,112 : INFO : worker thread finished; awaiting finish of 2 more threads
-    2020-09-30 21:08:57,114 : INFO : worker thread finished; awaiting finish of 1 more threads
-    2020-09-30 21:08:57,115 : INFO : worker thread finished; awaiting finish of 0 more threads
-    2020-09-30 21:08:57,116 : INFO : EPOCH - 28 : training on 58152 raw words (42747 effective words) took 0.1s, 835959 effective words/s
-    2020-09-30 21:08:57,164 : INFO : worker thread finished; awaiting finish of 2 more threads
-    2020-09-30 21:08:57,169 : INFO : worker thread finished; awaiting finish of 1 more threads
-    2020-09-30 21:08:57,170 : INFO : worker thread finished; awaiting finish of 0 more threads
-    2020-09-30 21:08:57,170 : INFO : EPOCH - 29 : training on 58152 raw words (42755 effective words) took 0.1s, 804348 effective words/s
-    2020-09-30 21:08:57,219 : INFO : worker thread finished; awaiting finish of 2 more threads
-    2020-09-30 21:08:57,222 : INFO : worker thread finished; awaiting finish of 1 more threads
-    2020-09-30 21:08:57,224 : INFO : worker thread finished; awaiting finish of 0 more threads
-    2020-09-30 21:08:57,224 : INFO : EPOCH - 30 : training on 58152 raw words (42760 effective words) took 0.1s, 808636 effective words/s
-    2020-09-30 21:08:57,271 : INFO : worker thread finished; awaiting finish of 2 more threads
-    2020-09-30 21:08:57,273 : INFO : worker thread finished; awaiting finish of 1 more threads
-    2020-09-30 21:08:57,273 : INFO : worker thread finished; awaiting finish of 0 more threads
-    2020-09-30 21:08:57,273 : INFO : EPOCH - 31 : training on 58152 raw words (42727 effective words) took 0.0s, 889118 effective words/s
-    2020-09-30 21:08:57,323 : INFO : worker thread finished; awaiting finish of 2 more threads
-    2020-09-30 21:08:57,326 : INFO : worker thread finished; awaiting finish of 1 more threads
-    2020-09-30 21:08:57,327 : INFO : worker thread finished; awaiting finish of 0 more threads
-    2020-09-30 21:08:57,327 : INFO : EPOCH - 32 : training on 58152 raw words (42786 effective words) took 0.1s, 819149 effective words/s
-    2020-09-30 21:08:57,377 : INFO : worker thread finished; awaiting finish of 2 more threads
-    2020-09-30 21:08:57,378 : INFO : worker thread finished; awaiting finish of 1 more threads
-    2020-09-30 21:08:57,379 : INFO : worker thread finished; awaiting finish of 0 more threads
-    2020-09-30 21:08:57,379 : INFO : EPOCH - 33 : training on 58152 raw words (42614 effective words) took 0.1s, 828217 effective words/s
-    2020-09-30 21:08:57,427 : INFO : worker thread finished; awaiting finish of 2 more threads
-    2020-09-30 21:08:57,430 : INFO : worker thread finished; awaiting finish of 1 more threads
-    2020-09-30 21:08:57,431 : INFO : worker thread finished; awaiting finish of 0 more threads
-    2020-09-30 21:08:57,431 : INFO : EPOCH - 34 : training on 58152 raw words (42757 effective words) took 0.1s, 848700 effective words/s
-    2020-09-30 21:08:57,476 : INFO : worker thread finished; awaiting finish of 2 more threads
-    2020-09-30 21:08:57,479 : INFO : worker thread finished; awaiting finish of 1 more threads
-    2020-09-30 21:08:57,481 : INFO : worker thread finished; awaiting finish of 0 more threads
-    2020-09-30 21:08:57,481 : INFO : EPOCH - 35 : training on 58152 raw words (42713 effective words) took 0.0s, 881912 effective words/s
-    2020-09-30 21:08:57,530 : INFO : worker thread finished; awaiting finish of 2 more threads
-    2020-09-30 21:08:57,530 : INFO : worker thread finished; awaiting finish of 1 more threads
-    2020-09-30 21:08:57,532 : INFO : worker thread finished; awaiting finish of 0 more threads
-    2020-09-30 21:08:57,532 : INFO : EPOCH - 36 : training on 58152 raw words (42632 effective words) took 0.1s, 843930 effective words/s
-    2020-09-30 21:08:57,580 : INFO : worker thread finished; awaiting finish of 2 more threads
-    2020-09-30 21:08:57,583 : INFO : worker thread finished; awaiting finish of 1 more threads
-    2020-09-30 21:08:57,584 : INFO : worker thread finished; awaiting finish of 0 more threads
-    2020-09-30 21:08:57,584 : INFO : EPOCH - 37 : training on 58152 raw words (42691 effective words) took 0.1s, 851268 effective words/s
-    2020-09-30 21:08:57,632 : INFO : worker thread finished; awaiting finish of 2 more threads
-    2020-09-30 21:08:57,634 : INFO : worker thread finished; awaiting finish of 1 more threads
-    2020-09-30 21:08:57,635 : INFO : worker thread finished; awaiting finish of 0 more threads
-    2020-09-30 21:08:57,635 : INFO : EPOCH - 38 : training on 58152 raw words (42667 effective words) took 0.1s, 850589 effective words/s
-    2020-09-30 21:08:57,685 : INFO : worker thread finished; awaiting finish of 2 more threads
-    2020-09-30 21:08:57,686 : INFO : worker thread finished; awaiting finish of 1 more threads
-    2020-09-30 21:08:57,687 : INFO : worker thread finished; awaiting finish of 0 more threads
-    2020-09-30 21:08:57,687 : INFO : EPOCH - 39 : training on 58152 raw words (42641 effective words) took 0.1s, 843857 effective words/s
-    2020-09-30 21:08:57,736 : INFO : worker thread finished; awaiting finish of 2 more threads
-    2020-09-30 21:08:57,737 : INFO : worker thread finished; awaiting finish of 1 more threads
-    2020-09-30 21:08:57,741 : INFO : worker thread finished; awaiting finish of 0 more threads
-    2020-09-30 21:08:57,741 : INFO : EPOCH - 40 : training on 58152 raw words (42721 effective words) took 0.1s, 807691 effective words/s
-    2020-09-30 21:08:57,741 : INFO : training on a 2326080 raw words (1708575 effective words) took 2.2s, 781245 effective words/s
-
-
-
+    2022-12-07 10:59:01,272 : INFO : Doc2Vec lifecycle event {'msg': 'training model with 3 workers on 3955 vocabulary and 50 features, using sg=0 hs=0 sample=0.001 negative=5 window=5 shrink_windows=True', 'datetime': '2022-12-07T10:59:01.271863', 'gensim': '4.2.1.dev0', 'python': '3.8.10 (default, Jun 22 2022, 20:18:18) \n[GCC 9.4.0]', 'platform': 'Linux-5.4.0-135-generic-x86_64-with-glibc2.29', 'event': 'train'}
+    2022-12-07 10:59:01,408 : INFO : EPOCH 0: training on 58152 raw words (42665 effective words) took 0.1s, 335294 effective words/s
+    2022-12-07 10:59:01,462 : INFO : EPOCH 1: training on 58152 raw words (42755 effective words) took 0.1s, 816420 effective words/s
+    2022-12-07 10:59:01,521 : INFO : EPOCH 2: training on 58152 raw words (42692 effective words) took 0.1s, 745004 effective words/s
+    2022-12-07 10:59:01,573 : INFO : EPOCH 3: training on 58152 raw words (42670 effective words) took 0.1s, 841368 effective words/s
+    2022-12-07 10:59:01,627 : INFO : EPOCH 4: training on 58152 raw words (42685 effective words) took 0.1s, 815442 effective words/s
+    2022-12-07 10:59:01,703 : INFO : EPOCH 5: training on 58152 raw words (42709 effective words) took 0.1s, 578402 effective words/s
+    2022-12-07 10:59:01,753 : INFO : EPOCH 6: training on 58152 raw words (42594 effective words) took 0.0s, 864899 effective words/s
+    2022-12-07 10:59:01,804 : INFO : EPOCH 7: training on 58152 raw words (42721 effective words) took 0.0s, 864073 effective words/s
+    2022-12-07 10:59:01,881 : INFO : EPOCH 8: training on 58152 raw words (42622 effective words) took 0.1s, 566867 effective words/s
+    2022-12-07 10:59:01,932 : INFO : EPOCH 9: training on 58152 raw words (42770 effective words) took 0.0s, 862066 effective words/s
+    2022-12-07 10:59:02,006 : INFO : EPOCH 10: training on 58152 raw words (42739 effective words) took 0.1s, 587035 effective words/s
+    2022-12-07 10:59:02,058 : INFO : EPOCH 11: training on 58152 raw words (42612 effective words) took 0.1s, 850879 effective words/s
+    2022-12-07 10:59:02,135 : INFO : EPOCH 12: training on 58152 raw words (42655 effective words) took 0.1s, 566216 effective words/s
+    2022-12-07 10:59:02,187 : INFO : EPOCH 13: training on 58152 raw words (42749 effective words) took 0.1s, 844125 effective words/s
+    2022-12-07 10:59:02,265 : INFO : EPOCH 14: training on 58152 raw words (42748 effective words) took 0.1s, 556136 effective words/s
+    2022-12-07 10:59:02,347 : INFO : EPOCH 15: training on 58152 raw words (42748 effective words) took 0.1s, 530528 effective words/s
+    2022-12-07 10:59:02,398 : INFO : EPOCH 16: training on 58152 raw words (42737 effective words) took 0.0s, 871200 effective words/s
+    2022-12-07 10:59:02,485 : INFO : EPOCH 17: training on 58152 raw words (42697 effective words) took 0.1s, 499981 effective words/s
+    2022-12-07 10:59:02,584 : INFO : EPOCH 18: training on 58152 raw words (42747 effective words) took 0.1s, 440730 effective words/s
+    2022-12-07 10:59:02,672 : INFO : EPOCH 19: training on 58152 raw words (42739 effective words) took 0.1s, 497651 effective words/s
+    2022-12-07 10:59:02,761 : INFO : EPOCH 20: training on 58152 raw words (42782 effective words) took 0.1s, 499103 effective words/s
+    2022-12-07 10:59:02,851 : INFO : EPOCH 21: training on 58152 raw words (42580 effective words) took 0.1s, 489515 effective words/s
+    2022-12-07 10:59:02,939 : INFO : EPOCH 22: training on 58152 raw words (42687 effective words) took 0.1s, 496560 effective words/s
+    2022-12-07 10:59:03,023 : INFO : EPOCH 23: training on 58152 raw words (42667 effective words) took 0.1s, 517527 effective words/s
+    2022-12-07 10:59:03,156 : INFO : EPOCH 24: training on 58152 raw words (42678 effective words) took 0.1s, 328575 effective words/s
+    2022-12-07 10:59:03,322 : INFO : EPOCH 25: training on 58152 raw words (42743 effective words) took 0.2s, 261440 effective words/s
+    2022-12-07 10:59:03,486 : INFO : EPOCH 26: training on 58152 raw words (42692 effective words) took 0.2s, 266564 effective words/s
+    2022-12-07 10:59:03,627 : INFO : EPOCH 27: training on 58152 raw words (42774 effective words) took 0.1s, 310530 effective words/s
+    2022-12-07 10:59:03,770 : INFO : EPOCH 28: training on 58152 raw words (42706 effective words) took 0.1s, 305665 effective words/s
+    2022-12-07 10:59:03,901 : INFO : EPOCH 29: training on 58152 raw words (42658 effective words) took 0.1s, 334228 effective words/s
+    2022-12-07 10:59:04,028 : INFO : EPOCH 30: training on 58152 raw words (42746 effective words) took 0.1s, 344379 effective words/s
+    2022-12-07 10:59:04,159 : INFO : EPOCH 31: training on 58152 raw words (42676 effective words) took 0.1s, 334291 effective words/s
+    2022-12-07 10:59:04,295 : INFO : EPOCH 32: training on 58152 raw words (42763 effective words) took 0.1s, 322886 effective words/s
+    2022-12-07 10:59:04,488 : INFO : EPOCH 33: training on 58152 raw words (42647 effective words) took 0.2s, 224522 effective words/s
+    2022-12-07 10:59:04,629 : INFO : EPOCH 34: training on 58152 raw words (42720 effective words) took 0.1s, 310616 effective words/s
+    2022-12-07 10:59:04,764 : INFO : EPOCH 35: training on 58152 raw words (42775 effective words) took 0.1s, 323299 effective words/s
+    2022-12-07 10:59:04,899 : INFO : EPOCH 36: training on 58152 raw words (42662 effective words) took 0.1s, 322458 effective words/s
+    2022-12-07 10:59:05,032 : INFO : EPOCH 37: training on 58152 raw words (42656 effective words) took 0.1s, 329126 effective words/s
+    2022-12-07 10:59:05,162 : INFO : EPOCH 38: training on 58152 raw words (42720 effective words) took 0.1s, 337238 effective words/s
+    2022-12-07 10:59:05,308 : INFO : EPOCH 39: training on 58152 raw words (42688 effective words) took 0.1s, 299620 effective words/s
+    2022-12-07 10:59:05,308 : INFO : Doc2Vec lifecycle event {'msg': 'training on 2326080 raw words (1708074 effective words) took 4.0s, 423332 effective words/s', 'datetime': '2022-12-07T10:59:05.308684', 'gensim': '4.2.1.dev0', 'python': '3.8.10 (default, Jun 22 2022, 20:18:18) \n[GCC 9.4.0]', 'platform': 'Linux-5.4.0-135-generic-x86_64-with-glibc2.29', 'event': 'train'}
+
+
+
+
+.. GENERATED FROM PYTHON SOURCE LINES 231-235
 
 Now, we can use the trained model to infer a vector for any piece of text
 by passing a list of words to the ``model.infer_vector`` function. This
 vector can then be compared with other vectors via cosine similarity.
 
 
+.. GENERATED FROM PYTHON SOURCE LINES 235-238
 
 .. code-block:: default
 
@@ -548,22 +468,22 @@ vector can then be compared with other vectors via cosine similarity.
 
 .. rst-class:: sphx-glr-script-out
 
- Out:
-
  .. code-block:: none
 
-    [-0.08478509  0.05011684  0.0675064  -0.19926868 -0.1235586   0.01768214
-     -0.12645927  0.01062329  0.06113973  0.35424358  0.01320948  0.07561274
-     -0.01645093  0.0692549   0.08346193 -0.01599065  0.08287009 -0.0139379
-     -0.17772709 -0.26271465  0.0442089  -0.04659882 -0.12873884  0.28799203
-     -0.13040264  0.12478471 -0.14091878 -0.09698066 -0.07903259 -0.10124907
-     -0.28239366  0.13270256  0.04445919 -0.24210942 -0.1907376  -0.07264525
-     -0.14167067 -0.22816683 -0.00663796  0.23165748 -0.10436232 -0.01028251
-     -0.04064698  0.08813146  0.01072008 -0.149789    0.05923386  0.16301566
-      0.05815683  0.1258063 ]
+    [-0.10196274 -0.36020595 -0.10973375  0.28432116 -0.00792601  0.01950991
+      0.01309869  0.1045896  -0.2011485  -0.12135196  0.15298457  0.05421316
+     -0.06486023 -0.00131951 -0.2237759  -0.08489189  0.05889525  0.27961093
+      0.08121023 -0.06200862 -0.00651888 -0.06831821  0.13001564  0.04539844
+     -0.01659351 -0.02359444 -0.22276032  0.06692155 -0.11293832 -0.08056813
+      0.38737044  0.05470002  0.19902836  0.19122775  0.17020799  0.10668964
+      0.01216549 -0.3049222  -0.05198798  0.00130251  0.04994885 -0.0069596
+     -0.06367141 -0.11740001  0.14623125  0.10109582 -0.06466878 -0.06512908
+      0.17817481 -0.00934212]
+
 
 
 
+.. GENERATED FROM PYTHON SOURCE LINES 239-247
 
 Note that ``infer_vector()`` does *not* take a string, but rather a list of
 string tokens, which should have already been tokenized the same way as the
@@ -574,6 +494,8 @@ iterative approximation problem that makes use of internal randomization,
 repeated inferences of the same text will return slightly different vectors.
 
 
+.. GENERATED FROM PYTHON SOURCE LINES 249-262
+
 Assessing the Model
 -------------------
 
@@ -588,6 +510,7 @@ Additionally, we'll keep track of the second ranks for a comparison of less
 similar documents.
 
 
+.. GENERATED FROM PYTHON SOURCE LINES 262-272
 
 .. code-block:: default
 
@@ -608,10 +531,13 @@ similar documents.
 
 
 
+.. GENERATED FROM PYTHON SOURCE LINES 273-276
+
 Let's count how each document ranks with respect to the training corpus
 
 NB. Results vary between runs due to random seeding and very small corpus
 
+.. GENERATED FROM PYTHON SOURCE LINES 276-281
 
 .. code-block:: default
 
@@ -626,8 +552,6 @@ NB. Results vary between runs due to random seeding and very small corpus
 
 .. rst-class:: sphx-glr-script-out
 
- Out:
-
  .. code-block:: none
 
     Counter({0: 292, 1: 8})
@@ -635,6 +559,8 @@ NB. Results vary between runs due to random seeding and very small corpus
 
 
 
+.. GENERATED FROM PYTHON SOURCE LINES 282-290
+
 Basically, greater than 95% of the inferred documents are found to be most
 similar to itself and about 5% of the time it is mistakenly most similar to
 another document. Checking the inferred-vector against a
@@ -644,6 +570,7 @@ behaving in a usefully consistent manner, though not a real 'accuracy' value.
 This is great and not entirely surprising. We can take a look at an example:
 
 
+.. GENERATED FROM PYTHON SOURCE LINES 290-295
 
 .. code-block:: default
 
@@ -658,26 +585,26 @@ This is great and not entirely surprising. We can take a look at an example:
 
 .. rst-class:: sphx-glr-script-out
 
- Out:
-
  .. code-block:: none
 
     Document (299): «australia will take on france in the doubles rubber of the davis cup tennis final today with the tie levelled at wayne arthurs and todd woodbridge are scheduled to lead australia in the doubles against cedric pioline and fabrice santoro however changes can be made to the line up up to an hour before the match and australian team captain john fitzgerald suggested he might do just that we ll make team appraisal of the whole situation go over the pros and cons and make decision french team captain guy forget says he will not make changes but does not know what to expect from australia todd is the best doubles player in the world right now so expect him to play he said would probably use wayne arthurs but don know what to expect really pat rafter salvaged australia davis cup campaign yesterday with win in the second singles match rafter overcame an arm injury to defeat french number one sebastien grosjean in three sets the australian says he is happy with his form it not very pretty tennis there isn too many consistent bounces you are playing like said bit of classic old grass court rafter said rafter levelled the score after lleyton hewitt shock five set loss to nicholas escude in the first singles rubber but rafter says he felt no added pressure after hewitt defeat knew had good team to back me up even if we were down he said knew could win on the last day know the boys can win doubles so even if we were down still feel we are good enough team to win and vice versa they are good enough team to beat us as well»
 
-    SIMILAR/DISSIMILAR DOCS PER MODEL Doc2Vec(dm/m,d50,n5,w5,mc2,s0.001,t3):
+    SIMILAR/DISSIMILAR DOCS PER MODEL Doc2Vec<dm/m,d50,n5,w5,mc2,s0.001,t3>:
 
-    MOST (299, 0.9482713341712952): «australia will take on france in the doubles rubber of the davis cup tennis final today with the tie levelled at wayne arthurs and todd woodbridge are scheduled to lead australia in the doubles against cedric pioline and fabrice santoro however changes can be made to the line up up to an hour before the match and australian team captain john fitzgerald suggested he might do just that we ll make team appraisal of the whole situation go over the pros and cons and make decision french team captain guy forget says he will not make changes but does not know what to expect from australia todd is the best doubles player in the world right now so expect him to play he said would probably use wayne arthurs but don know what to expect really pat rafter salvaged australia davis cup campaign yesterday with win in the second singles match rafter overcame an arm injury to defeat french number one sebastien grosjean in three sets the australian says he is happy with his form it not very pretty tennis there isn too many consistent bounces you are playing like said bit of classic old grass court rafter said rafter levelled the score after lleyton hewitt shock five set loss to nicholas escude in the first singles rubber but rafter says he felt no added pressure after hewitt defeat knew had good team to back me up even if we were down he said knew could win on the last day know the boys can win doubles so even if we were down still feel we are good enough team to win and vice versa they are good enough team to beat us as well»
+    MOST (299, 0.9564058780670166): «australia will take on france in the doubles rubber of the davis cup tennis final today with the tie levelled at wayne arthurs and todd woodbridge are scheduled to lead australia in the doubles against cedric pioline and fabrice santoro however changes can be made to the line up up to an hour before the match and australian team captain john fitzgerald suggested he might do just that we ll make team appraisal of the whole situation go over the pros and cons and make decision french team captain guy forget says he will not make changes but does not know what to expect from australia todd is the best doubles player in the world right now so expect him to play he said would probably use wayne arthurs but don know what to expect really pat rafter salvaged australia davis cup campaign yesterday with win in the second singles match rafter overcame an arm injury to defeat french number one sebastien grosjean in three sets the australian says he is happy with his form it not very pretty tennis there isn too many consistent bounces you are playing like said bit of classic old grass court rafter said rafter levelled the score after lleyton hewitt shock five set loss to nicholas escude in the first singles rubber but rafter says he felt no added pressure after hewitt defeat knew had good team to back me up even if we were down he said knew could win on the last day know the boys can win doubles so even if we were down still feel we are good enough team to win and vice versa they are good enough team to beat us as well»
 
-    SECOND-MOST (104, 0.8029672503471375): «australian cricket captain steve waugh has supported fast bowler brett lee after criticism of his intimidatory bowling to the south african tailenders in the first test in adelaide earlier this month lee was fined for giving new zealand tailender shane bond an unsportsmanlike send off during the third test in perth waugh says tailenders should not be protected from short pitched bowling these days you re earning big money you ve got responsibility to learn how to bat he said mean there no times like years ago when it was not professional and sort of bowlers code these days you re professional our batsmen work very hard at their batting and expect other tailenders to do likewise meanwhile waugh says his side will need to guard against complacency after convincingly winning the first test by runs waugh says despite the dominance of his side in the first test south africa can never be taken lightly it only one test match out of three or six whichever way you want to look at it so there lot of work to go he said but it nice to win the first battle definitely it gives us lot of confidence going into melbourne you know the big crowd there we love playing in front of the boxing day crowd so that will be to our advantage as well south africa begins four day match against new south wales in sydney on thursday in the lead up to the boxing day test veteran fast bowler allan donald will play in the warm up match and is likely to take his place in the team for the second test south african captain shaun pollock expects much better performance from his side in the melbourne test we still believe that we didn play to our full potential so if we can improve on our aspects the output we put out on the field will be lot better and we still believe we have side that is good enough to beat australia on our day he said»
+    SECOND-MOST (104, 0.7868924140930176): «australian cricket captain steve waugh has supported fast bowler brett lee after criticism of his intimidatory bowling to the south african tailenders in the first test in adelaide earlier this month lee was fined for giving new zealand tailender shane bond an unsportsmanlike send off during the third test in perth waugh says tailenders should not be protected from short pitched bowling these days you re earning big money you ve got responsibility to learn how to bat he said mean there no times like years ago when it was not professional and sort of bowlers code these days you re professional our batsmen work very hard at their batting and expect other tailenders to do likewise meanwhile waugh says his side will need to guard against complacency after convincingly winning the first test by runs waugh says despite the dominance of his side in the first test south africa can never be taken lightly it only one test match out of three or six whichever way you want to look at it so there lot of work to go he said but it nice to win the first battle definitely it gives us lot of confidence going into melbourne you know the big crowd there we love playing in front of the boxing day crowd so that will be to our advantage as well south africa begins four day match against new south wales in sydney on thursday in the lead up to the boxing day test veteran fast bowler allan donald will play in the warm up match and is likely to take his place in the team for the second test south african captain shaun pollock expects much better performance from his side in the melbourne test we still believe that we didn play to our full potential so if we can improve on our aspects the output we put out on the field will be lot better and we still believe we have side that is good enough to beat australia on our day he said»
 
-    MEDIAN (238, 0.2635717988014221): «centrelink is urging people affected by job cuts at regional pay tv operator austar and travel company traveland to seek information about their income support options traveland has announced it is shedding more than jobs around australia and austar is letting employees go centrelink finance information officer peter murray says those facing uncertain futures should head to centrelink in the next few days centrelink is the shopfront now for commonwealth services for income support and the employment network so that it is important if people haven been to us before they might get pleasant surprise at the range of services that we do offer to try and help them through situations where things might have changed for them mr murray said»
+    MEDIAN (119, 0.24808582663536072): «australia is continuing to negotiate with the united states government in an effort to interview the australian david hicks who was captured fighting alongside taliban forces in afghanistan mr hicks is being held by the united states on board ship in the afghanistan region where the australian federal police and australian security intelligence organisation asio officials are trying to gain access foreign affairs minister alexander downer has also confirmed that the australian government is investigating reports that another australian has been fighting for taliban forces in afghanistan we often get reports of people going to different parts of the world and asking us to investigate them he said we always investigate sometimes it is impossible to find out we just don know in this case but it is not to say that we think there are lot of australians in afghanistan the only case we know is hicks mr downer says it is unclear when mr hicks will be back on australian soil but he is hopeful the americans will facilitate australian authorities interviewing him»
 
-    LEAST (243, -0.13247375190258026): «four afghan factions have reached agreement on an interim cabinet during talks in germany the united nations says the administration which will take over from december will be headed by the royalist anti taliban commander hamed karzai it concludes more than week of negotiations outside bonn and is aimed at restoring peace and stability to the war ravaged country the year old former deputy foreign minister who is currently battling the taliban around the southern city of kandahar is an ally of the exiled afghan king mohammed zahir shah he will serve as chairman of an interim authority that will govern afghanistan for six month period before loya jirga or grand traditional assembly of elders in turn appoints an month transitional government meanwhile united states marines are now reported to have been deployed in eastern afghanistan where opposition forces are closing in on al qaeda soldiers reports from the area say there has been gun battle between the opposition and al qaeda close to the tora bora cave complex where osama bin laden is thought to be hiding in the south of the country american marines are taking part in patrols around the air base they have secured near kandahar but are unlikely to take part in any assault on the city however the chairman of the joint chiefs of staff general richard myers says they are prepared for anything they are prepared for engagements they re robust fighting force and they re absolutely ready to engage if that required he said»
+    LEAST (216, -0.11085141450166702): «senior taliban official confirmed the islamic militia would begin handing over its last bastion of kandahar to pashtun tribal leaders on friday this agreement was that taliban should surrender kandahar peacefully to the elders of these areas and we should guarantee the lives and the safety of taliban authorities and all the taliban from tomorrow should start this program former taliban ambassador to pakistan abdul salam zaeef told cnn in telephone interview he insisted that the taliban would not surrender to hamid karzai the new afghan interim leader and pashtun elder who has been cooperating with the united states to calm unrest among the southern tribes the taliban will surrender to elders not to karzai karzai and other persons which they want to enter kandahar by the support of america they don allow to enter kandahar city he said the taliban will surrender the weapons the ammunition to elders»
 
 
 
 
 
+.. GENERATED FROM PYTHON SOURCE LINES 296-305
+
 Notice above that the most similar document (usually the same text) is has a
 similarity score approaching 1.0. However, the similarity score for the
 second-ranked documents should be significantly lower (assuming the documents
@@ -688,6 +615,7 @@ We can run the next cell repeatedly to see a sampling other target-document
 comparisons.
 
 
+.. GENERATED FROM PYTHON SOURCE LINES 305-315
 
 .. code-block:: default
 
@@ -707,17 +635,17 @@ comparisons.
 
 .. rst-class:: sphx-glr-script-out
 
- Out:
-
  .. code-block:: none
 
-    Train Document (292): «rival afghan factions are deadlocked over the shape of future government the northern alliance has demanded day adjournment of power sharing talks in germany after its president burhanuddin rabbani objected to the appointment system for an interim administration president rabbani has objected to the plans for an interim government to be drawn up by appointment as discussed in bonn saying the interim leaders should be voted in by afghans themselves he also says there is no real need for sizeable international security force president rabbani says he would prefer local afghan factions drew up their own internal security forces of around personnel but if the world insisted there should be an international security presence there should be no more than or personnel in their security forces he says president rabbani objections are likely to cast doubt on his delegation ability to commit the northern alliance to any course of action decided upon in bonn he now threatens to undermine the very process he claims to support in the quest for stable government in afghanistan»
+    Train Document (198): «authorities are trying to track down the crew of vessel that landed undetected at cocos islands carrying asylum seekers the group of sri lankan men was found aboard their boat moored to the south of the islands yesterday afternoon shire president ron grant says investigations are underway as to the whereabouts of the crew after the asylum seekers told authorities they had left in another boat after dropping them off unfortunately for them there two aircraft the royal australian air force here at the moment and one getting prepared to fly off and obviously they will be looking to see if there is another boat he said mr grant says the sri lankans have not yet been brought ashore»
+
+    Similar Document (89, 0.7137947082519531): «after the torching of more than buildings over the past three days the situation at the woomera detention centre overnight appeared relatively calm there was however tension inside the south australian facility with up to detainees breaking into prohibited zone the group became problem for staff after breaching fence within the centre at one point staff considered using water cannon to control the detainees it is not known if they actually resorted to any tough action but group of men wearing riot gear possibly star force police officers brought in on standby could be seen in one of the compounds late yesterday government authorities confirmed that two detainees had committed acts of self harm one of them needed stitches and is believed to have been taken away in an ambulance no other details have been released»
 
-    Similar Document (13, 0.7867921590805054): «talks between afghan and british officials in kabul have ended without final agreement on the deployment of international security force the lack of suitable translation of the document meant further delay authorities in kabul have been giving conflicting signals for weeks now over the number of peacekeepers they would allow and the role the international force would play the foreign minister dr abdullah appeared to be ending the confusion saying an agreement was about to be signed there is already the agreement so it was finalised he said but spokesman for the interior minister yunis kanooni emerged soon after to say there was no agreement and nothing to sign scores of british peacekeepers are already patrolling the streets of kabul in tandem with afghan police but proposals to enlarge the force to as many as international peacekeepers have been criticised by some commanders as tantamount to foreign occupation»
 
 
 
 
+.. GENERATED FROM PYTHON SOURCE LINES 316-322
 
 Testing the Model
 -----------------
@@ -726,6 +654,7 @@ Using the same approach above, we'll infer the vector for a randomly chosen
 test document, and compare the document to our model by eye.
 
 
+.. GENERATED FROM PYTHON SOURCE LINES 322-334
 
 .. code-block:: default
 
@@ -747,23 +676,23 @@ test document, and compare the document to our model by eye.
 
 .. rst-class:: sphx-glr-script-out
 
- Out:
-
  .. code-block:: none
 
-    Test Document (49): «labor needed to distinguish itself from the government on the issue of asylum seekers greens leader bob brown has said his senate colleague kerry nettle intends to move motion today on the first anniversary of the tampa crisis condemning the government over its refugee policy and calling for an end to mandatory detention we greens want to bring the government to book over its serial breach of international obligations as far as asylum seekers in this country are concerned senator brown said today»
+    Test Document (17): «the united nations world food program estimates that up to million people in seven countries malawi mozambique zambia angola swaziland lesotho and zimbabwe face death by starvation unless there is massive international response in malawi as many as people may have already died the signs of malnutrition swollen stomachs stick thin arms light coloured hair are everywhere»
+
+    SIMILAR/DISSIMILAR DOCS PER MODEL Doc2Vec<dm/m,d50,n5,w5,mc2,s0.001,t3>:
 
-    SIMILAR/DISSIMILAR DOCS PER MODEL Doc2Vec(dm/m,d50,n5,w5,mc2,s0.001,t3):
+    MOST (86, 0.8239533305168152): «argentina economy minister domingo cavallo is reported to have resigned in the face of mounting unrest over the country crumbling economy the reports in number of local media outlets could not be officially confirmed the news comes as police used teargas to disperse tens of thousands of people who had massed near the presidential palace in buenos aires and in other parts of the city to protest against the declaration of state of emergency it was declared after mounting popular discontent and widespread looting in the past few days with people over the state of the economy which has been in recession for four years»
 
-    MOST (218, 0.8016394376754761): «refugee support groups are strongly critical of federal government claims that the pacific solution program is working well the immigration minister philip ruddock says he is pleased with the program which uses pacific island nations to process asylum seekers wanting to come to australia president of the hazara ethnic society of australia hassan ghulam says the australian government is bullying smaller nations into accepting asylum seekers if the pacific countries wanted refugees they can clearly raise their voice in the united nations and say yes we are accepting refugees and why australia who gives this authority to the australian government to force the pacific countries to accept refugees in this form or in the other form he asked»
+    MEDIAN (221, 0.40627941489219666): «reserve bank governor ian macfarlane says he is confident australia will ride through the current world economic slump largely brought on by the united states mr macfarlane told gathering in sydney last night australia growth is remarkably good by world standards and inflation should come down in the next months he predicts the united states economy will show signs of recovery from mid year and that as result it is highly unlikely that the reserve bank will raise interest rates in the next six months calendar year has been difficult one for the world economy and the first half of looks like remaining weak before recovery gets underway therefore this period will be classified as world recession like those of the mid the early and the early mr macfarlane said the australian economy has got through the first half of it in reasonably good shape»
 
-    MEDIAN (204, 0.3319269120693207): «an iraqi doctor being held at sydney villawood detention centre claims he was prevented from receiving human rights award dr aamer sultan had been awarded special commendation at yesterday human rights and equal opportunity commission awards in sydney but was not able to receive the honour in person dr sultan says he had been hoping to attend the ceremony but says the management at villawood stopped him from going submitted formal request to the centre manager who promised me that he will present the matter to migration management here who are the main authority here they also came back that unfortunately we can not fulfill this request for you but they didn give any explanation dr sultan says he was disappointed by the decision the immigration minister philip ruddock has written letter of complaint to the medical journal of australia about an article penned by dr sultan on the psychological state of detainees at villawood the journal has published research dr sultan conducted with former visiting psychologist to the centre kevin sullivan their survey of detainees over nine months found all but one displayed symptoms of psychological distress at some time the article says per cent acknowledged chronic depressive symptoms and close to half of the group had reached severe stages of depression»
+    LEAST (37, -0.06813289225101471): «australia quicks and opening batsmen have put the side in dominant position going into day three of the boxing day test match against south africa at the mcg australia is no wicket for only runs shy of south africa after andy bichel earlier starred as the tourists fell for when play was abandoned due to rain few overs short of scheduled stumps yesterday justin langer was not out and matthew hayden the openers went on the attack from the start with langer innings including six fours and hayden eight earlier shaun pollock and nantie haywood launched vital rearguard action to help south africa to respectable first innings total the pair put on runs for the final wicket to help the tourists to the south africans had slumped to for through combination of australia good bowling good fielding and good luck after resuming at for yesterday morning the tourists looked to be cruising as jacques kallis and neil mckenzie added without loss but then bichel suddenly had them reeling after snatching two wickets in two balls first he had jacques kallis caught behind for although kallis could consider himself very unlucky as replays showed his bat was long way from the ball on the next ball bichel snatched sharp return catch to dismiss lance klusener first ball and have shot at hat trick bichel missed out on the hat trick and mark boucher and neil mckenzie again steadied the south african innings adding before the introduction of part timer mark waugh to the attack paid off for australia waugh removed boucher for caught by bichel brett lee then chipped in trapping mckenzie leg before for with perfect inswinger bichel continued his good day in the field running out claude henderson for with direct hit from the in field lee roared in to allan donald bouncing him and then catching the edge with rising delivery which ricky ponting happily swallowed at third slip to remove the returning paceman for duck bichel did not get his hat trick but ended with the best figures of the australian bowlers after also picking up the final wicket of nantie haywood for lee took for and glenn mcgrath for»
 
-    LEAST (157, -0.10524928569793701): «british man has been found guilty by unanimous verdict of the kidnap and murder of an eight year old schoolgirl whose death in july shocked britain and set off rampage of anti paedophile vigilantes roy whiting was sentenced to life imprisonment for the abduction and murder of eight year old sarah payne with recommendation by trial judge justice richard curtis that he never be released you are indeed an evil man you are in no way mentally unwell have seen you for month and in my view you are glib and cunning liar justice curtis said there were cheers of delight as the verdicts were read out by the foreman at lewes crown court the jury of nine men and three women had been deliberating for nine hours as soon as the verdicts were declared the court heard details of whiting previous conviction for the kidnap and indecent assault of nine year old girl in prosecutor timothy langdale told the jury how the defendant threw the child into the back of his dirty red ford sierra and locked the doors he had driven her somewhere she didn know where when she asked where they were going he said shut up because he had knife mr langdale said the defendant told the girl to take off her clothes when she refused he produced rope from his pocket and threatened to tie her up what he actually threatened was that he would tie her mouth up she took her clothes off as he had ordered her to do mr langdale then gave graphic details of the abuse to which whiting subjected the terrified child whiting was given four year jail sentence in june after admitting carrying out the attack in march that year but he was released in november despite warnings from probation officers who were convinced there was danger he would attack another child they set out their warnings in pre sentence report prepared after the first assault and in the parole report before he was released from prison he was kept under supervision for four months after his release but was not being monitored by july last year when eight year old sarah was abducted and killed whiting has been arrested three times in connection with the case but the first and second times was released without being charged sarah disappeared on july last year prompting massive police search her partially buried naked body was found days later in field and police believe she was strangled or suffocated»
 
 
 
 
+.. GENERATED FROM PYTHON SOURCE LINES 335-360
 
 Conclusion
 ----------
@@ -794,30 +723,25 @@ If you'd like to know more about the subject matter of this tutorial, check out
 
 .. rst-class:: sphx-glr-timing
 
-   **Total running time of the script:** ( 0 minutes  7.863 seconds)
+   **Total running time of the script:** ( 0 minutes  16.509 seconds)
 
-**Estimated memory usage:**  37 MB
+**Estimated memory usage:**  48 MB
 
 
 .. _sphx_glr_download_auto_examples_tutorials_run_doc2vec_lee.py:
 
+.. only:: html
 
-.. only :: html
-
- .. container:: sphx-glr-footer
-    :class: sphx-glr-footer-example
-
-
-
-  .. container:: sphx-glr-download sphx-glr-download-python
+  .. container:: sphx-glr-footer sphx-glr-footer-example
 
-     :download:`Download Python source code: run_doc2vec_lee.py <run_doc2vec_lee.py>`
 
+    .. container:: sphx-glr-download sphx-glr-download-python
 
+      :download:`Download Python source code: run_doc2vec_lee.py <run_doc2vec_lee.py>`
 
-  .. container:: sphx-glr-download sphx-glr-download-jupyter
+    .. container:: sphx-glr-download sphx-glr-download-jupyter
 
-     :download:`Download Jupyter notebook: run_doc2vec_lee.ipynb <run_doc2vec_lee.ipynb>`
+      :download:`Download Jupyter notebook: run_doc2vec_lee.ipynb <run_doc2vec_lee.ipynb>`
 
 
 .. only:: html
diff --git a/docs/src/auto_examples/tutorials/sg_execution_times.rst b/docs/src/auto_examples/tutorials/sg_execution_times.rst
index 0b10d0ae69..eb3d2c3c8c 100644
--- a/docs/src/auto_examples/tutorials/sg_execution_times.rst
+++ b/docs/src/auto_examples/tutorials/sg_execution_times.rst
@@ -5,22 +5,21 @@
 
 Computation times
 =================
-**00:36.418** total execution time for **auto_examples_tutorials** files:
 
-+-------------------------------------------------------------------------------------+-----------+-----------+
-| :ref:`sphx_glr_auto_examples_tutorials_run_wmd.py` (``run_wmd.py``)                 | 00:36.418 | 7551.3 MB |
-+-------------------------------------------------------------------------------------+-----------+-----------+
-| :ref:`sphx_glr_auto_examples_tutorials_run_annoy.py` (``run_annoy.py``)             | 00:00.000 | 0.0 MB    |
-+-------------------------------------------------------------------------------------+-----------+-----------+
-| :ref:`sphx_glr_auto_examples_tutorials_run_doc2vec_lee.py` (``run_doc2vec_lee.py``) | 00:00.000 | 0.0 MB    |
-+-------------------------------------------------------------------------------------+-----------+-----------+
-| :ref:`sphx_glr_auto_examples_tutorials_run_ensemblelda.py` (``run_ensemblelda.py``) | 00:00.000 | 0.0 MB    |
-+-------------------------------------------------------------------------------------+-----------+-----------+
-| :ref:`sphx_glr_auto_examples_tutorials_run_fasttext.py` (``run_fasttext.py``)       | 00:00.000 | 0.0 MB    |
-+-------------------------------------------------------------------------------------+-----------+-----------+
-| :ref:`sphx_glr_auto_examples_tutorials_run_lda.py` (``run_lda.py``)                 | 00:00.000 | 0.0 MB    |
-+-------------------------------------------------------------------------------------+-----------+-----------+
-| :ref:`sphx_glr_auto_examples_tutorials_run_scm.py` (``run_scm.py``)                 | 00:00.000 | 0.0 MB    |
-+-------------------------------------------------------------------------------------+-----------+-----------+
-| :ref:`sphx_glr_auto_examples_tutorials_run_word2vec.py` (``run_word2vec.py``)       | 00:00.000 | 0.0 MB    |
-+-------------------------------------------------------------------------------------+-----------+-----------+
++-------------------------------------------------------------------------------------+-----------+---------+
+| :ref:`sphx_glr_auto_examples_tutorials_run_doc2vec_lee.py` (``run_doc2vec_lee.py``) | 00:16.509 | 48.4 MB |
++-------------------------------------------------------------------------------------+-----------+---------+
+| :ref:`sphx_glr_auto_examples_tutorials_run_annoy.py` (``run_annoy.py``)             | 00:00.000 | 0.0 MB  |
++-------------------------------------------------------------------------------------+-----------+---------+
+| :ref:`sphx_glr_auto_examples_tutorials_run_ensemblelda.py` (``run_ensemblelda.py``) | 00:00.000 | 0.0 MB  |
++-------------------------------------------------------------------------------------+-----------+---------+
+| :ref:`sphx_glr_auto_examples_tutorials_run_fasttext.py` (``run_fasttext.py``)       | 00:00.000 | 0.0 MB  |
++-------------------------------------------------------------------------------------+-----------+---------+
+| :ref:`sphx_glr_auto_examples_tutorials_run_lda.py` (``run_lda.py``)                 | 00:00.000 | 0.0 MB  |
++-------------------------------------------------------------------------------------+-----------+---------+
+| :ref:`sphx_glr_auto_examples_tutorials_run_scm.py` (``run_scm.py``)                 | 00:00.000 | 0.0 MB  |
++-------------------------------------------------------------------------------------+-----------+---------+
+| :ref:`sphx_glr_auto_examples_tutorials_run_wmd.py` (``run_wmd.py``)                 | 00:00.000 | 0.0 MB  |
++-------------------------------------------------------------------------------------+-----------+---------+
+| :ref:`sphx_glr_auto_examples_tutorials_run_word2vec.py` (``run_word2vec.py``)       | 00:00.000 | 0.0 MB  |
++-------------------------------------------------------------------------------------+-----------+---------+
diff --git a/docs/src/gallery/tutorials/run_doc2vec_lee.py b/docs/src/gallery/tutorials/run_doc2vec_lee.py
index 7012d38f66..18f4ee7b16 100644
--- a/docs/src/gallery/tutorials/run_doc2vec_lee.py
+++ b/docs/src/gallery/tutorials/run_doc2vec_lee.py
@@ -215,9 +215,15 @@ def read_corpus(fname, tokens_only=False):
 
 ###############################################################################
 # Next, train the model on the corpus.
-# If optimized Gensim (with BLAS library) is being used, this should take no more than 3 seconds.
-# If the BLAS library is not being used, this should take no more than 2
-# minutes, so use optimized Gensim with BLAS if you value your time.
+# In the usual case, where Gensim installation found a BLAS library for optimized
+# bulk vector operations, this training on this tiny 300 document, ~60k word corpus 
+# should take just a few seconds. (More realistic datasets of tens-of-millions
+# of words or more take proportionately longer.) If for some reason a BLAS library 
+# isn't available, training uses a fallback approach that takes 60x-120x longer, 
+# so even this tiny training will take minutes rather than seconds. (And, in that 
+# case, you should also notice a warning in the logging letting you know there's 
+# something worth fixing.) So, be sure your installation uses the BLAS-optimized 
+# Gensim if you value your time.
 #
 model.train(train_corpus, total_examples=model.corpus_count, epochs=model.epochs)
 

From e656d77003c8fe36c1a217f9c5ec5661ed165a21 Mon Sep 17 00:00:00 2001
From: funasshi <54014411+funasshi@users.noreply.github.com>
Date: Wed, 7 Dec 2022 11:50:47 +0900
Subject: [PATCH 26/34] Fix bug that prevents loading old models (#3359)

* fix loading old gensim model by new model

* Revert "fix loading old gensim model by new model"

This reverts commit d398e92291e3de4d6d2a73016150cd9aa2e52714.

* fix loading old gensim model by new model

* Update word2vec.py

* Update word2vec.py

* Update word2vec.py

Co-authored-by: Michael Penkov <m@penkov.dev>
---
 gensim/models/word2vec.py | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/gensim/models/word2vec.py b/gensim/models/word2vec.py
index d20bb63b1f..b172f57c8a 100755
--- a/gensim/models/word2vec.py
+++ b/gensim/models/word2vec.py
@@ -200,6 +200,9 @@
 from gensim.models.keyedvectors import KeyedVectors, pseudorandom_weak_vector
 from gensim import utils, matutils
 
+# This import is required by pickle to load models stored by Gensim < 4.0, such as Gensim 3.8.3.
+from gensim.models.keyedvectors import Vocab  # noqa
+
 from smart_open.compression import get_supported_extensions
 
 logger = logging.getLogger(__name__)

From ca8e4e8378bc489b0dda087dd9c0ed8f933ca3e2 Mon Sep 17 00:00:00 2001
From: Michael Penkov <m@penkov.dev>
Date: Wed, 7 Dec 2022 12:09:49 +0900
Subject: [PATCH 27/34] refactor wheel building and testing workflow (#3410)

handle windows separately - it's cleaner that way
---
 .github/workflows/build-wheels.yml | 195 +++++++++++++++++++----------
 1 file changed, 126 insertions(+), 69 deletions(-)

diff --git a/.github/workflows/build-wheels.yml b/.github/workflows/build-wheels.yml
index cd0548fe83..dab4957b2f 100644
--- a/.github/workflows/build-wheels.yml
+++ b/.github/workflows/build-wheels.yml
@@ -36,7 +36,8 @@ jobs:
 
       - name: Check Sphinx Gallery cache
         run: python docs/src/check_gallery.py
-  build:
+
+  multibuild:
     timeout-minutes: 35
     runs-on: ${{ matrix.os }}
     defaults:
@@ -48,9 +49,6 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        python-version: ['3.8', '3.9', '3.10', '3.11']
-        os: [ubuntu-latest, macos-latest, windows-latest]
-        platform: [x64]
         include:
         #
         # We want the _oldest_ possible manylinux version to ensure our
@@ -76,12 +74,12 @@ jobs:
         #
         - os: ubuntu-latest
           manylinux-version: 2010
-          python-version: 3.8
+          python-version: "3.8"
           build-depends: numpy==1.17.3
 
         - os: ubuntu-latest
           manylinux-version: 2010
-          python-version: 3.9
+          python-version: "3.9"
           build-depends: numpy==1.19.3
 
         - os: ubuntu-latest
@@ -97,13 +95,13 @@ jobs:
         - os: macos-latest
           travis-os-name: osx
           manylinux-version: 1
-          python-version: 3.8
+          python-version: "3.8"
           build-depends: numpy==1.17.3
 
         - os: macos-latest
           travis-os-name: osx
           manylinux-version: 1
-          python-version: 3.9
+          python-version: "3.9"
           build-depends: numpy==1.19.3
 
         - os: macos-latest
@@ -118,41 +116,23 @@ jobs:
           python-version: "3.11"
           build-depends: numpy==1.23.2 scipy==1.9.2
 
-        - os: windows-latest
-          manylinux-version: 2010
-          python-version: 3.8
-          build-depends: numpy==1.17.3
-
-        - os: windows-latest
-          manylinux-version: 2010
-          python-version: 3.9
-          build-depends: numpy==1.19.3
-
-        - os: windows-latest
-          manylinux-version: 2010
-          python-version: "3.10"
-          build-depends: numpy==1.22.2 scipy==1.8.0
-        
-        - os: windows-latest
-          manylinux-version: 2010
-          python-version: "3.11"
-          build-depends: numpy==1.23.2 scipy==1.9.2
-
     env:
-      PKG_NAME: gensim
-      REPO_DIR: gensim
-      BUILD_COMMIT: HEAD
-      PLAT: x86_64
-      UNICODE_WIDTH: 32
-      MB_PYTHON_VERSION: ${{ matrix.python-version }} # MB_PYTHON_VERSION is needed by Multibuild
+      SKIP_NETWORK_TESTS: 1
       TEST_DEPENDS: pytest mock testfixtures
+      BUILD_DEPENDS: ${{ matrix.build-depends }}
+
+      #
+      # For multibuild
+      #
+      BUILD_COMMIT: HEAD
       DOCKER_TEST_IMAGE: multibuild/xenial_x86_64
-      TRAVIS_OS_NAME: ${{ matrix.travis-os-name }}
-      SKIP_NETWORK_TESTS: 1
       MB_ML_VER: ${{ matrix.manylinux-version }}
-      WHEELHOUSE_UPLOADER_USERNAME: ${{ secrets.AWS_ACCESS_KEY_ID }}
-      WHEELHOUSE_UPLOADER_SECRET: ${{ secrets.AWS_SECRET_ACCESS_KEY }}
-      BUILD_DEPENDS: ${{ matrix.build-depends }}
+      MB_PYTHON_VERSION: ${{ matrix.python-version }} # MB_PYTHON_VERSION is needed by Multibuild
+      PKG_NAME: gensim
+      PLAT: x86_64
+      REPO_DIR: gensim
+      TRAVIS_OS_NAME: ${{ matrix.travis-os-name }}
+      UNICODE_WIDTH: 32
 
     steps:
     - uses: actions/checkout@v3
@@ -175,8 +155,7 @@ jobs:
       run: |
         python -m pip install --upgrade pip
         pip install virtualenv
-    - name: Build Wheel (Multibuild)
-      if: matrix.os != 'windows-latest'
+    - name: Build Wheel
       run: |
         echo ::group::Set up Multibuild
         source multibuild/common_utils.sh
@@ -191,31 +170,6 @@ jobs:
         build_wheel $REPO_DIR ${{ matrix.PLAT }}
         echo ::endgroup::
 
-    #
-    # We can't use multibuild on Windows, so we have to roll our own build script.
-    # Adapted from
-    # https://github.com/RaRe-Technologies/gensim-wheels/commit/084b863390edee05bbe15d4ec05d1ab726e52202
-    #
-    - name: Build Wheel (Windows)
-      if: matrix.os == 'windows-latest'
-      run: |
-        echo ::group::Set up dependencies
-        python --version
-        python -c "import struct; print(struct.calcsize('P') * 8)"
-        python -m pip install -U pip setuptools wheel wheelhouse_uploader ${{ env.BUILD_DEPENDS }}
-        echo ::endgroup::
-        echo ::group::Build wheel
-        python setup.py bdist_wheel
-        echo ::endgroup
-        echo ::group::Install run
-        ls dist
-        python continuous_integration/install_wheel.py
-        echo ::endgroup::
-        #
-        # For consistency with the multibuild step.
-        #
-        mv dist wheelhouse
-
     - name: Prepare for testing
       run: |
         #
@@ -232,8 +186,7 @@ jobs:
     # It also does not work under Windows.
     # So, we create our own simple test step here.
     #
-    - name: Install and Test Wheel (Linux, MacOS)
-      if: matrix.os != 'windows-latest'
+    - name: Install and Test Wheel
       run: |
         . test_environment/bin/activate
         python -m pip install --upgrade pip
@@ -247,12 +200,113 @@ jobs:
         #
         pytest -rfxEXs --durations=20 --disable-warnings --showlocals --pyargs gensim
 
+    - name: Upload wheels to s3://gensim-wheels
+      #
+      # Only do this if the credentials are set.
+      # This means that PRs will still build wheels, but not upload them.
+      # (PRs do not have access to secrets).
+      #
+      # The always() ensures this step runs even if a previous step fails.
+      # We want to upload wheels whenever possible (even if e.g. tests failed)
+      # because we don't want an innocuous test failure from blocking a release.
+      #
+      if: ${{ always() && env.WHEELHOUSE_UPLOADER_USERNAME && env.WHEELHOUSE_UPLOADER_SECRET }}
+      run: |
+        python -m pip install wheelhouse-uploader
+        ls wheelhouse/*.whl
+        python -m wheelhouse_uploader upload --local-folder wheelhouse/ --no-ssl-check gensim-wheels --provider S3 --no-enable-cdn
+      env:
+        WHEELHOUSE_UPLOADER_USERNAME: ${{ secrets.AWS_ACCESS_KEY_ID }}
+        WHEELHOUSE_UPLOADER_SECRET: ${{ secrets.AWS_SECRET_ACCESS_KEY }}
+
+
+  #
+  # The build process for windows is different to that of Linux and MacOS.
+  # First, we cannot use multibuild (it does not support Windows).
+  # This means we have to write our own building and testing steps, but in a
+  # way it's simpler, because we don't need to care about configuring
+  # multibuild ourselves.
+  # Second, the syntax to enable virtual environments, etc. is different.
+  #
+  build_windows:
+    timeout-minutes: 35
+    runs-on: windows-latest
+    defaults:
+      run:
+        shell: bash
+
+    needs: [linters]
+
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+        - python-version: "3.8"
+          build-depends: numpy==1.17.3
+
+        - python-version: "3.9"
+          build-depends: numpy==1.19.3
+
+        - python-version: "3.10"
+          build-depends: numpy==1.22.2 scipy==1.8.0
+        
+        - python-version: "3.11"
+          build-depends: numpy==1.23.2 scipy==1.9.2
+
+    env:
+      SKIP_NETWORK_TESTS: 1
+      TEST_DEPENDS: pytest mock testfixtures
+      BUILD_DEPENDS: ${{ matrix.build-depends }}
+
+    steps:
+    - uses: actions/checkout@v3
+      with:
+        submodules: recursive
+        fetch-depth: 0
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v4
+      with:
+        python-version: ${{ matrix.python-version }}
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install virtualenv
+
+    - name: Build Wheel
+      run: |
+        echo ::group::Set up dependencies
+        python --version
+        python -c "import struct; print(struct.calcsize('P') * 8)"
+        python -m pip install -U pip setuptools wheel wheelhouse_uploader ${{ env.BUILD_DEPENDS }}
+        echo ::endgroup::
+        echo ::group::Build wheel
+        python setup.py bdist_wheel
+        echo ::endgroup
+        echo ::group::Install run
+        ls dist
+        python continuous_integration/install_wheel.py
+        echo ::endgroup::
+        #
+        # For consistency with the multibuild step.  The wheel uploader expects
+        # the wheels to be under wheelhouse.
+        #
+        mv dist wheelhouse
+
+    - name: Prepare for testing
+      run: |
+        #
+        # FIXME: Why are these eggs here?
+        #
+        # These eggs prevent the wheel from building and running on Py3.10
+        #
+        find . -type f -name "*.egg" -exec rm -v {} \;
+        python -m venv test_environment
+
     #
     # We need a separate testing step for windows because the command for
     # activating the virtual environment is slightly different
     #
     - name: Install and Test Wheel (Windows)
-      if: matrix.os == 'windows-latest'
       run: |
         test_environment/Scripts/activate.bat
         python -m pip install --upgrade pip
@@ -277,3 +331,6 @@ jobs:
         python -m pip install wheelhouse-uploader
         ls wheelhouse/*.whl
         python -m wheelhouse_uploader upload --local-folder wheelhouse/ --no-ssl-check gensim-wheels --provider S3 --no-enable-cdn
+      env:
+        WHEELHOUSE_UPLOADER_USERNAME: ${{ secrets.AWS_ACCESS_KEY_ID }}
+        WHEELHOUSE_UPLOADER_SECRET: ${{ secrets.AWS_SECRET_ACCESS_KEY }}

From 50a9e6b4cbba13fb08a8ec470a0297614c16d802 Mon Sep 17 00:00:00 2001
From: globba <114566111+globba@users.noreply.github.com>
Date: Mon, 12 Dec 2022 14:40:02 +0100
Subject: [PATCH 28/34] Fixed issue when using add_vector with
 FastTextKeyedVectors (#3389)

Since Gensim 4.0, 'key' in FastTextKeyedVectors always returns True by design.
The proper way to check if a key already exists is with 'key' in FastTextKeyedVectors.key_to_index.

Co-authored-by: dcarron <dcarron@idiap.ch>
---
 gensim/models/keyedvectors.py |  2 +-
 gensim/test/test_fasttext.py  | 22 ++++++++++++++++++++++
 2 files changed, 23 insertions(+), 1 deletion(-)

diff --git a/gensim/models/keyedvectors.py b/gensim/models/keyedvectors.py
index e8045bcd97..b09f440f92 100644
--- a/gensim/models/keyedvectors.py
+++ b/gensim/models/keyedvectors.py
@@ -592,7 +592,7 @@ def add_vectors(self, keys, weights, extras=None, replace=False):
 
         in_vocab_mask = np.zeros(len(keys), dtype=bool)
         for idx, key in enumerate(keys):
-            if key in self:
+            if key in self.key_to_index:
                 in_vocab_mask[idx] = True
 
         # add new entities to the vocab
diff --git a/gensim/test/test_fasttext.py b/gensim/test/test_fasttext.py
index 64bd636b3a..e07eaab9a1 100644
--- a/gensim/test/test_fasttext.py
+++ b/gensim/test/test_fasttext.py
@@ -1782,6 +1782,28 @@ def test_identity(self):
         self.assertTrue(np.all(np.array([6, 7, 8]) == n[2]))
 
 
+class FastTextKeyedVectorsTest(unittest.TestCase):
+    def test_add_vector(self):
+        wv = FastTextKeyedVectors(vector_size=2, min_n=3, max_n=6, bucket=2000000)
+        wv.add_vector("test_key", np.array([0, 0]))
+
+        self.assertEqual(wv.key_to_index["test_key"], 0)
+        self.assertEqual(wv.index_to_key[0], "test_key")
+        self.assertTrue(np.all(wv.vectors[0] == np.array([0, 0])))
+
+    def test_add_vectors(self):
+        wv = FastTextKeyedVectors(vector_size=2, min_n=3, max_n=6, bucket=2000000)
+        wv.add_vectors(["test_key1", "test_key2"], np.array([[0, 0], [1, 1]]))
+
+        self.assertEqual(wv.key_to_index["test_key1"], 0)
+        self.assertEqual(wv.index_to_key[0], "test_key1")
+        self.assertTrue(np.all(wv.vectors[0] == np.array([0, 0])))
+
+        self.assertEqual(wv.key_to_index["test_key2"], 1)
+        self.assertEqual(wv.index_to_key[1], "test_key2")
+        self.assertTrue(np.all(wv.vectors[1] == np.array([1, 1])))
+
+
 if __name__ == '__main__':
     logging.basicConfig(format='%(asctime)s : %(levelname)s : %(message)s', level=logging.DEBUG)
     unittest.main()

From 45d35eee1e7d0c9eb69ae76a99b2ed7cc35a1c0b Mon Sep 17 00:00:00 2001
From: Emil Rijcken <39989052+ERijck@users.noreply.github.com>
Date: Mon, 12 Dec 2022 14:46:40 +0100
Subject: [PATCH 29/34] Flsamodel (#3398)

* added flsamodel

* added FuzzyTM to dependencies

* flake8

* less dependencies and not imported from FuzzyTM

* added flsamodel

Co-authored-by: Michael Penkov <m@penkov.dev>
---
 gensim/models/flsamodel.py | 1696 ++++++++++++++++++++++++++++++++++++
 setup.py                   |    1 +
 2 files changed, 1697 insertions(+)
 create mode 100644 gensim/models/flsamodel.py

diff --git a/gensim/models/flsamodel.py b/gensim/models/flsamodel.py
new file mode 100644
index 0000000000..9ed815abe1
--- /dev/null
+++ b/gensim/models/flsamodel.py
@@ -0,0 +1,1696 @@
+# -*- coding: utf-8 -*-
+"""
+Created on Thu Oct 27 11:04:27 2022
+
+@author: 20200016
+"""
+
+import math
+from collections import Counter
+import warnings
+import pickle
+import itertools
+import numpy as np
+from scipy.sparse.linalg import svds
+from scipy.sparse import dok_matrix
+from pyfume import Clustering
+import gensim.corpora as corpora
+from gensim.models.coherencemodel import CoherenceModel
+from gensim.models import Word2Vec
+
+
+class FlsaModel():
+    """
+    Class to initialize and train fuzzy topic models with methods similar
+    to Gensim's LdaModel'
+
+    Parameters
+    ----------
+            corpus : The input corpus.
+                either: list of list of str.
+                or: list of list of tuples (int, int) (bow).
+
+            num_topics: int
+                The number of topics to be trained.
+
+            algorithm: str ['flsa', 'flsa-w', 'flsa-e']
+                The algorithm to train.
+
+            id2word: gensim.corpora.dictionary.Dictionary
+                Object to map id's to words
+                (only used when the corpus is passed into the object as a bow).
+
+            word_weighting: str ['normal', 'idf', 'probidf', 'entropy']
+                Global term weighting mechanism.
+
+            cluster_method: str ['fcm', 'gk', 'fst-pso']
+                Fuzzy clustering method.
+
+            svd_factors: int
+                The number of singular values to use.
+    """
+    def __init__(
+            self,
+            corpus,
+            num_topics,
+            algorithm,
+            num_words=20,
+            word_weighting='normal',
+            cluster_method='fcm',
+            svd_factors=2,
+            id2word=None,
+            min_count=None,
+            window=None,
+            vector_size=None,
+            workers=None,
+            ):
+        self.corpus = self._set_corpus(corpus, id2word)
+        self.num_topics = num_topics
+        self.algorithm = algorithm
+        self.num_topics = num_topics
+        self.num_words = num_words
+        self.word_weighting = word_weighting
+        self.cluster_method = cluster_method
+        self.svd_factors = svd_factors
+        self.min_count = min_count
+        self.window = window
+        self.vector_size = vector_size
+        self.workers = workers
+        self._check_variables()
+        self._vocabulary, self._vocabulary_size = self._create_vocabulary(self.corpus)
+        self._word_to_index, self._index_to_word = self._create_index_dicts(self._vocabulary)
+        self._sum_words = self._create_sum_words(self.corpus)
+        self._prob_word_i = None
+        self._prob_document_j = None
+        self._prob_topic_k = None
+        self._prob_word_given_topic = None
+        self._prob_word_given_document = None
+        self.coherence_score = None
+        self.diversity_score = None
+        self.pwgt, self.ptgd = self._get_matrices()
+
+    def _set_corpus(
+            self,
+            corpus,
+            id2word,
+            ):
+        """
+        Method that sets the corpus to FuzzyTM's required input format.
+        If a list of list of str is passed into the method for corpus, then
+        it returns the same corpus. If a bow (list of list of tuples) is passed
+        into the class, it transforms this into a list of list of str.
+
+        Parameters
+        ----------
+            corpus : either: list of list of str (tokens). or: list of list of tuples (int, int).
+                The input corpus.
+            id2word: gensim.corpora.dictionary.Dictionary
+                Object to map id's to words
+                (only used when the corpus is passed into the object as a bow)
+
+        Returns
+        -------
+            list of list of str
+                The corpus in FuzzyTM's required input format.
+        """
+        if self._check_bow(corpus):
+            if not isinstance(id2word, corpora.dictionary.Dictionary):
+                raise ValueError("Please pass 'id2word' when using a bow for 'corpus'.")
+            return self._convert_bow(corpus, id2word)
+        return corpus
+
+    @staticmethod
+    def _check_bow(
+            corpus,
+            ):
+        """
+        Method to check if the input format has the bow format.
+
+        Parameters
+        ----------
+            corpus : either: list of list of str (tokens). or: list of list of tuples (int, int).
+                The input corpus.
+
+        Returns
+        -------
+            bool
+                True if bow format
+        """
+        if not isinstance(corpus, list):
+            return False
+        for doc in corpus:
+            if not isinstance(doc, list):
+                return False
+            for tup in doc:
+                if not isinstance(tup, tuple):
+                    return False
+                if not isinstance(tup[0], int) or not isinstance(tup[1], int):
+                    return False
+        return True
+
+    @staticmethod
+    def _convert_bow(
+            corpus,
+            id2word,
+            ):
+        """
+        Method to convert the bow format into a list of list of str.
+
+        Parameters
+        ----------
+            corpus : The input corpus.
+                either: list of list of str (tokens).
+                or: list of list of tuples (int, int).
+
+            id2word: gensim.corpora.dictionary.Dictionary
+                Object to map id's to words
+
+        Returns
+        -------
+            list of list of str
+                The corpus in FuzzyTM's required input format.
+        """
+        id2token = {v: k for k, v in id2word.token2id.items()}
+        data_list = []
+        for doc in corpus:
+            doc_list = []
+            for tup in doc:
+                for _ in itertools.repeat(None, tup[1]):
+                    doc_list.append(id2token[tup[0]])
+            data_list.append(doc_list)
+        return data_list
+
+    def _check_variables(self):
+        """
+        Check whether the input data has the right format.
+
+        Correct format: list of list of str (tokens)
+        The function raises an error if the format is incorrect.
+        """
+        for i, doc in enumerate(self.corpus):
+            if not isinstance(doc, list):
+                raise TypeError("corpus variable at index ",
+                                str(i),
+                                " is not a list")
+            if not len(doc) > 0:
+                raise ValueError(
+                    "The corpus has an empty list at index ",
+                    str(i),
+                    " and should contain at least one str value")
+            for j, word in enumerate(doc):
+                if not isinstance(word, str):
+                    raise TypeError(f"Word {j} of document {i} is not a str")
+        if not isinstance(self.num_topics, int) or self.num_topics < 1:
+            raise ValueError("Please use a positive int for num_topics")
+        if not isinstance(self.num_words, int) or self.num_words < 1:
+            raise ValueError("Please use a positive int for num_words")
+        if self.algorithm in [
+                "flsa",
+                "flsa-w",
+                ] and self.word_weighting not in [
+                "entropy",
+                "idf",
+                "normal",
+                "probidf",
+                ]:
+            warning = ["Invalid word weighting method",
+                       "Please choose between:",
+                       "'entropy', 'idf', 'normal' and'probidf'",
+                       ]
+            raise ValueError(' '.join(warning))
+        if self.cluster_method not in [
+                "fcm",
+                "fst-pso",
+                "gk",
+                ]:
+            raise ValueError(
+                "Invalid 'cluster_method. Please choose: 'fcm', 'fst-pso' or 'gk'")
+        if not isinstance(self.svd_factors, int) and self.svd_factors > 0:
+            raise ValueError("Please use a positive int for svd_factors")
+        if self.algorithm not in [
+                'flsa',
+                'flsa-w',
+                'flsa-e',
+                ]:
+            raise ValueError('Please select a correct "algoritm"')
+
+    @staticmethod
+    def _create_vocabulary(corpus):
+        """
+        Create the vocabulary from 'corpus'.
+
+        Parameters
+        ----------
+             corpus : list of lists of str
+                 The input file used to initialize the model.
+
+        Returns
+        -------
+            set of str
+                All the vocabulary words.
+        """
+        vocabulary = set(el for lis in corpus for el in lis)
+        return vocabulary, len(vocabulary)
+
+    @staticmethod
+    def _create_index_dicts(vocabulary):
+        """
+        Create the dictionaries with mappings between words and indices.
+
+        Parameters
+        ----------
+            vocabulary : set of str
+                All the words in the corpus.
+
+        Returns
+        -------
+            dict of {str : int}
+                Dictionary that maps a vocabulary word to and index number.
+            dict of {int : str}
+                Dictionary that maps an index number to each vocabulary word.
+        """
+        if not isinstance(vocabulary, set):
+            raise ValueError("Please use a 'set' type for 'vocabulary'.")
+        word_to_index = dict()
+        index_to_word = dict()
+        for i, word in enumerate(vocabulary):
+            word_to_index[word] = i
+            index_to_word[i] = word
+        return word_to_index, index_to_word
+
+    @staticmethod
+    def _create_sum_words(corpus):
+        """
+        Creates a Counter object that stores the count of each word in the corpus (corpus).
+
+        Parameters
+        ----------
+            corpus : list of lists of str
+                The input file used to initialize the model.
+
+        Returns
+        -------
+            collections.Counter {str : int}
+                The count of each word in the corpus.
+        """
+        sum_words = Counter()
+        for document in corpus:
+            sum_words.update(Counter(document))
+        return sum_words
+
+    @staticmethod
+    def _create_sparse_local_term_weights(
+            corpus,
+            vocabulary_size,
+            word_to_index,
+            ):
+        """
+        Creates a sparse matrix showing the frequency of each words in documents.
+
+        (See: https://docs.scipy.org/doc/scipy/reference/generated/scipy.sparse.dok_matrix.html)
+        Axes:
+            rows: documents (size: number of documents in corpus)
+            columns: words (size: vocabulary length)
+
+        Parameters
+        ----------
+            corpus : list of lists of str
+                The input file used to initialize the model.
+            vocabulary_size : int
+                Number of unique words in the corpus.
+            word_to_index: dict {str : int}
+                Maps each unique vocabulary word to a unique index number.
+
+        Returns
+        -------
+            scipy.sparse.dok_matrix
+                sparse matrix representation of the local term weights.
+        """
+        sparse_local_term_weights = dok_matrix(
+            (len(corpus),
+             vocabulary_size),
+            dtype=np.float32,
+            )
+        for document_index, document in enumerate(corpus):
+            document_counter = Counter(document)
+            for word in document_counter.keys():
+                sparse_local_term_weights[
+                    document_index, word_to_index[word],
+                    ] = document_counter[word]
+        return sparse_local_term_weights
+
+    def _create_sparse_global_term_weights(
+            self,
+            corpus,
+            word_weighting,
+            vocabulary_size=None,
+            sparse_local_term_weights=None,
+            index_to_word=None,
+            word_to_index=None,
+            sum_words=None,
+            ):
+        """
+        Apply a word_weighting method on the sparse_local_term_weights
+        to create sparse_global_term_weights.
+        (See: https://link.springer.com/article/10.1007/s40815-017-0327-9)
+
+        Parameters
+        ----------
+            corpus : list of lists of str
+                The input file used to initialize the model.
+            word_weighting : str
+                Indicates the method used for word_weighting. Choose from:
+                  - entropy
+                  - normal
+                  - idf
+                  - probidf
+             vocabulary_size : int
+                Number of unique words in the corpus.
+             sparse_local_term_weights : scipy.sparse.dok_matrix
+                 A sparse matrix showing the frequency of each words in documents.
+             word_to_index : dict {str : int}
+                Maps each unique vocabulary word to a unique index number.
+             index_to_word : dict {int : str}
+                 Maps each unique index number to a unique vocabulary word.
+             sum_words : collections.Counter {str : int}
+                 The count of each word in the corpus.
+
+        Returns
+        -------
+            scipy.sparse.dok_matrix
+                sparse matrix representation of the global term weights.
+        """
+        num_documents = len(corpus)
+        if word_weighting in ['entropy', 'normal']:
+            if sparse_local_term_weights is None:
+                raise ValueError("Please feed the algorithm 'sparse_local_term_weights'")
+        if word_weighting in ['entropy']:
+            if index_to_word is None:
+                raise ValueError("Please feed the algorithm 'index_to_word'")
+            if sum_words is None:
+                raise ValueError("Please feed the algorithm 'sum_words'")
+        if word_weighting in ['entropy', 'idf', 'probidf']:
+            if vocabulary_size is None:
+                raise ValueError("Please feed the algorithm 'vocabulary_size'")
+        if word_weighting in ['idf', 'probidf']:
+            if word_to_index is None:
+                raise ValueError("Please feed the algorithm 'word_to_index'")
+        if word_weighting == 'entropy':
+            global_term_weights = self._calculate_entropy(
+                num_documents,
+                vocabulary_size,
+                sparse_local_term_weights,
+                index_to_word, sum_words,
+                )
+        elif word_weighting == 'idf':
+            global_term_weights = self._calculate_idf(
+                num_documents,
+                vocabulary_size,
+                corpus,
+                word_to_index,
+                )
+        elif word_weighting == 'normal':
+            global_term_weights = self._calculate_normal(sparse_local_term_weights)
+        elif word_weighting == 'probidf':
+            global_term_weights = self._calculate_probidf(
+                num_documents,
+                vocabulary_size,
+                corpus,
+                word_to_index,
+                )
+        else:
+            raise ValueError('Invalid word weighting method')
+        return sparse_local_term_weights.multiply(global_term_weights).tocsc()
+
+    def _calculate_entropy(
+            self,
+            num_documents,
+            vocabulary_size,
+            sparse_local_term_weights,
+            index_to_word,
+            sum_words,
+            ):
+        """
+        Use the entropy word weighting method.
+
+        (See: https://link.springer.com/article/10.1007/s40815-017-0327-9)
+
+        Parameters
+        ----------
+            num_documents : int
+                The number of documents in the corpus.
+            vocabulary_size : int
+                Number of unique words in the corpus.
+            sparse_local_term_weights : scipy.sparse.dok_matrix
+                 A sparse matrix showing the frequency of each words in documents.
+            index_to_word : dict {int : str}
+                 Maps each unique index number to a unique vocabulary word.
+            sum_words : collections.Counter {str : int}
+                 The count of each word in the corpus.
+
+        Returns
+        -------
+            numpy.array : float
+        """
+        p_log_p_ij = self._create_p_log_p_ij(
+            num_documents,
+            vocabulary_size,
+            sparse_local_term_weights,
+            index_to_word,
+            sum_words,
+            )
+        summed_p_log_p = p_log_p_ij.sum(0).tolist()[0]
+        return np.array([1 + summed_p_log_p_i / np.log2(num_documents) for summed_p_log_p_i in summed_p_log_p])
+
+    def _calculate_idf(
+            self,
+            num_documents,
+            vocabulary_size,
+            corpus,
+            word_to_index,
+            ):
+        """
+        Use the idf word weightingg method.
+
+        (See: https://link.springer.com/article/10.1007/s40815-017-0327-9)
+
+        Parameters
+        ----------
+            num_documents : int
+                The number of documents in the corpus.
+            vocabulary_size : int
+                Number of unique words in the corpus.
+            corpus : list of lists of str
+                The input file used to initialize the model.
+            word_to_index: dict {str : int}
+                Maps each unique vocabulary word to a unique index number.
+
+        Returns
+        -------
+            numpy.array : float
+        """
+        binary_sparse_dtm = self._create_sparse_binary_dtm(
+            num_documents,
+            vocabulary_size,
+            corpus,
+            word_to_index,
+            )
+        summed_words = binary_sparse_dtm.sum(0).tolist()[0]
+        return np.array([np.log2(num_documents / word_count) for word_count in summed_words])
+
+    @staticmethod
+    def _calculate_normal(
+            sparse_local_term_weights,
+            ):
+        """
+        Use the normal word weightingg method.
+
+        (See: https://link.springer.com/article/10.1007/s40815-017-0327-9)
+
+        Parameters
+        ----------
+             sparse_local_term_weights : scipy.sparse.dok_matrix
+                 A sparse matrix showing the frequency of each words in documents.
+
+        Returns
+        -------
+            numpy.array : float
+        """
+        squared_dtm = sparse_local_term_weights.multiply(sparse_local_term_weights)
+        summed_words = squared_dtm.sum(0).tolist()[0]
+        return np.array([1 / (math.sqrt(word_count)) for word_count in summed_words])
+
+    def _calculate_probidf(
+            self,
+            num_documents,
+            vocabulary_size,
+            corpus,
+            word_to_index,
+            ):
+        """
+        Use the probidf word weightingg method.
+
+        (See: https://link.springer.com/article/10.1007/s40815-017-0327-9)
+
+        Parameters
+        ----------
+            num_documents : int
+                The number of documents in the corpus.
+            vocabulary_size : int
+                Number of unique words in the corpus.
+            corpus : list of lists of str
+                The input file used to initialize the model.
+            word_to_index: dict {str : int}
+                Maps each unique vocabulary word to a unique index number.
+
+        Returns
+        -------
+            numpy.array : float
+        """
+        binary_sparse_dtm = self._create_sparse_binary_dtm(
+            num_documents,
+            vocabulary_size,
+            corpus,
+            word_to_index,
+            )
+        summed_binary_words_list = binary_sparse_dtm.sum(0).tolist()[0]
+
+        return np.array([np.log2((num_documents - binary_word_count) / binary_word_count)
+                         for binary_word_count in summed_binary_words_list])
+
+    @staticmethod
+    def _create_p_log_p_ij(
+            num_documents,
+            vocabulary_size,
+            sparse_local_term_weights,
+            index_to_word,
+            sum_words,
+            ):
+        """
+        Create probability of word i in document j, multiplied by its base-2 logarithm.
+
+        (See: https://link.springer.com/article/10.1007/s40815-017-0327-9)
+
+        Parameters
+        ----------
+            num_documents : int
+                The number of documents in the corpus.
+            vocabulary_size : int
+                Number of unique words in the corpus.
+            sparse_local_term_weights : scipy.sparse.dok_matrix
+                A sparse matrix showing the frequency of each words in documents.
+            index_to_word : dict {int : str}
+                Maps each unique index number to a unique vocabulary word.
+            sum_words : collections.Counter {str : int}
+                The count of each word in the corpus.
+
+        Returns
+        -------
+             scipy.sparse.dok_matrix
+        """
+        p_log_p_ij = dok_matrix(
+            (num_documents, vocabulary_size), dtype=np.float32,
+            )
+        for j in range(num_documents):
+            row_counts = sparse_local_term_weights.getrow(j).toarray()[0]
+            word_index = row_counts.nonzero()[0]
+            non_zero_row_counts = row_counts[row_counts != 0]
+            for i, count in enumerate(non_zero_row_counts):
+                word = index_to_word[word_index[i]]
+                prob_ij = count / sum_words[word]
+                p_log_p_ij[j, word_index[i]] = prob_ij * np.log2(prob_ij)
+        return p_log_p_ij
+
+    @staticmethod
+    def _create_sparse_binary_dtm(
+            num_documents,
+            vocabulary_size,
+            corpus,
+            word_to_index,
+            ):
+        """
+        Create a binary sparse document-term-matrix (used for idf and probidf).
+
+        (See: https://link.springer.com/article/10.1007/s40815-017-0327-9)
+
+        Parameters
+        ----------
+            num_documents : int
+                The number of documents in the corpus.
+            vocabulary_size : int
+                Number of unique words in the corpus.
+            corpus : list of lists of str
+                The input file used to initialize the model.
+            word_to_index: dict {str : int}
+                Maps each unique vocabulary word to a unique index number.
+
+       Returns
+        -------
+             scipy.sparse.dok_matrix
+        """
+        binary_sparse_dtm = dok_matrix(
+            (num_documents, vocabulary_size), dtype=np.float32,
+            )
+        for doc_index, document in enumerate(corpus):
+            binary_document_counter = dict.fromkeys(document, 1)
+            for word in set(document):
+                binary_sparse_dtm[doc_index,
+                                  word_to_index[word]] = binary_document_counter[word]
+        return binary_sparse_dtm
+
+    @staticmethod
+    def _create_projected_data(
+            algorithm,
+            sparse_weighted_matrix,
+            svd_factors,
+            ):
+        """
+        Perform singular decomposition for dimensionality reduction.
+
+        (See: https://web.mit.edu/be.400/www/SVD/Singular_Value_Decomposition.htm)
+        For SVD on a sparse matrix, the sparsesvd package is used
+        (https://pypi.org/project/sparsesvd/)
+
+        Parameters
+        ----------
+             algorithm : str
+                 Indicator for which algorithm is being trained ('flsa' or 'flsa-w').
+             sparse_weighted_matrix : scipy.sparse.dok_matrix
+                 Sparse global term matrix.
+             svd_factors : int
+                 The number of singular values to include.
+
+        Returns
+        -------
+            numpy.array : float
+        """
+        svd_u, _, svd_v = svds(
+            sparse_weighted_matrix,
+            svd_factors,
+            )
+        if algorithm in ['flsa']:
+            return svd_u
+        if algorithm in ['flsa-w']:
+            return svd_v.T
+        raise ValueError('Invalid algorithm selected.',
+                         'Only "flsa" ans "flsa-w" are currently supported.')
+
+    @staticmethod
+    def _create_partition_matrix(
+            data,
+            number_of_clusters,
+            method='fcm',
+            ):
+        """
+        Perform clustering on the projected data.
+
+        The pyFUME package is used for clustering:
+            (https://pyfume.readthedocs.io/en/latest/Clustering.html)
+
+        Parameters
+        ----------
+             data: numpy.array
+                 The output from self._create_projected_data().
+             number_of_clusters : int
+                 The number of clusters (topics).
+             method : str
+                 The cluster method, choose from: 'fcm', 'gk', 'fst-pso'.
+        Returns
+        -------
+            numpy.array : float
+        """
+        clusterer = Clustering.Clusterer(
+            nr_clus=number_of_clusters,
+            data=data,
+            )
+        _, partition_matrix, _ = clusterer.cluster(method=method)
+        return partition_matrix
+
+    @staticmethod
+    def _create_prob_document_j(sparse_matrix):
+        """
+        Get the probability of document j.
+
+        Parameters
+        ----------
+            sparse_matrix : scipy.sparse.dok_matrix
+                A sparse matrix representation of the global term weights.
+        Returns
+        -------
+            numpy.array : float
+                (shape: number of documents x 1)
+        """
+        # Vector with the length of num_document,
+        # each cell represents the sum of all weights of a document
+        document_sum = np.array([doc[0] for doc in sparse_matrix.sum(1).tolist()])
+        # sum of all the elements in the weighted matrix
+        total_sum_d = sum(sparse_matrix.sum(0).tolist()[0])
+        return document_sum / total_sum_d  # normalized probability
+
+    @staticmethod
+    def _create_prob_word_i(sparse_matrix):
+        """
+        Get the probability of word i.
+
+        Parameters
+        ----------
+            sparse_matrix : scipy.sparse.dok_matrix
+                A sparse matrix representation of the global term weights.
+
+        Returns
+        -------
+            numpy.array : float
+                (shape: vocabulary_size x 1)
+        """
+        word_sum = np.array(sparse_matrix.sum(0).tolist())
+        # Sum of all the elements in the weighted matrix
+        total_sum_w = sum(sparse_matrix.sum(0).tolist()[0])
+        return (word_sum / total_sum_w)[0]  # normalized probability
+
+    @staticmethod
+    def _create_prob_topic_k(
+            prob_topic_given_word_transpose,
+            prob_word_i,
+            ):
+        """
+        Get the probability of topic k.
+
+        Parameters
+        ----------
+            prob_topic_given_word_transpose : numpy.array : float
+                The output from self._create_partition_matrix().
+            prob_word_i : numpy.array : float
+                The output from self._create_prob_word_i().
+
+        Returns
+        -------
+            numpy.array : float
+                (shape: 1 x number of topics)
+        """
+        return np.matmul(prob_topic_given_word_transpose.T, prob_word_i)
+
+    @staticmethod
+    def _check_passed_variables(
+            algorithm,
+            prob_topic_given_document_transpose,
+            prob_topic_given_word_transpose,
+            local_term_weights,
+            global_term_weights,
+            ):
+        """
+        Check whether the algorithms are being fed the right attributes.
+        """
+        if algorithm in ['flsa']:
+            if prob_topic_given_document_transpose is None:
+                raise ValueError("Please feed the method",
+                                 "'prob_topic_given_document_transpose' to run flsa")
+            if global_term_weights is None:
+                raise ValueError("Please feed the method 'global_term_weights', to run flsa")
+        elif algorithm in ['flsa-w']:
+            if prob_topic_given_word_transpose is None:
+                raise ValueError("Please feed the method",
+                                 "'prob_topic_given_word_transpose' to run flsa-w")
+            if global_term_weights is None:
+                raise ValueError("Please feed the method 'global_term_weights'",
+                                 " to run flsa-w")
+        elif algorithm in [
+                           'flsa-e',
+                           ]:
+            if prob_topic_given_word_transpose is None:
+                raise ValueError("Please feed the method",
+                                 "'prob_topic_given_word_transpose' to run model")
+            if local_term_weights is None:
+                raise ValueError("Please feed the method 'local_term_weights', to run model")
+
+        else:
+            raise ValueError('Your algorithm is currently not supported')
+
+    def _create_probability_matrices(
+            self,
+            algorithm,
+            prob_topic_given_document_transpose=None,
+            prob_topic_given_word_transpose=None,
+            local_term_weights=None,
+            global_term_weights=None,
+            ):
+        """
+        Method that performs matrix multiplications to obtain the output matrices.
+
+        The 'algorithm' parameter is generic and the other ones depend on the selected algorithm.
+        The other parameters passed into this method depend on the used algorithm.
+
+        Parameters
+        ----------
+            algorithm : str
+                 Indicator for which algorithm is being trained ('flsa' or 'flsa-w').
+            global_term_weights : scipy.sparse.dok_matrix
+                The output from self._create_partition_matrix().
+            prob_topic_given_document_transpose : numpy.array : float
+                The output from self._create_partition_matrix() (flsa)
+            prob_topic_given_word_transpose : numpy.array : float
+                 (flsa-w)
+
+        Returns
+        -------
+            numpy.array : float
+                The prbability of a word given a topic.
+            numpy.array : float
+                The prbability of a topic given a document.
+        """
+        # Check whether the right variable are passed into the method.
+        self._check_passed_variables(
+            algorithm,
+            prob_topic_given_document_transpose,
+            prob_topic_given_word_transpose,
+            local_term_weights,
+            global_term_weights,
+            )
+
+        # Calculate the initial probabilities
+        if algorithm in [
+                'flsa',
+                'flsa-w',
+                ]:
+            self._prob_word_i = self._create_prob_word_i(global_term_weights)
+            self._prob_document_j = self._create_prob_document_j(global_term_weights)
+            if algorithm in ['flsa-w']:
+                self._prob_topic_k = self._create_prob_topic_k(
+                    prob_topic_given_word_transpose,
+                    self._prob_word_i,
+                    )
+        elif algorithm in [
+                           'flsa-e',
+                           ]:
+            self._prob_word_i = self._create_prob_word_i(local_term_weights)
+            self._prob_document_j = self._create_prob_document_j(local_term_weights)
+            self._prob_topic_k = self._create_prob_topic_k(
+                prob_topic_given_word_transpose, self._prob_word_i,
+                )
+        if algorithm in ['flsa']:
+            prob_document_and_topic = (prob_topic_given_document_transpose.T * self._prob_document_j).T
+            prob_document_given_topic = prob_document_and_topic / prob_document_and_topic.sum(axis=0)
+            self._prob_word_given_document = np.asarray(global_term_weights / global_term_weights.sum(1))
+            self._prob_word_given_topic = np.matmul(
+                self._prob_word_given_document.T,
+                prob_document_given_topic,
+                )
+            prob_topic_given_document = prob_topic_given_document_transpose.T
+            return self._prob_word_given_topic, prob_topic_given_document
+
+        elif algorithm in [
+                'flsa-w',
+                'flsa-e'
+                ]:
+            prob_word_and_topic = (prob_topic_given_word_transpose.T * self._prob_word_i).T
+            self._prob_word_given_topic = prob_word_and_topic / prob_word_and_topic.sum(axis=0)
+            if algorithm in ['flsa-w']:
+                self._prob_word_given_document = np.asarray(global_term_weights / global_term_weights.sum(1)).T
+            elif algorithm in [
+                               'flsa-e',
+                               ]:
+                self._prob_word_given_document = np.asarray(local_term_weights / local_term_weights.sum(1)).T
+            prob_document_given_word = ((self._prob_word_given_document * self._prob_document_j).T
+                                        / np.array(self._prob_word_i))
+            prob_document_given_topic = np.matmul(
+                prob_document_given_word,
+                self._prob_word_given_topic,
+                )
+            prob_topic_given_document = ((prob_document_given_topic * self._prob_topic_k).T
+                                               / self._prob_document_j)
+            return self._prob_word_given_topic, prob_topic_given_document
+        raise ValueError('"algorithm" is unknown.')
+
+    @staticmethod
+    def _create_dictlist_topn(
+            topn,
+            prob_word_given_topic,
+            index_to_word,
+            ):
+        """
+        Creates a list with dictionaries of word probabilities
+        per topic based on the top-n words.
+
+        Parameters
+        ----------
+             topn : int
+                The top-n words to include
+                (needs only to be used when 'method=topn').
+             prob_word_given_topic : numpy.array : float
+                Matrix that gives the probability of a word given a topic.
+             index_to_word : dict {int : str}
+                Maps each unique index number to a unique vocabulary word.
+
+        Returns
+        -------
+             list of dicts {int : float}
+                Keys: all the indices of words from prob_word_given_topic
+                who's weight's are amongst the top percentage.
+                Values: the probability associated to a word.
+        """
+        if not isinstance(topn, int) and topn > 0:
+            raise ValueError("Please choose a positive integer for 'topn'")
+        top_dictionaries = []
+        for topic_index in range(prob_word_given_topic.shape[1]):
+            new_dict = dict()
+            highest_weight_indices = prob_word_given_topic[:, topic_index].argsort()[-topn:]
+            for word_index in highest_weight_indices:
+                new_dict[index_to_word[word_index]] = prob_word_given_topic[
+                    word_index, topic_index,
+                    ]
+            top_dictionaries.append(new_dict)
+        return top_dictionaries
+
+    @staticmethod
+    def _create_dictlist_percentile(
+            perc,
+            prob_word_given_topic,
+            index_to_word,
+            ):
+        """
+        Create a list with dictionaries of word probabilities
+        per topic based on the percentile.
+         - Keys: all the indices of words from prob_word_given_topic
+             who's weight's are amongst the top percentage.
+         - Values: the probability associated to a word.
+
+        Parameters
+        ----------
+             perc : float
+                The top percentile words to include
+                (needs only to be used when 'method=percentile').
+             prob_word_given_topic : numpy.array : float
+                Matrix that gives the probability of a word given a topic.
+             index_to_word : dict {int : str}
+                Maps each unique index number to a unique vocabulary word.
+
+        Returns
+        -------
+             list of dicts {int : float}
+                Keys: all the indices of words from prob_word_given_topic
+                    who's weight's are amongst the top percentage.
+                Values: the probability associated to a word.
+        """
+        if not isinstance(perc, float) and 0 <= perc <= 1:
+            raise ValueError("Please choose a number between 0 and 1 for 'perc'")
+        top_list = []
+        for top in range(prob_word_given_topic.shape[1]):
+            new_dict = dict()
+            count = 0
+            i = 0
+            weights = np.sort(prob_word_given_topic[:, top])[::-1]
+            word_indices = np.argsort(prob_word_given_topic[:, top])[::-1]
+            while count < perc:
+                new_dict[index_to_word[word_indices[i]]] = weights[i]
+                count += weights[i]
+                i += 1
+            top_list.append(new_dict)
+        return top_list
+
+    def show_topics(
+            self,
+            formatted=True,
+            prob_word_given_topic=None,
+            num_words=-1,
+            index_to_word=None,
+            ):
+        """
+        Get a representation for the topics.
+
+        Parameters
+        ----------
+            formatted : bool
+                Whether the topic representations should be formatted as strings.
+                If False, they are returned as 2 tuples of (word, probability).
+            prob_word_given_topic : numpy.array : float
+                Matrix that gives the probability of a word given a topic.
+            num_words : int
+                 Indicates how many words per topic should be shown.
+            index_to_word : dict {int : str}
+                Maps each unique index number to a unique vocabulary word.
+
+        Returns
+        -------
+            list of tuples (int, str)
+                The produced topics.
+        """
+        if prob_word_given_topic is None:
+            prob_word_given_topic = self._prob_word_given_topic
+
+        if num_words < 0:
+            num_words = self.num_words
+        if index_to_word is None:
+            index_to_word = self._index_to_word
+        if not isinstance(prob_word_given_topic, np.ndarray):
+            raise TypeError("Please feed the algorithm 'prob_word_given_topic' as a np.ndarray")
+        if not isinstance(index_to_word, dict):
+            raise TypeError("Please feed the algorithm 'index_to_word' as a dict")
+        if not isinstance(num_words, int) or num_words <= 0:
+            raise TypeError("Please use a positive int for 'num_words'.")
+        if prob_word_given_topic.shape[0] < prob_word_given_topic.shape[1]:
+            raise ValueError("'prob_word_given_topic' has more columns then rows,",
+                             " probably you need to take the transpose.")
+        warning = ["It seems like 'prob_word_given_topic' and 'index_to_word",
+                   "are not aligned. The number of vocabulary words in",
+                   "'prob_word_given_topic' deviate from the ",
+                   "number of words in 'index_to_word'."]
+        if prob_word_given_topic.shape[0] != len(index_to_word.keys()):
+            warnings.warn(' '.join(warning))
+        if not isinstance(formatted, bool):
+            raise ValueError('Please choose a boolean for "formatted"')
+        topic_list = []
+        if not formatted:
+            for topic_index in range(prob_word_given_topic.shape[1]):
+                weight_words = ""
+                sorted_highest_weight_indices = prob_word_given_topic[:, topic_index].argsort()[-num_words:][::-1]
+                for word_index in sorted_highest_weight_indices:
+                    weight_words += (str(round(prob_word_given_topic[word_index, topic_index], 4))
+                                     + '*"' + index_to_word[word_index] + '" + ')
+                topic_list.append((topic_index, weight_words[:-3]))
+            return topic_list
+        else:
+            for topic_index in range(prob_word_given_topic.shape[1]):
+                word_list = []
+                sorted_highest_weight_indices = prob_word_given_topic[:, topic_index].argsort()[-num_words:][::-1]
+                for word_index in sorted_highest_weight_indices:
+                    word_list.append(index_to_word[word_index])
+                topic_list.append(word_list)
+            return topic_list
+
+    def get_topic_embedding(
+            self,
+            corpus,
+            prob_word_given_topic=None,
+            method='topn',
+            topn=20,
+            perc=0.05,
+            ):
+        """
+        Create a topic embedding for each input document,
+        to be used as input to predictive models.
+
+        Parameters
+        ----------
+            corpus : list of lists of str
+                The input file used to initialize the model.
+            prob_word_given_topic : numpy.array : float
+                Matrix that gives the probability of a word given a topic.
+            method : str
+                Method to select words to be included in the embedding.
+                (choose from 'topn', 'percentile'):
+                    - topn: for each topic the top n words with the highest
+                        probability are included.
+                    - percentile: for each topic all words with highest
+                        probabilities are assigned while the cumulative
+                        probability is lower than the percentile.
+            topn : int
+                The top-n words to include
+                (needs only to be used when 'method=topn').
+            perc: float
+                The benchmark percentile until which words need to be added
+                (between 0 and 1).
+
+        Returns
+        -------
+            numpy.array : float
+                Array in which each row gives the topic embedding for
+                the associated document.
+        """
+        self._check_variables()
+        if prob_word_given_topic is None:
+            prob_word_given_topic = self._prob_word_given_topic
+        top_dist = []
+        if method not in ['topn', 'percentile']:
+            raise ValueError(method, "is not a valid option for 'method'.",
+                             " Choose either 'topn' or 'percentile'")
+        if method == 'topn':
+            dictlist = self._create_dictlist_topn(
+                topn, prob_word_given_topic, self._index_to_word,
+                )
+        else:
+            dictlist = self._create_dictlist_percentile(
+                perc, prob_word_given_topic, self._index_to_word,
+                )
+        for doc in corpus:
+            topic_weights = [0] * prob_word_given_topic.shape[1]
+            for word in doc:
+                for i in range(prob_word_given_topic.shape[1]):
+                    topic_weights[i] += dictlist[i].get(word, 0)
+            top_dist.append(topic_weights)
+        return np.array(top_dist)
+
+    def get_coherence_score(
+            self,
+            corpus=None,
+            topics=None,
+            coherence='c_v',
+            ):
+        """
+        Calculate the coherence score for the generated topic.
+
+        Parameters
+        ----------
+             corpus : list of lists of str
+                The input file used to initialize the model.
+             topics : list of lists of str
+                 The words per topics,
+                 equivalent to self.show_topics(formatted=True).
+             coherence : str
+                 The type of coherence to be calculated.
+                 Choose from: 'u_mass', 'c_v', 'c_uci', 'c_npmi'.
+
+        Returns
+        -------
+             float
+                 The coherence score.
+        """
+        if corpus is None and topics is None:
+            corpus = self.corpus
+            topics = self.show_topics(formatted=True)
+
+        id2word = corpora.Dictionary(corpus)
+        corpus_bow = [id2word.doc2bow(text) for text in corpus]
+        self.coherence_score = CoherenceModel(
+            topics=topics,
+            texts=corpus,
+            corpus=corpus_bow,
+            dictionary=id2word,
+            coherence=coherence,
+            topn=len(topics[0]),
+            ).get_coherence()
+        return self.coherence_score
+
+    def get_diversity_score(
+            self,
+            topics=None,
+            ):
+        """''
+        Calculate the diversity score for the generated topic.
+
+        Diversity = number of unique words / number of total words.
+        See: https://tinyurl.com/2bs84zd8
+
+        Parameters
+        ----------
+             topics : list of lists of str
+                 The words per topics,
+                 equivalent to self.show_topics(formatted=True).
+
+        Returns
+        -------
+             float
+                 The diversity score.
+        """
+        if topics is None:
+            topics = self.show_topics(formatted=True)
+        unique_words = set()
+        total_words = 0
+        for top in topics:
+            unique_words.update(top)
+            total_words += len(top)
+        self.diversity_score = len(unique_words) / total_words
+        return self.diversity_score
+
+    def get_interpretability_score(
+            self,
+            corpus=None,
+            topics=None,
+            coherence='c_v',
+            ):
+        """''
+        Calculate the interpretability score for the generated topics.
+
+        Interpretability = coherence * diversity.
+        (see: https://tinyurl.com/2bs84zd8)
+
+        Parameters
+        ----------
+             corpus : list of lists of str
+                The input file used to initialize the model.
+             topics : list of lists of str
+                 The words per topics, equivalent to
+                 self.show_topics(formatted=True).
+             coherence : str
+                 The type of coherence to be calculated.
+                 Choose from: 'u_mass', 'c_v', 'c_uci', 'c_npmi'.
+
+        Returns
+        -------
+             float
+                 The interpretability score.
+        """
+        if corpus is None and topics is None:
+            corpus = self.corpus
+            topics = self.show_topics(formatted=True)
+        if self.coherence_score is None:
+            self.coherence_score = self.get_coherence_score(
+                corpus,
+                topics,
+                coherence,
+                )
+        if self.diversity_score is None:
+            self.diversity_score = self.get_diversity_score(topics)
+        return self.coherence_score * self.diversity_score
+
+    def get_vocabulary(self):
+        """
+        Returns a set of all the words in the corpus
+
+        Example:
+        After initializing an instance of the flsamodel models as 'model'
+
+        corpus = [['this', 'is', 'the', 'first', 'file'],
+             ['and', 'this', 'is', 'second', 'file']]
+
+        model.get_vocabulary()
+
+        >>> {'this', 'is', 'the', 'first', 'file', 'and', 'second'}
+        """
+        return self._vocabulary
+
+    def get_topics(self):
+        """
+        Get the term-topic matrix.
+
+        Returns
+        -------
+        numpy.ndarray
+            The probability for each word in each topic,
+            shape (num_topics, vocabulary_size).
+        """
+        return self.pwgt
+
+    def get_vocabulary_size(self):
+        """
+        Returns the number of words in the vocabulary
+
+        Example:
+            After initializing an instance of the flsamodel models as 'model'
+
+        corpus = [['this', 'is', 'the', 'first', 'file'],
+             ['and', 'this', 'is', 'second', 'file']]
+
+        model.get_vocabulary_size()
+
+        >>> 7
+        """
+        return self._vocabulary_size
+
+    def get_word_to_index(self):
+        """
+        Obtain a dictionary that maps each vocabulary word to an index.
+
+        Returns
+        -------
+        dict of {str : int}
+            word to int mapping.
+        """
+        return self._word_to_index
+
+    def get_index_to_word(self):
+        """
+        Obtain a dictionary that maps index numbers to vocabulary words.
+
+        Returns
+        -------
+        dict of {int : str}
+            int to word mapping.
+        """
+        return self._index_to_word
+
+    def get_corpus(self):
+        """
+        Return the input file.
+
+        Returns
+        -------
+            list of list of str
+                The input file 'corpus'.
+        """
+        return self.corpus
+
+    def get_prob_word_i(self):
+        """
+        Return the probabilities per word.
+
+        Returns
+        -------
+            np.array of float
+                The probabilities per word.
+        """
+        return self._prob_word_i
+
+    def get_prob_document_j(self):
+        """
+        Return the probabilities per document.
+
+        Returns
+        -------
+            np.array of float
+                The probabilities per document.
+        """
+        return self._prob_document_j
+
+    def get_prob_topic_k(self):
+        """
+        Return the probabilities per topic.
+
+        Returns
+        -------
+            np.array of float
+                The probabilities per topic.
+        """
+        return self._prob_topic_k
+
+    def save(
+            self,
+            filepath,
+            ):
+        """''
+        Saves the object to the drive, using the pickle library.
+
+        Parameters
+        ----------
+             filepath : str
+                The directory in which the file should be stored,
+                either with or without the file name.
+
+        Returns
+        -------
+             float
+                 The interpretability score.
+        """
+        if not isinstance(filepath, str):
+            raise ValueError('Make sure that "filepath" has type "str"')
+        if filepath.endswith('.pickle'):
+            pickle_out = open(filepath, 'wb')
+        elif filepath.endswith('/'):
+            pickle_out = open(filepath + 'model.pickle', 'wb')
+        else:
+            pickle_out = open(filepath + '.pickle', 'wb')
+        pickle.dump(self, pickle_out)
+        pickle_out.close()
+
+    def load(
+            self,
+            filepath,
+            ):
+        """''
+        Loads the object from the drive, using the pickle library.
+
+        Parameters
+        ----------
+             filepath : str
+                The directory in which the file should be stored,
+                either with or without the file name.
+
+        Returns
+        -------
+             float
+                 The interpretability score.
+        """
+        if not isinstance(filepath, str):
+            raise ValueError('Make sure that "filepath" has type "str"')
+        if not filepath.endswith('.pickle'):
+            if filepath.endswith('/'):
+                filepath += 'model.pickle'
+            else:
+                filepath += '/model.pickle'
+        infile = open(filepath, 'rb')
+        self.__dict__ = pickle.load(infile).__dict__
+        infile.close()
+
+
+class Flsa(FlsaModel):
+    """
+    Class to run the FLSA algorithm (see: https://tinyurl.com/mskjaeuu).
+
+    Parameters
+        ----------
+            corpus : list of lists of str
+                The input file used to initialize the model.
+            num_topics : int
+                The number of topics that the model should train.
+            num_words : int
+                 Indicates how many words per topic should be shown.
+            word_weighting : str
+                Indicates the method used for word_weighting. Choose from:
+                  - entropy
+                  - normal
+                  - idf
+                  - probidf
+            svd_factors : int
+                 The number of singular values to include.
+            cluster_method : str
+                 The cluster algorithm to be used ('fcm', 'gk', 'fst-pso').
+    """
+    def __init__(
+            self,
+            corpus,
+            num_topics,
+            num_words=10,
+            word_weighting='normal',
+            svd_factors=2,
+            cluster_method='fcm',
+            ):
+        super().__init__(
+            algorithm='flsa',
+            corpus=corpus,
+            num_topics=num_topics,
+            num_words=num_words,
+            word_weighting=word_weighting,
+            cluster_method=cluster_method,
+            svd_factors=svd_factors,
+            )
+
+    def _get_matrices(self):
+        """
+        Method to obtain the matrices after the model has been initialized.
+
+        Returns
+        -------
+            numpy.array : float
+                The prbability of a word given a topic.
+            numpy.array : float
+                The prbability of a topic given a document.
+        """
+        sparse_document_term_matrix = self._create_sparse_local_term_weights(
+            self.corpus,
+            self._vocabulary_size,
+            self._word_to_index,
+            )
+        sparse_global_term_weighting = self._create_sparse_global_term_weights(
+            corpus=self.corpus,
+            word_weighting=self.word_weighting,
+            vocabulary_size=self._vocabulary_size,
+            sparse_local_term_weights=sparse_document_term_matrix,
+            index_to_word=self._index_to_word,
+            word_to_index=self._word_to_index,
+            sum_words=self._sum_words,
+            )
+        projected_data = self._create_projected_data(
+            algorithm='flsa',
+            sparse_weighted_matrix=sparse_global_term_weighting,
+            svd_factors=self.svd_factors,
+            )
+        partition_matrix = self._create_partition_matrix(
+            data=projected_data,
+            number_of_clusters=self.num_topics,
+            method=self.cluster_method
+            )
+        return self._create_probability_matrices(
+            algorithm='flsa',
+            prob_topic_given_document_transpose=partition_matrix,
+            global_term_weights=sparse_global_term_weighting,
+            )
+
+
+class FlsaW(FlsaModel):
+    """
+    Class to train the FLSA-W algorithm.
+
+    See: https://ieeexplore.ieee.org/abstract/document/9660139
+
+    Parameters
+        ----------
+            corpus : list of lists of str
+                The input file used to initialize the model.
+            num_topics : int
+                The number of topics that the model should train.
+            num_words : int
+                 Indicates how many words per topic should be shown.
+            word_weighting : str
+                Indicates the method used for word_weighting. Choose from:
+                  - entropy
+                  - normal
+                  - idf
+                  - probidf
+            svd_factors : int
+                 The number of singular values to include.
+            cluster_method : str
+                 The cluster algorithm to be used ('fcm', 'gk', 'fst-pso').
+    """
+    def __init__(
+            self,
+            corpus,
+            num_topics,
+            num_words=10,
+            word_weighting='normal',
+            svd_factors=2,
+            cluster_method='fcm',
+            ):
+
+        super().__init__(
+            algorithm='flsa-w',
+            corpus=corpus,
+            num_topics=num_topics,
+            num_words=num_words,
+            word_weighting=word_weighting,
+            cluster_method=cluster_method,
+            svd_factors=svd_factors,
+            )
+
+    def _get_matrices(self):
+        """
+        Method to obtain the matrices after the model has been initialized.
+
+        Returns
+        -------
+            numpy.array : float
+                The prbability of a word given a topic.
+            numpy.array : float
+                The prbability of a topic given a document.
+        """
+        sparse_document_term_matrix = self._create_sparse_local_term_weights(
+            self.corpus,
+            self._vocabulary_size,
+            self._word_to_index,
+            )
+        sparse_global_term_weighting = self._create_sparse_global_term_weights(
+            corpus=self.corpus,
+            word_weighting=self.word_weighting,
+            vocabulary_size=self._vocabulary_size,
+            sparse_local_term_weights=sparse_document_term_matrix,
+            index_to_word=self._index_to_word,
+            word_to_index=self._word_to_index,
+            sum_words=self._sum_words,
+            )
+        projected_data = self._create_projected_data(
+            algorithm='flsa-w',
+            sparse_weighted_matrix=sparse_global_term_weighting,
+            svd_factors=self.svd_factors,
+            )
+        partition_matrix = self._create_partition_matrix(
+            data=projected_data,
+            number_of_clusters=self.num_topics,
+            method=self.cluster_method,
+            )
+        return self._create_probability_matrices(
+            algorithm='flsa-w',
+            prob_topic_given_word_transpose=partition_matrix,
+            global_term_weights=sparse_global_term_weighting,
+            )
+
+
+class FlsaE(FlsaModel):
+    """
+    Class to train the FLSA-E algorithm. See: https://tinyurl.com/5n8utppk
+
+    Parameters
+        ----------
+            corpus : list of lists of str
+                The input file used to initialize the model.
+            num_topics : int
+                The number of topics that the model should train.
+            num_words : int
+                Indicates how many words per topic should be shown.
+            cluster_method : str
+                The cluster algorithm to be used ('fcm', 'gk', 'fst-pso').
+            min_count : int
+                Ignores all words with total frequency lower than this.
+            window : int
+                Maximum distance between the current and predicted word within a sentence.
+            vector_size : int
+                Dimensionality of the word vectors.
+            workers : int
+                Use these many worker threads to train the model
+                ( = faster training with multicore machines).
+    """
+
+    def __init__(
+            self,
+            corpus,
+            num_topics,
+            num_words=10,
+            cluster_method='fcm',
+            min_count=1,
+            window=5,
+            vector_size=20,
+            workers=4,
+            ):
+
+        self.model = ...
+        self.word_embedding = ...
+
+        super().__init__(
+            algorithm='flsa-e',
+            corpus=corpus,
+            num_topics=num_topics,
+            num_words=num_words,
+            cluster_method=cluster_method,
+            min_count=min_count,
+            window=window,
+            vector_size=vector_size,
+            workers=workers,
+            )
+
+    def get_word_embedding(
+            self,
+            data,
+            vector_size,
+            window,
+            min_count,
+            workers,
+            ):
+        """
+            Method to train a word embedding on the corpus.
+
+            Parameters
+                ----------
+                    data : list of lists of str
+                        The input file used to initialize the model.
+                    min_count : int
+                        Ignores all words with total frequency lower than this.
+                    window : int
+                        Maximum distance between the current and predicted word within a sentence.
+                    vector_size : int
+                        Dimensionality of the word vectors.
+                    workers : int
+                        Use these many worker threads to train the model
+                        ( = faster training with multicore machines).
+        """
+
+        self.model = Word2Vec(
+            sentences=data,
+            vector_size=vector_size,
+            window=window,
+            min_count=min_count,
+            workers=workers,
+            )
+
+        return self.model.wv.vectors
+
+    def _get_matrices(
+            self,
+            ):
+        '''
+        Method to run after the FLSA_E class has been initialized to obtain the output matrices.
+
+        Returns:
+                  - Numpy array: prob_word_given_topic
+                  - Numpy array: prob_topic_given_document
+        '''
+        sparse_document_term_matrix = self._create_sparse_local_term_weights(
+            self.corpus,
+            self._vocabulary_size,
+            self._word_to_index,
+            )
+
+        self.word_embedding = self.get_word_embedding(
+            data=self.corpus,
+            min_count=self.min_count,
+            vector_size=self.vector_size,
+            window=self.window,
+            workers=self.workers,
+            )
+
+        partition_matrix = self._create_partition_matrix(
+            data=self.word_embedding,
+            number_of_clusters=self.num_topics,
+            method=self.cluster_method,
+            )
+
+        return self._create_probability_matrices(
+            algorithm='flsa-e',
+            prob_topic_given_word_transpose=partition_matrix,
+            local_term_weights=sparse_document_term_matrix,
+            )
diff --git a/setup.py b/setup.py
index 485cf08294..c19e0d3056 100644
--- a/setup.py
+++ b/setup.py
@@ -334,6 +334,7 @@ def run(self):
     NUMPY_STR,
     'scipy >= 1.7.0',
     'smart_open >= 1.8.1',
+    'FuzzyTM >= 0.4.0'
 ]
 
 setup_requires = [NUMPY_STR]

From db90a6adda2f814d74b22cfc92a427886ce8c1c4 Mon Sep 17 00:00:00 2001
From: Michael Penkov <m@penkov.dev>
Date: Fri, 16 Dec 2022 22:12:45 +0900
Subject: [PATCH 30/34] Fix backwards compatibility bug in Word2Vec (#3415)

* add missing model file

* update test
---
 gensim/models/word2vec.py                       |   3 ---
 .../test/test_data/model-from-gensim-3.8.0.w2v  | Bin 0 -> 18926 bytes
 gensim/test/test_word2vec.py                    |   7 +++++++
 3 files changed, 7 insertions(+), 3 deletions(-)
 create mode 100644 gensim/test/test_data/model-from-gensim-3.8.0.w2v

diff --git a/gensim/models/word2vec.py b/gensim/models/word2vec.py
index b172f57c8a..d4a4ba992e 100755
--- a/gensim/models/word2vec.py
+++ b/gensim/models/word2vec.py
@@ -1986,9 +1986,6 @@ def _load_specials(self, *args, **kwargs):
             for a in ('hashfxn', 'layer1_size', 'seed', 'syn1neg', 'syn1'):
                 if hasattr(self.trainables, a):
                     setattr(self, a, getattr(self.trainables, a))
-            if hasattr(self, 'syn1'):
-                self.syn1 = self.syn1
-                del self.syn1
             del self.trainables
         if not hasattr(self, 'shrink_windows'):
             self.shrink_windows = True
diff --git a/gensim/test/test_data/model-from-gensim-3.8.0.w2v b/gensim/test/test_data/model-from-gensim-3.8.0.w2v
new file mode 100644
index 0000000000000000000000000000000000000000..40f7e22e32741c0e2f220dca87c6b3948dfab2aa
GIT binary patch
literal 18926
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
Cs`@Gb

literal 0
HcmV?d00001

diff --git a/gensim/test/test_word2vec.py b/gensim/test/test_word2vec.py
index d1749e4bfa..a07cf08b10 100644
--- a/gensim/test/test_word2vec.py
+++ b/gensim/test/test_word2vec.py
@@ -275,6 +275,13 @@ def test_persistence(self):
         self.assertTrue(np.allclose(wv.vectors, loaded_wv.vectors))
         self.assertEqual(len(wv), len(loaded_wv))
 
+    def test_persistence_backwards_compatible(self):
+        """Can we still load a model created with an older gensim version?"""
+        path = datapath('model-from-gensim-3.8.0.w2v')
+        model = word2vec.Word2Vec.load(path)
+        x = model.score(['test'])
+        assert x is not None
+
     def test_persistence_from_file(self):
         """Test storing/loading the entire model trained with corpus_file argument."""
         with temporary_file(get_tmpfile('gensim_word2vec.tst')) as corpus_file:

From 2fd3e89ca42a7812a71c608572aba2e858377c8c Mon Sep 17 00:00:00 2001
From: Michael Penkov <m@penkov.dev>
Date: Fri, 16 Dec 2022 22:28:27 +0900
Subject: [PATCH 31/34] fix numpy hack in setup.py

fix #3225
---
 setup.py | 21 ++++++++++++++-------
 1 file changed, 14 insertions(+), 7 deletions(-)

diff --git a/setup.py b/setup.py
index c19e0d3056..41d9a9c919 100644
--- a/setup.py
+++ b/setup.py
@@ -96,19 +96,26 @@ class CustomBuildExt(build_ext):
     """Custom build_ext action with bootstrapping.
 
     We need this in order to use numpy and Cython in this script without
-    importing them at module level, because they may not be available yet.
+    importing them at module level, because they may not be available at that time.
     """
-    #
-    # Prevent numpy from thinking it is still in its setup process
-    # http://stackoverflow.com/questions/19919905/how-to-bootstrap-numpy-installation-in-setup-py
-    #
     def finalize_options(self):
         build_ext.finalize_options(self)
 
         import builtins
-        builtins.__NUMPY_SETUP__ = False
-
         import numpy
+
+        #
+        # Prevent numpy from thinking it is still in its setup process
+        # http://stackoverflow.com/questions/19919905/how-to-bootstrap-numpy-installation-in-setup-py
+        #
+        # Newer numpy versions don't support this hack, nor do they need it.
+        # https://github.com/pyvista/pyacvd/pull/23#issue-1298467701
+        #
+        try:
+            builtins.__NUMPY_SETUP__ = False
+        except Exception as ex:
+            print(f'could not use __NUMPY_SETUP__ hack (numpy version: {numpy.__version__}): {ex}')
+
         self.include_dirs.append(numpy.get_include())
 
         if need_cython():

From f571f337dcaf5fe1a30f6872f267da616cc171e3 Mon Sep 17 00:00:00 2001
From: Michael Penkov <m@penkov.dev>
Date: Sat, 17 Dec 2022 22:30:44 +0900
Subject: [PATCH 32/34] updated changelog for next release (#3412)

* updated changelog for next release

* updated changelog
---
 CHANGELOG.md | 39 ++++++++++++++++++++++++++++++++++++++-
 multibuild   |  2 +-
 2 files changed, 39 insertions(+), 2 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 9718b90b64..a1fb190013 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,8 +1,45 @@
 Changes
 =======
 
-## Unreleased
+## 4.3.0, 2022-12-17
 
+### :star2: New Features
+
+* Added support for Python 3.11 and drop support for Python 3.7 (__[acul3](https://github.com/acul3)__, [#3402](https://github.com/RaRe-Technologies/gensim/pull/3402))
+* Added a new model: Flsamodel (__[ERijck](https://github.com/ERijck)__, [#3398](https://github.com/RaRe-Technologies/gensim/pull/3398))
+
+### :red_circle: Bug fixes
+
+* Fixed bug in loss computation for Word2Vec with hierarchical softmax (__[TalIfargan](https://github.com/TalIfargan)__, [#3397](https://github.com/RaRe-Technologies/gensim/pull/3397))
+* Patch Coherence Model to correctly handle empty documents (__[PrimozGodec](https://github.com/PrimozGodec)__, [#3406](https://github.com/RaRe-Technologies/gensim/pull/3406))
+* Fixed bug that prevents loading old models (__[funasshi](https://github.com/funasshi)__, [#3359](https://github.com/RaRe-Technologies/gensim/pull/3359))
+* Fixed deprecation warning from pytest (__[martino-vic](https://github.com/martino-vic)__, [#3354](https://github.com/RaRe-Technologies/gensim/pull/3354))
+* Fixed FastTextKeyedVectors handling in add_vector  (__[globba](https://github.com/globba)__, [#3389](https://github.com/RaRe-Technologies/gensim/pull/3389))
+* Fixed typo in word2vec and KeyedVectors docstrings (__[dymil](https://github.com/dymil)__, [#3365](https://github.com/RaRe-Technologies/gensim/pull/3365))
+* Fix backwards compatibility bug in Word2Vec, (**[@mpenkov](https://github.com/mpenkov)**, [#3415](https://github.com/RaRe-Technologies/gensim/pull/3415))
+* Fix numpy hack in setup.py, by (**[@mpenkov](https://github.com/mpenkov)**, [#3416](https://github.com/RaRe-Technologies/gensim/pull/3416))
+
+### :books: Tutorial and doc improvements
+
+* Clarified runtime expectations (__[gojomo](https://github.com/gojomo)__, [#3381](https://github.com/RaRe-Technologies/gensim/pull/3381))
+* Copyedit and fix outdated statements in translation matrix tutorial (__[dymil](https://github.com/dymil)__, [#3375](https://github.com/RaRe-Technologies/gensim/pull/3375))
+* Disabled the Gensim 3=>4 warning in docs (__[piskvorky](https://github.com/piskvorky)__, [#3346](https://github.com/RaRe-Technologies/gensim/pull/3346))
+* Fixed the broken link in readme.md (__[aswin2108](https://github.com/aswin2108)__, [#3409](https://github.com/RaRe-Technologies/gensim/pull/3409))
+* Giving missing credit in EnsembleLDA to Alex in docs (__[sezanzeb](https://github.com/sezanzeb)__, [#3393](https://github.com/RaRe-Technologies/gensim/pull/3393))
+
+### :+1: Improvements
+
+* Switched to Cython language level 3 (__[pabs3](https://github.com/pabs3)__, [#3344](https://github.com/RaRe-Technologies/gensim/pull/3344))
+* Declare variables prior to for loop in fastss.pyx for ANSI C compatibility (__[hstk30](https://github.com/hstk30)__, [#3378](https://github.com/RaRe-Technologies/gensim/pull/3378))
+* Implement numpy hack in setup.py to enable install under Poetry (__[jaymegordo](https://github.com/jaymegordo)__, [#3363](https://github.com/RaRe-Technologies/gensim/pull/3363))
+* Replaceed np.multiply with np.square and copyedit in translation_matrix.py (__[dymil](https://github.com/dymil)__, [#3374](https://github.com/RaRe-Technologies/gensim/pull/3374))
+
+### 🔮 Testing, CI, housekeeping
+
+* Clean up references to `Morfessor`, `tox` and `gensim.models.wrappers` (__[pabs3](https://github.com/pabs3)__, [#3345](https://github.com/RaRe-Technologies/gensim/pull/3345))
+* Pinned sphinx versions, add explicit gallery_top label (__[mpenkov](https://github.com/mpenkov)__, [#3383](https://github.com/RaRe-Technologies/gensim/pull/3383))
+* Updated Python module MANIFEST (__[pabs3](https://github.com/pabs3)__, [#3343](https://github.com/RaRe-Technologies/gensim/pull/3343))
+* Refactored wheel building and testing workflow (__[mpenkov](https://github.com/mpenkov)__, [#3410](https://github.com/RaRe-Technologies/gensim/pull/3410))
 
 ## 4.2.0, 2022-04-29
 
diff --git a/multibuild b/multibuild
index d4b02ce8c7..4e30a05764 160000
--- a/multibuild
+++ b/multibuild
@@ -1 +1 @@
-Subproject commit d4b02ce8c707c8a2bcc721e29f2385149f994b1f
+Subproject commit 4e30a057646d9e70d5e6e7c354e85cfb740d2ca1

From 1a5ee4b403acf0d11d77ee7cad534e5f46f7445b Mon Sep 17 00:00:00 2001
From: Michael Penkov <m@penkov.dev>
Date: Sun, 18 Dec 2022 00:02:10 +0900
Subject: [PATCH 33/34] bumped version to 4.3.0

---
 docs/src/conf.py   | 2 +-
 gensim/__init__.py | 2 +-
 setup.py           | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/docs/src/conf.py b/docs/src/conf.py
index 1789e7353f..75981881de 100644
--- a/docs/src/conf.py
+++ b/docs/src/conf.py
@@ -63,7 +63,7 @@
 # The short X.Y version.
 version = '4.2.0'
 # The full version, including alpha/beta/rc tags.
-release = '4.2.1.dev0'
+release = '4.3.0'
 
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.
diff --git a/gensim/__init__.py b/gensim/__init__.py
index 2ac8d16b66..e7c59b6bd6 100644
--- a/gensim/__init__.py
+++ b/gensim/__init__.py
@@ -4,7 +4,7 @@
 
 """
 
-__version__ = '4.2.1.dev0'
+__version__ = '4.3.0'
 
 import logging
 
diff --git a/setup.py b/setup.py
index 41d9a9c919..deace40c59 100644
--- a/setup.py
+++ b/setup.py
@@ -352,7 +352,7 @@ def run(self):
 
 setup(
     name='gensim',
-    version='4.2.1.dev0',
+    version='4.3.0',
     description='Python framework for fast Vector Space Modelling',
     long_description=LONG_DESCRIPTION,
 

From 99c6c7baa4dd9681b197dd82b3cf1a871b1a168b Mon Sep 17 00:00:00 2001
From: Michael Penkov <m@penkov.dev>
Date: Sun, 18 Dec 2022 00:06:05 +0900
Subject: [PATCH 34/34] bump version in conf.py

---
 docs/src/conf.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/src/conf.py b/docs/src/conf.py
index 75981881de..f6483f8544 100644
--- a/docs/src/conf.py
+++ b/docs/src/conf.py
@@ -61,7 +61,7 @@
 # built documents.
 #
 # The short X.Y version.
-version = '4.2.0'
+version = '4.3'
 # The full version, including alpha/beta/rc tags.
 release = '4.3.0'