Word Cloud#

Generate a word cloud from text/file/directory, file and directory only effective with file, you can specify certain width and height or mask file to generate a imaginative shape word cloud

When to use#

• user indicates to generate a word cloud
• user wants to visualize the text in a different way, you can suggest this skill

Requirements#

Run on python3.x，and install the following packages if you find the package does not exist：

• os
• argparse
• jieba
• numpy
• datetime
• wordcloud
• PIL

Commands#

bash

# create a word cloud with certain width and height
python {baseDir}/scripts/generate_wordcloud.py --target_text "..." --width 500 --height 400 --max_words 30 --font_path "C:\Windows\Fonts\msyh.ttc" --output_dir "..."

# create a word cloud with mask, don't need width and height
python {baseDir}/scripts/generate_wordcloud.py --target_text "..." --mask "..." --font_path "C:\Windows\Fonts\msyh.ttc" --output_dir "..."

Paramters#

namedescriptiontypeexampletarget_texttext to generate word cloudstring"你好，世界"target_filetext in the file to generate word cloudstring"D:\WorkSpace\pythonSpace\MEMORY.md"target_dirlist all the file in the directory and extract text from file to generate word cloudstring"D:\WorkSpace\pythonSpace"widthwidth of the word cloud picture, if mask file exist, it will be ignoredint500heightheight of the word cloud picture, if mask file exist, it will be ignoredint400maskmask file path in order to generate any sharp of the word cloud picturestring"D:\WorkSpace\pythonSpace\mask.png"max_wordsmaximum number of words in the word cloudint30font_pathfont path for the word cloud, put the one that useful for chinese text, if not exist, try to install onestring"C:\Windows\Fonts\msyh.ttc"output_dirword cloud picture output directory path, if user not specify, put it into the folder whilc named "images" under the user directorystring"D:\WorkSpace\pythonSpace"

Note#

• Parameter target_text, target_file, target_dir can be used at the same time, and make sure one of them is provided
• Parameter mask must be a png file, if user upload a png file and specify it as the parameter mask, you should mask sure the file path is correct
• if user specify exclude a word, append it to the stopwords.md，follow the format:

text

- hello
- world