Skip to main content

A little word cloud generator

Project description

licence DOI

Linux macOS Windows
PyPI CircleCI TravisCI AppVeyor

word_cloud

A little word cloud generator in Python. Read more about it on the blog post or the website.

The code is tested against Python 2.7, 3.4, 3.5, 3.6 and 3.7.

Installation

If you are using pip:

pip install wordcloud

If you are using conda, you can install from the conda-forge channel:

conda install -c conda-forge wordcloud

Installation notes

wordcloud depends on numpy and pillow.

To save the wordcloud into a file, matplotlib can also be installed. See examples below.

If there are no wheels available for your version of python, installing the package requires having a C compiler set up. Before installing a compiler, report an issue describing the version of python and operating system being used.

Examples

Check out examples/simple.py for a short intro. A sample output is:

Constitution

Or run examples/masked.py to see more options. A sample output is:

Alice in Wonderland

Getting fancy with some colors: Parrot with rainbow colors

Command-line usage

The wordcloud_cli tool can be used to generate word clouds directly from the command-line:

$ wordcloud_cli --text mytext.txt --imagefile wordcloud.png

If you're dealing with PDF files, then pdftotext, included by default with many Linux distribution, comes in handy:

$ pdftotext mydocument.pdf - | wordcloud_cli --imagefile wordcloud.png

In the previous example, the - argument orders pdftotext to write the resulting text to stdout, which is then piped to the stdin of wordcloud_cli.py.

Use wordcloud_cli --help so see all available options.

Licensing

The wordcloud library is MIT licenced, but contains DroidSansMono.ttf, a true type font by Google, that is apache licensed. The font is by no means integral, and any other font can be used by setting the font_path variable when creating a WordCloud object.

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

wordcloud-1.5.0.tar.gz (215.2 kB view details)

Uploaded Source

Built Distributions

wordcloud-1.5.0-cp37-cp37m-win_amd64.whl (153.7 kB view details)

Uploaded CPython 3.7m Windows x86-64

wordcloud-1.5.0-cp37-cp37m-manylinux1_x86_64.whl (361.0 kB view details)

Uploaded CPython 3.7m

wordcloud-1.5.0-cp37-cp37m-macosx_10_6_x86_64.whl (157.7 kB view details)

Uploaded CPython 3.7m macOS 10.6+ x86-64

wordcloud-1.5.0-cp36-cp36m-win_amd64.whl (153.9 kB view details)

Uploaded CPython 3.6m Windows x86-64

wordcloud-1.5.0-cp36-cp36m-manylinux1_x86_64.whl (361.3 kB view details)

Uploaded CPython 3.6m

wordcloud-1.5.0-cp36-cp36m-macosx_10_6_x86_64.whl (157.7 kB view details)

Uploaded CPython 3.6m macOS 10.6+ x86-64

wordcloud-1.5.0-cp35-cp35m-win_amd64.whl (153.4 kB view details)

Uploaded CPython 3.5m Windows x86-64

wordcloud-1.5.0-cp35-cp35m-manylinux1_x86_64.whl (357.2 kB view details)

Uploaded CPython 3.5m

wordcloud-1.5.0-cp35-cp35m-macosx_10_6_x86_64.whl (157.1 kB view details)

Uploaded CPython 3.5m macOS 10.6+ x86-64

wordcloud-1.5.0-cp34-cp34m-win_amd64.whl (152.1 kB view details)

Uploaded CPython 3.4m Windows x86-64

wordcloud-1.5.0-cp34-cp34m-manylinux1_x86_64.whl (363.5 kB view details)

Uploaded CPython 3.4m

wordcloud-1.5.0-cp34-cp34m-macosx_10_6_x86_64.whl (160.1 kB view details)

Uploaded CPython 3.4m macOS 10.6+ x86-64

wordcloud-1.5.0-cp27-cp27mu-manylinux1_x86_64.whl (345.4 kB view details)

Uploaded CPython 2.7mu

wordcloud-1.5.0-cp27-cp27m-win_amd64.whl (153.5 kB view details)

Uploaded CPython 2.7m Windows x86-64

wordcloud-1.5.0-cp27-cp27m-manylinux1_x86_64.whl (345.3 kB view details)

