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
# 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
| name | description | type | example |
|---|---|---|---|
| target_text | text to generate word cloud | string | "你好，世界" |
| target_file | text in the file to generate word cloud | string | "D:\WorkSpace\pythonSpace\MEMORY.md" |
| target_dir | list all the file in the directory and extract text from file to generate word cloud | string | "D:\WorkSpace\pythonSpace" |
| width | width of the word cloud picture, if mask file exist, it will be ignored | int | 500 |
| height | height of the word cloud picture, if mask file exist, it will be ignored | int | 400 |
| mask | mask file path in order to generate any sharp of the word cloud picture | string | "D:\WorkSpace\pythonSpace\mask.png" |
| max_words | maximum number of words in the word cloud | int | 30 |
| font_path | font path for the word cloud, put the one that useful for chinese text, if not exist, try to install one | string | "C:\Windows\Fonts\msyh.ttc" |
| output_dir | word cloud picture output directory path, if user not specify, put it into the folder whilc named "images" under the user directory | string | "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:
- hello
- world