Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Word Cloud

Signature

sp.build_wordcloud(
    title: str,
    words: list[str],
    weights: list[float],
    *,
    width: int = 900,
    height: int = 480,
    palette: list[int] | None = None,
    background: str | None = None,
    max_words: int = 200,
) -> Chart

Aliases: sp.wordcloud


Description

Word cloud (tag cloud) where font size reflects the weight of each word.

Words with higher weights are displayed larger. Layout is computed via a spiral placement algorithm.


Parameters

ParameterTypeDefaultDescription
titlestrrequiredChart title
wordslist[str]requiredWord
weightslist[float]requiredWeight per word (higher = larger)
widthint900Canvas width
heightint480Canvas height
palettelist[int] | NoneNoneCustom color palette
backgroundstr | NoneNoneBackground color
max_wordsint200Maximum number of words rendered

Returns

Chart


Examples

Technology popularity

import seraplot as sp
from collections import Counter
text = "python python rust rust rust go go java javascript python data ml deep learning neural"
counts = Counter(text.split())
chart = sp.build_wordcloud(
    "Tech Mentions",
    words=list(counts.keys()),
    frequencies=list(counts.values()),
    palette=[0x6366f1, 0x22d3ee, 0xf43f5e, 0xf59e0b, 0x10b981],
)
const sp = require('seraplot');
from collections import Counter
const text = "python python rust rust rust go go java javascript python data ml deep learning neural"
const counts = Counter(text.split())
const chart = sp.build_wordcloud("Tech Mentions",
list(counts.keys()),
{
    frequencies: list(counts.values()),
    palette: [0x6366f1, 0x22d3ee, 0xf43f5e, 0xf59e0b, 0x10b981]
})
import * as sp from 'seraplot';
from collections import Counter
const text: string = "python python rust rust rust go go java javascript python data ml deep learning neural"
const counts = Counter(text.split())
const chart = sp.build_wordcloud("Tech Mentions",
list(counts.keys()),
{
    frequencies: list(counts.values()),
    palette: [0x6366f1, 0x22d3ee, 0xf43f5e, 0xf59e0b, 0x10b981]
})
▶ Live Preview

See also

Signature

sp.build_wordcloud(
    title: str,
    words: list[str],
    weights: list[float],
    *,
    width: int = 900,
    height: int = 480,
    palette: list[int] | None = None,
    background: str | None = None,
    max_words: int = 200,
) -> Chart

Aliases: sp.wordcloud


Description

Nuage de mots où la taille de la police reflète le poids de chaque mot. Les mots avec un weights plus élevé sont affichés en plus grand. La disposition est calculée via un algorithme de placement en spirale.


Paramètres

ParamètreTypeDéfautDescription
titlestrrequisTitre du graphique
wordslist[str]requisListe des mots
weightslist[float]requisPoids par mot (plus élevé = plus grand)
widthint900Largeur du canvas
heightint480Hauteur du canvas
palettelist[int] | NoneNonePalette de couleurs
backgroundstr | NoneNoneCouleur de fond
max_wordsint200Nombre maximum de mots affichés

Retourne

Chart


Exemples

Popularité des technologies

import seraplot as sp
from collections import Counter

texte = "python python rust rust rust go go java javascript python data ml deep learning neural"
counts = Counter(texte.split())

chart = sp.build_wordcloud(
    "Mentions technologiques",
    words=list(counts.keys()),
    weights=list(counts.values()),
    palette=[0x6366f1, 0x22d3ee, 0xf43f5e, 0xf59e0b, 0x10b981],
)

Voir aussi