Uploaded CPython 2.7m

wordcloud-1.5.0-cp27-cp27m-macosx_10_6_x86_64.whl (160.0 kB view details)

Uploaded CPython 2.7m macOS 10.6+ x86-64

File details

Details for the file wordcloud-1.5.0.tar.gz.

File metadata

  • Download URL: wordcloud-1.5.0.tar.gz
  • Upload date:
  • Size: 215.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for wordcloud-1.5.0.tar.gz
Algorithm Hash digest
SHA256 6ceed30c943b49e8e8b222a4d5a6725bbeca180fada7a04c4121ed238d6896e6
MD5 6d0341379dc94742bc57aa67450a033f
BLAKE2b-256 d495d260ce89441d1f28192fa5a0a016f547829517b11cabe0079ab91c56f6cd

See more details on using hashes here.

File details

Details for the file wordcloud-1.5.0-cp37-cp37m-win_amd64.whl.

File metadata

  • Download URL: wordcloud-1.5.0-cp37-cp37m-win_amd64.whl
  • Upload date:
  • Size: 153.7 kB
  • Tags: CPython 3.7m, Windows x86-64
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.11.0 pkginfo/1.4.2 requests/2.19.1 setuptools/40.0.0 requests-toolbelt/0.8.0 tqdm/4.24.0 CPython/3.7.0

File hashes

Hashes for wordcloud-1.5.0-cp37-cp37m-win_amd64.whl
Algorithm Hash digest
SHA256 5259f04f0e06a58c313e4c9c145a11ca8c4443bb5d9195414160c0f359d047d8
MD5 23eb0a5ff3f64743d7af96cbd8f3283b
BLAKE2b-256 234e1254d26ce5d36facdcbb5820e7e434328aed68e99938c75c9d4e2fee5efb

See more details on using hashes here.

File details

Details for the file wordcloud-1.5.0-cp37-cp37m-manylinux1_x86_64.whl.

File metadata

File hashes

Hashes for wordcloud-1.5.0-cp37-cp37m-manylinux1_x86_64.whl
Algorithm Hash digest
SHA256 9b87d3ccb7829f8e5fbe1847126f9d232bd7d8d299475e5fc8e5331c5cd52fa6
MD5 be79a8c99d4c19e970067cfca1816926
BLAKE2b-256 befe4e718808c7bfb641e8964c2e40a6ae2a51c74ea493a6701b89ba417bc769

See more details on using hashes here.

File details

Details for the file wordcloud-1.5.0-cp37-cp37m-macosx_10_6_x86_64.whl.

File metadata

File hashes

Hashes for wordcloud-1.5.0-cp37-cp37m-macosx_10_6_x86_64.whl
Algorithm Hash digest
SHA256 5a90670745e346e468ec0e203e329e8c44392a4e9aae38dcceb4d313ac0dc939
MD5 025ddfd99870d36222bf71aa45fe2789
BLAKE2b-256 c707e43a7094a58e602e85a09494d9b99e7b5d71ca4789852287386e21e74c33

See more details on using hashes here.

File details

Details for the file wordcloud-1.5.0-cp36-cp36m-win_amd64.whl.

File metadata

  • Download URL: wordcloud-1.5.0-cp36-cp36m-win_amd64.whl
  • Upload date:
  • Size: 153.9 kB
  • Tags: CPython 3.6m, Windows x86-64
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.11.0 pkginfo/1.4.2 requests/2.19.1 setuptools/40.0.0 requests-toolbelt/0.8.0 tqdm/4.24.0 CPython/3.6.6

File hashes

Hashes for wordcloud-1.5.0-cp36-cp36m-win_amd64.whl
Algorithm Hash digest
SHA256 2804995d361438fde75114543d5e48cf4b9f6bc74327c7ed6973ccba0e11221d
MD5 cefbc94ea6aeb420ef7495da10481e9e
BLAKE2b-256 dd578fd38e31be7951f9164f4cb3a769159a0c2ef4af0f597ddf09a7e736593e

See more details on using hashes here.

File details

Details for the file wordcloud-1.5.0-cp36-cp36m-manylinux1_x86_64.whl.

File metadata

