这款工具可以帮助生成风格多样的词云,包括梯度和图标形状!

stylecloud 是一个 Python 包,它基于流行的 word_cloud 包,并添加了一些有用的功能,从而创建出独特的词云。stylecloud 具备以下特点:

  • 为词云提供(任意大小)的图标形状(通过 Font Awesome 5.11.2 获得);
  • 支持高级调色板(通过 palettable 实现);
  • 为上述调色板提供直接梯度;
  • 支持读取文本文件,或预生成的 CSV 文件(包含单词和数字);
  • 提供命令行接口。

stylecloud 包由数据科学家 Max Woolf 创建,是对其 2016 年风格化词云项目的较正式实现。

词云图怎么添加蒙版背景(更改形状和背景色)(1)

stylecloud 项目地址:https://github.com/minimaxir/stylecloud

安装

你可以通过 pip 安装 stylecloud:

pip3 install stylecloud

使用

你可以通过 Python 脚本使用 stylecloud,也可以直接使用独立的 CLI app。假如你有一份美国宪法的文本文件 constitution.txt。

使用以下 Python 脚本:

import stylecloudstylecloud.gen_stylecloud(file_path='constitution.txt')

得到如下词云:


词云图怎么添加蒙版背景(更改形状和背景色)(2)


但你可以做到更多!比如使用 Font Awesome 提供的免费图标更改词云的形状,通过 palettable 更改调色板以自定义风格,更改背景颜色,以及最重要的,添加梯度使颜色按照特定方向流动。

import stylecloud stylecloud.gen_stylecloud(file_path='constitution.txt', icon_name='fas fa-dog', palette='colorbrewer.diverging.Spectral_11', background_color='black', gradient='horizontal')

词云图怎么添加蒙版背景(更改形状和背景色)(3)

你还可以使用 CLI 执行更快速的 stylecloud 生成!对于上文中的旗形 stylecloud,使用:

stylecloud --file_path constitution.txt

对于更复杂的犬形 stylecloud,使用:

stylecloud --file_path constitution.txt --icon_name 'fas fa-dog' --palette colorbrewer.diverging.Spectral_11 --background_color black --gradient horizontal


你可以在 stylecloud-examples repo 中查看 stylecloud 的更多示例,比如如何基于 Twitter 和 Reddit 数据制作 stylecloud。


地址:https://github.com/minimaxir/stylecloud-examples


有用的参数


以下参数对 stylecloud Python 函数和 CLI 均有效,你可以通过 stylecloud -h 获取这些参数的信息。

  • text:输入文本。最好在直接调用函数时使用。
  • file_path:输入文本/CSV 的文件路径。最好在 CLI 上使用。
  • gradient:梯度方向。(其默认值是 None,如果它的值不是 None,则 stylecloud 使用了方向性梯度。)[default: None]
  • size:stylecloud 的大小(长度和宽度)。[default: 512]
  • icon_name:stylecloud 形状的图标名称(如 fas fa-grin)。[default: fas fa-flag]
  • palette:调色板(通过 palettable 实现)。[default: cartocolors.qualitative.Bold_6]
  • background_color:背景颜色。[default: white]
  • max_font_size:stylecloud 中的最大字号。[default: 200]
  • max_words:stylecloud 可包含的最大单词数。[default: 2000]
  • stopwords:布尔值,用于筛除常见禁用词。[default: True]
  • output_name:stylecloud 的输出文本名。[default: stylecloud.png]
  • font_path:stylecloud 所用字体 .ttf 文件的路径。[default: uses included Staatliches font]
  • random_state:控制单词和颜色的随机状态。

小贴士

stylecloud 的主要目标是为文本数据可视化结果提供独特的美感。词云强调统计上可靠的数据可视化,而 stylecloud 更注重「酷」!

stylecloud 包独立于 word_cloud 单独发布,因为它的适用范围和 Python 依赖项均有所增长。

生成优秀 stylecloud 需要的完美字体是:加粗/高字重,以提高可读性;紧凑/低间距,以容纳更多文本。这两个特点就是 stylecloud 使用 Staatliches 作为默认字体的原因(而不是 base word_cloud 使用的 Droid Sans 字体)。

  • 在生成 stylecloud 后,你可能想做一些后处理:例如添加颜色掩码,添加感知偏移,将 stylecloud 输入风格迁移 AI 模型等等。
  • max_font_size 的默认值 200 与 size 的默认值 512 呈正相关,如要增加 size,你还需要考虑增加 max_font_size 的值。
  • 由于 stylecloud 内置 Font Awesome 字体文件的大小,它们不会在 Font Awesome 每次小型新发布时进行更新。
  • 推荐使用大且重的 Font Awesome 图标,轻图标可能会过度约束文本。
  • 如果使用默认随机颜色采样(random-color-sampling)方法,推荐使用 qualitative 调色板。反之,如果使用颜色梯度,推荐使用非 qualitative 调色板(如 sequential 调色板)。

展望

stylecloud 的开发者表示未来将提供以下新功能:

  • 支持自定义字体文件(如 Font Awesome Pro);
  • 创建一个运行 stylecloud 的 app。
,