Word Cloud - Six Rendering Architectures
Signature
sp.build_wordcloud(title, words, frequencies, *, variant="basic", shape="rect", **kwargs) -> Chart
Description
sp.build_wordcloud() packs weighted tokens into six rendering architectures. Basic is the canonical spiral packer driven by a parametric shape= mask (rect, circle, heart, bird, glasses, diamond, star). Bubble gives each word its own color-filled disc sized by frequency - a packed-bubble layout. Context is an InfraNodus-style text-network cloud: words positioned by a force-directed layout driven by co-occurrence edges so semantically close words cluster spatially, colored by community. Image accepts any binary pixel mask (logo, icon, photo). LabelMap draws a datamapplot-style clustered scatter with leader-line labels. Network renders a keyword co-occurrence graph with bezier-curved edges.
Shapes (for variant basic)
The basic variant accepts a shape= argument that selects the silhouette mask:
| Shape | Aliases | Description |
|---|---|---|
"rect" | rect / rectangle / box / default | Rectangular Archimedean spiral - the textbook word cloud. |
"circle" | circle / round / disk / ball | Words packed inside a perfect disc. |
"heart" | heart / love / valentine | Cardioid heart silhouette. |
"bird" | bird / twitter / tweet / icon | Composite-disk stylised bird silhouette. |
"glasses" | glasses / sunglasses / shades / specs | Sunglasses silhouette (two ellipses + bridge). |
"diamond" | diamond / rhombus / lozenge | Rotated square / rhombus silhouette. |
"star" | star / starburst / 5-point | 5-pointed star silhouette. |
Variants
Parameters
Returns
Chart - object with .html property and .show() method.
Spiral packing inside a parametric shape mask. Pick the silhouette via the `shape=` argument (rect, circle, heart, bird, glasses, diamond, star).
Each word gets a colored disc sized by frequency - a packed-bubble word cloud. Words float in labeled circles, no overlap.
Text-network word cloud (InfraNodus style): words positioned by force-directed layout based on co-occurrence edges, colored by semantic cluster - semantically close words appear spatially close.
Words flow inside a custom binary image mask - upload any silhouette (logo, icon, photo) and the cloud takes its shape.
Datamapplot-style topic map - clustered scatter of points colored per category, with cluster labels positioned via leader lines.
Keyword co-occurrence graph - golden-angle node layout, bezier-curved edges, frequency-sized circles. Editorial style of academic keyword maps.
Neural-network word cloud on a dark background. Words become glowing nodes; faint connecting edges link nearest neighbors, evoking a synaptic graph.
Words placed on a phyllotaxis (sunflower-seed) spiral on a starfield background, largest/most frequent words nearest the center — a constellation-like layout instead of a packed rectangle.
Signature
sp.build_wordcloud(title, words, frequencies, *, variant="basic", shape="rect", **kwargs) -> Chart
Description
sp.build_wordcloud() propose six architectures de rendu. Basic est le packer spirale canonique pilote par un masque shape= (rect, circle, heart, bird, glasses, diamond, star). Bubble donne a chaque mot un disque colore dimensionne par frequence - un layout bubble-packed. Context est un nuage texte-reseau style InfraNodus : mots positionnes par layout force-dirige base sur les aretes de co-occurrence, colores par communaute. Image accepte n importe quel masque binaire de pixels. LabelMap dessine un scatter clusterise style datamapplot avec etiquettes en lignes de rappel. Network rend un graphe de co-occurrence de mots-cles avec aretes bezier.
Formes (pour la variante `basic`)
La variante basic accepte un argument shape= :
| Forme | Alias | Description |
|---|---|---|
"rect" | rect / rectangle / box / default | Rectangular Archimedean spiral - the textbook word cloud. |
"circle" | circle / round / disk / ball | Words packed inside a perfect disc. |
"heart" | heart / love / valentine | Cardioid heart silhouette. |
"bird" | bird / twitter / tweet / icon | Composite-disk stylised bird silhouette. |
"glasses" | glasses / sunglasses / shades / specs | Sunglasses silhouette (two ellipses + bridge). |
"diamond" | diamond / rhombus / lozenge | Rotated square / rhombus silhouette. |
"star" | star / starburst / 5-point | 5-pointed star silhouette. |
Variantes
Paramètres
Retour
Chart - objet avec propriete .html et methode .show().
Packing en spirale dans un masque parametrique. Choisissez la silhouette via l argument `shape=` (rect, circle, heart, bird, glasses, diamond, star).
Chaque mot obtient un disque colore dimensionne par frequence - un nuage de bulles pack. Les mots flottent dans des cercles etiquetes, sans chevauchement.
Nuage de mots texte-reseau (style InfraNodus) : mots positionnes par layout force-dirige base sur les aretes de co-occurrence, colores par cluster semantique - les mots proches semantiquement sont proches spatialement.
Mots a l interieur d un masque binaire personnalise - uploadez n importe quelle silhouette et le nuage en prend la forme.
Carte thematique style datamapplot - scatter de points clusterises colores par categorie, avec etiquettes de cluster positionnees via lignes de rappel.
Graphe de co-occurrence de mots-cles - layout en angle d or, aretes courbes bezier, cercles dimensionnes par frequence. Style editorial des cartes de mots-cles academiques.
Nuage de mots style reseau de neurones sur fond sombre. Les mots deviennent des noeuds lumineux relies par des aretes fines evoquant un graphe synaptique.
Mots places sur une spirale de phyllotaxie (graines de tournesol) sur fond etoile, les mots les plus frequents pres du centre - une disposition en constellation plutot qu'un rectangle compact.