File hashes

Hashes for wordcloud-1.5.0-cp36-cp36m-manylinux1_x86_64.whl
Algorithm Hash digest
SHA256 c567d8d5e6743932f1748ac0db6235dc8948fdf34c4819dffebc4914b9e37d3c
MD5 dc5348965f4a74ab2a97ce9839c498b6
BLAKE2b-256 aeaf849edf14d573eba9c8082db898ff0d090428d9485371cc4fe21a66717ad2

See more details on using hashes here.

File details

Details for the file wordcloud-1.5.0-cp36-cp36m-macosx_10_6_x86_64.whl.

File metadata

File hashes

Hashes for wordcloud-1.5.0-cp36-cp36m-macosx_10_6_x86_64.whl
Algorithm Hash digest
SHA256 d13cce1ad31d5dc6d9d276a5745fe1067d40b680901fad45527bad660f28232e
MD5 d8eaef6a633610c61128a6eb7693aa80
BLAKE2b-256 550114a0c510c936cefd4bc7d77281ead4deee10d238cdfb01f1ce5b7c5fa5c7

See more details on using hashes here.

File details

Details for the file wordcloud-1.5.0-cp35-cp35m-win_amd64.whl.

File metadata

  • Download URL: wordcloud-1.5.0-cp35-cp35m-win_amd64.whl
  • Upload date:
  • Size: 153.4 kB
  • Tags: CPython 3.5m, Windows x86-64
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.11.0 pkginfo/1.4.2 requests/2.19.1 setuptools/40.0.0 requests-toolbelt/0.8.0 tqdm/4.24.0 CPython/3.5.3

File hashes

Hashes for wordcloud-1.5.0-cp35-cp35m-win_amd64.whl
Algorithm Hash digest
SHA256 578996a2ac83d2199f96661e66af587f010ffb472744fd834186cdfd060d5e38
MD5 98071aa4e97ec36f402f3357b892b7fa
BLAKE2b-256 701b6132f55ad986e213d58fee3fc97947e8681ea93e72a6f76585e9844b2cfb

See more details on using hashes here.

File details

Details for the file wordcloud-1.5.0-cp35-cp35m-manylinux1_x86_64.whl.

File metadata

File hashes

Hashes for wordcloud-1.5.0-cp35-cp35m-manylinux1_x86_64.whl
Algorithm Hash digest
SHA256 c7c0de04c68bef168d51ece614e979b19a22287101efbf86ad0b23e91a9f8405
MD5 a9408161fb73eaa771ccf84c2e2b5794
BLAKE2b-256 5eb7c16286efa3d442d6983b3842f982502c00306c1a4c719c41fb00d6017c77

See more details on using hashes here.

File details

Details for the file wordcloud-1.5.0-cp35-cp35m-macosx_10_6_x86_64.whl.

File metadata

File hashes

Hashes for wordcloud-1.5.0-cp35-cp35m-macosx_10_6_x86_64.whl
Algorithm Hash digest
SHA256 5425b176d9d8a634130db398400a830aa1f43a2bd1d60e16801764ae2b44ed4a
MD5 6cf3b7f6acbedd868616d36f9a06a2ef
BLAKE2b-256 0de1e9b3b476e9bc6169dcc59ca3496da0d968985170b6c6f750269d8034ae77

See more details on using hashes here.

File details

Details for the file wordcloud-1.5.0-cp34-cp34m-win_amd64.whl.

File metadata

  • Download URL: wordcloud-1.5.0-cp34-cp34m-win_amd64.whl
  • Upload date:
  • Size: 152.1 kB
  • Tags: CPython 3.4m, Windows x86-64
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.11.0 pkginfo/1.4.2 requests/2.19.1 setuptools/40.0.0 requests-toolbelt/0.8.0 tqdm/4.24.0 CPython/3.4.4

File hashes

Hashes for wordcloud-1.5.0-cp34-cp34m-win_amd64.whl
Algorithm Hash digest
SHA256 a8b7b896e7c767afc4d195d0c1657320d6e3db1e02a919eeb2d895b0c277afd9
MD5 98d13a6a559ecb99f9057288b770ab2f
BLAKE2b-256 d188fd58b56da206ab97d6c8feaf5154f65fd86f8b1ff0307733fb15e0cb6627

