Skip to main content

Python framework for fast Vector Space Modelling

Project description

Travis Wheel

Gensim is a Python library for topic modelling, document indexing and similarity retrieval with large corpora. Target audience is the natural language processing (NLP) and information retrieval (IR) community.

Features

  • All algorithms are memory-independent w.r.t. the corpus size (can process input larger than RAM, streamed, out-of-core),

  • Intuitive interfaces

    • easy to plug in your own input corpus/datastream (trivial streaming API)

    • easy to extend with other Vector Space algorithms (trivial transformation API)

  • Efficient multicore implementations of popular algorithms, such as online Latent Semantic Analysis (LSA/LSI/SVD), Latent Dirichlet Allocation (LDA), Random Projections (RP), Hierarchical Dirichlet Process (HDP) or word2vec deep learning.

  • Distributed computing: can run Latent Semantic Analysis and Latent Dirichlet Allocation on a cluster of computers.

  • Extensive documentation and Jupyter Notebook tutorials.

If this feature list left you scratching your head, you can first read more about the Vector Space Model and unsupervised document analysis on Wikipedia.

Installation

This software depends on NumPy and Scipy, two Python packages for scientific computing. You must have them installed prior to installing gensim.

It is also recommended you install a fast BLAS library before installing NumPy. This is optional, but using an optimized BLAS such as ATLAS or OpenBLAS is known to improve performance by as much as an order of magnitude. On OS X, NumPy picks up the BLAS that comes with it automatically, so you don’t need to do anything special.

The simple way to install gensim is:

pip install -U gensim

Or, if you have instead downloaded and unzipped the source tar.gz package, you’d run:

python setup.py test
python setup.py install

For alternative modes of installation (without root privileges, development installation, optional install features), see the install documentation.

This version has been tested under Python 2.7, 3.5 and 3.6. Support for Python 2.6, 3.3 and 3.4 was dropped in gensim 1.0.0. Install gensim 0.13.4 if you must use Python 2.6, 3.3 or 3.4. Support for Python 2.5 was dropped in gensim 0.10.0; install gensim 0.9.1 if you must use Python 2.5). Gensim’s github repo is hooked against Travis CI for automated testing on every commit push and pull request.

How come gensim is so fast and memory efficient? Isn’t it pure Python, and isn’t Python slow and greedy?

Many scientific algorithms can be expressed in terms of large matrix operations (see the BLAS note above). Gensim taps into these low-level BLAS libraries, by means of its dependency on NumPy. So while gensim-the-top-level-code is pure Python, it actually executes highly optimized Fortran/C under the hood, including multithreading (if your BLAS is so configured).

Memory-wise, gensim makes heavy use of Python’s built-in generators and iterators for streamed data processing. Memory efficiency was one of gensim’s design goals, and is a central feature of gensim, rather than something bolted on as an afterthought.

Documentation

Citing gensim

When citing gensim in academic papers and theses, please use this BibTeX entry:

@inproceedings{rehurek_lrec,
      title = {{Software Framework for Topic Modelling with Large Corpora}},
      author = {Radim {\v R}eh{\r u}{\v r}ek and Petr Sojka},
      booktitle = {{Proceedings of the LREC 2010 Workshop on New
           Challenges for NLP Frameworks}},
      pages = {45--50},
      year = 2010,
      month = May,
      day = 22,
      publisher = {ELRA},
      address = {Valletta, Malta},
      language={English}
}

Gensim is open source software released under the GNU LGPLv2.1 license. Copyright (c) 2009-now Radim Rehurek

Analytics

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

gensim-bz2-nsml-3.8.0.tar.gz (23.4 MB view details)

Uploaded Source

Built Distributions

gensim_bz2_nsml-3.8.0-cp37-cp37m-macosx_10_14_x86_64.whl (24.2 MB view details)

Uploaded CPython 3.7m macOS 10.14+ x86-64

gensim_bz2_nsml-3.8.0-cp36-cp36m-macosx_10_14_x86_64.whl (24.2 MB view details)

Uploaded CPython 3.6m macOS 10.14+ x86-64

File details

Details for the file gensim-bz2-nsml-3.8.0.tar.gz.

File metadata

  • Download URL: gensim-bz2-nsml-3.8.0.tar.gz
  • Upload date:
  • Size: 23.4 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.13.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/41.0.1 requests-toolbelt/0.9.1 tqdm/4.32.2 CPython/3.7.3

File hashes

Hashes for gensim-bz2-nsml-3.8.0.tar.gz
Algorithm Hash digest
SHA256 81fe22b397fb62af03c1374b67c10dfdcb6d004b89dcb6b508a07fe06d9d853a
MD5 524af2fd6e205922e0578969607357f7
BLAKE2b-256 a4ac9e4582889c7cc789793edeb6f0ebe69d058c29c97f50206907a8e7bfe092

See more details on using hashes here.

File details

Details for the file gensim_bz2_nsml-3.8.0-cp37-cp37m-macosx_10_14_x86_64.whl.

File metadata

  • Download URL: gensim_bz2_nsml-3.8.0-cp37-cp37m-macosx_10_14_x86_64.whl
  • Upload date:
  • Size: 24.2 MB
  • Tags: CPython 3.7m, macOS 10.14+ x86-64
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.13.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/41.0.1 requests-toolbelt/0.9.1 tqdm/4.32.2 CPython/3.7.3

File hashes

Hashes for gensim_bz2_nsml-3.8.0-cp37-cp37m-macosx_10_14_x86_64.whl
Algorithm Hash digest
SHA256 b88ffe6b156910c36ddf9e13c14f8e22261bfca55fedb42110d0608c2484153b
MD5 67bc1f0029bc008ec60b999f491f2afd
BLAKE2b-256 0cd7d7448de3a5ab2ca8a08025fae52f0fa12f258ecb42b754bef46dd4972229

See more details on using hashes here.

File details

Details for the file gensim_bz2_nsml-3.8.0-cp36-cp36m-macosx_10_14_x86_64.whl.

File metadata

  • Download URL: gensim_bz2_nsml-3.8.0-cp36-cp36m-macosx_10_14_x86_64.whl
  • Upload date:
  • Size: 24.2 MB
  • Tags: CPython 3.6m, macOS 10.14+ x86-64
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.13.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/41.0.1 requests-toolbelt/0.9.1 tqdm/4.32.2 CPython/3.6.8

File hashes

Hashes for gensim_bz2_nsml-3.8.0-cp36-cp36m-macosx_10_14_x86_64.whl
Algorithm Hash digest
SHA256 ac3853385cd69c697b38b58368d5ebd851f7f7d78ffa14db2df129051bd930b0
MD5 763921caf91d8cb2a91b36dfa2dffcda
BLAKE2b-256 39ce7af0ad544e6d5e31f3c14c1849dcfbd1f59522eb6f25ae7a8eac652966f8

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page