See more details on using hashes here.

File details

Details for the file wordcloud-1.5.0-cp34-cp34m-manylinux1_x86_64.whl.

File metadata

File hashes

Hashes for wordcloud-1.5.0-cp34-cp34m-manylinux1_x86_64.whl
Algorithm Hash digest
SHA256 80b6646a821537faa88b4bba78e35c20f9056bd7227b76fcf065b6627709c089
MD5 6cef5586c167c453407b3343cf0e9d0a
BLAKE2b-256 7635f0fe5595ea23c8cc6552b688be03d8e27e585927ef87d9e6a05e8bd78dc3

See more details on using hashes here.

File details

Details for the file wordcloud-1.5.0-cp34-cp34m-macosx_10_6_x86_64.whl.

File metadata

File hashes

Hashes for wordcloud-1.5.0-cp34-cp34m-macosx_10_6_x86_64.whl
Algorithm Hash digest
SHA256 1ba7de6e3179f77f390fa70a363fcd8a3708dd79df7994738f0ba20e6b4eec4a
MD5 a14ece33ba5a15e126a401346c7ef811
BLAKE2b-256 b6295102d9841e4e4323a2e0498bc5cf0ed9965b91f5cd0346c83ad3324c371e

See more details on using hashes here.

File details

Details for the file wordcloud-1.5.0-cp27-cp27mu-manylinux1_x86_64.whl.

File metadata

File hashes

Hashes for wordcloud-1.5.0-cp27-cp27mu-manylinux1_x86_64.whl
Algorithm Hash digest
SHA256 78a856ca60be4c912cd27c3050dd4ad79e34ca021cd83fd61b77bbb10a84a089
MD5 92b088148eac43b250087e9e264063dd
BLAKE2b-256 8e4e9e01986bb40886bb71b572115cead5f445f7221a285a407d2274be21fc27

See more details on using hashes here.

File details

Details for the file wordcloud-1.5.0-cp27-cp27m-win_amd64.whl.

File metadata

  • Download URL: wordcloud-1.5.0-cp27-cp27m-win_amd64.whl
  • Upload date:
  • Size: 153.5 kB
  • Tags: CPython 2.7m, Windows x86-64
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.11.0 pkginfo/1.4.2 requests/2.19.1 setuptools/40.0.0 requests-toolbelt/0.8.0 tqdm/4.24.0 CPython/2.7.15

File hashes

Hashes for wordcloud-1.5.0-cp27-cp27m-win_amd64.whl
Algorithm Hash digest
SHA256 f2df3140b4355b589316f4bc80e08f4385cd74a57d6de6e97d2f85847e2161c5
MD5 8eca8160acbd46a7b0a1101a5fac12eb
BLAKE2b-256 eab8e0b3315020bdbb7b4cb6f429340f1f0576f7bbfe24be3c96608932a7d609

See more details on using hashes here.

File details

Details for the file wordcloud-1.5.0-cp27-cp27m-manylinux1_x86_64.whl.

File metadata

File hashes

Hashes for wordcloud-1.5.0-cp27-cp27m-manylinux1_x86_64.whl
Algorithm Hash digest
SHA256 2c67ae08992ced6ee465b31e307e2d686c593fd5d25459b7bf79effd08e5b797
MD5 0fa8dfab294ebae520062df754f69fef
BLAKE2b-256 ae69c44927aa9ccaf115ac922594275a31f6e7440882b63551962ea261db228a

See more details on using hashes here.

File details

Details for the file wordcloud-1.5.0-cp27-cp27m-macosx_10_6_x86_64.whl.

File metadata

File hashes

Hashes for wordcloud-1.5.0-cp27-cp27m-macosx_10_6_x86_64.whl
Algorithm Hash digest
SHA256 a0e70a23de1e978059a35a1fda976d921b802f0ef7cd145283be7a0772f46b11
MD5 fb0de60ce96f31fe6402a90995d6712b
BLAKE2b-256 6a08bb19140487a81fa111e21f4ff7fbc37ec4c9a56450fb36423cecade5ce0d

See more details on using hashes here.

Supported by

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