Grouped Bar Chart
Signature
sp.build_grouped_bar(
title: str,
category_labels: list[str],
series_values: list[float],
*,
show_values: bool = False,
series_names: list[str] | None = None,
width: int = 900,
height: int = 480,
x_label: str = "",
y_label: str = "",
gridlines: bool = False,
sort_order: str = "none",
hover_json: str = "",
legend_position: str = "right",
palette: list[int] | None = None,
background: str | None = None,
no_x_axis: bool = False,
no_y_axis: bool = False,
) -> Chart
Aliases: sp.grouped_bar
Description
Grouped bar chart for comparing multiple series across categories.
series_values must be a flat list of length n_categories × n_series, row-major (category-first).
Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
title | str | required | Chart title |
category_labels | list[str] | required | Category names on X axis |
series_values | list[float] | required | Flat values: [cat0_s0, cat0_s1, cat1_s0, cat1_s1, ...] |
show_values | bool | False | Show value labels |
series_names | list[str] | None | None | Series names for legend |
palette | list[int] | None | None | Custom color palette |
width | int | 900 | Canvas width in pixels |
height | int | 480 | Canvas height in pixels |
legend_position | str | "right" | Legend position |
gridlines | bool | False | Show grid lines |
Returns
Chart
Examples
import seraplot as sp
categories = ["Q1", "Q2", "Q3", "Q4"]
values = [
120.0, 90.0, 150.0,
130.0, 110.0, 140.0,
100.0, 95.0, 160.0,
140.0, 120.0, 175.0,
]
logo = "https://raw.githubusercontent.com/feur25/seraplot-documentation/main/logo.png"
hover = sp.build_hover_json(categories * 3, images=[logo] * len(categories * 3))
chart = (
sp.build_grouped_bar(
"Quarterly Sales by Product",
category_labels=categories,
series_values=values,
series_names=["Product A", "Product B", "Product C"],
show_values=True,
gridlines=True,
legend_position="bottom",
hover_json=hover,
)
.set_bg(None)
)const sp = require('seraplot');
const categories = ["Q1", "Q2", "Q3", "Q4"]
const values = [
120.0, 90.0, 150.0,
130.0, 110.0, 140.0,
100.0, 95.0, 160.0,
140.0, 120.0, 175.0,
]
const logo = "https://raw.githubusercontent.com/feur25/seraplot-documentation/main/logo.png"
const hover = sp.build_hover_json(categories * 3,
[logo])
const chart = (
sp.build_grouped_bar("Quarterly Sales by Product",
categories,
{
series_values: values,
series_names: ["Product A", "Product B", "Product C"],
show_values: true,
gridlines: true,
legend_position: "bottom",
hover_json: hover
})
.set_bg(null)
)import * as sp from 'seraplot';
const categories: string[] = ["Q1", "Q2", "Q3", "Q4"]
const values: number[] = [
120.0, 90.0, 150.0,
130.0, 110.0, 140.0,
100.0, 95.0, 160.0,
140.0, 120.0, 175.0,
]
const logo: string = "https://raw.githubusercontent.com/feur25/seraplot-documentation/main/logo.png"
const hover = sp.build_hover_json(categories * 3,
[logo])
const chart = (
sp.build_grouped_bar("Quarterly Sales by Product",
categories,
{
series_values: values,
series_names: ["Product A", "Product B", "Product C"],
show_values: true,
gridlines: true,
legend_position: "bottom",
hover_json: hover
})
.set_bg(null)
)▶ Live Preview
See also
- Stacked Bar —
sp.build_stacked_bar() - Bar Chart
Signature
sp.build_grouped_bar(
title: str,
category_labels: list[str],
series_values: list[float],
*,
show_values: bool = False,
series_names: list[str] | None = None,
width: int = 900,
height: int = 480,
x_label: str = "",
y_label: str = "",
gridlines: bool = False,
sort_order: str = "none",
hover_json: str = "",
legend_position: str = "right",
palette: list[int] | None = None,
background: str | None = None,
no_x_axis: bool = False,
no_y_axis: bool = False,
) -> Chart
Aliases: sp.grouped_bar
Description
Graphique en barres groupées pour comparer plusieurs séries sur les mêmes catégories.
series_values doit être une liste plate de longueur n_catégories × n_séries, en ordre catégorie-major.
Paramètres
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
title | str | requis | Titre du graphique |
category_labels | list[str] | requis | Noms des catégories sur l'axe X |
series_values | list[float] | requis | Valeurs plates : [cat0_s0, cat0_s1, cat1_s0, cat1_s1, ...] |
show_values | bool | False | Afficher les étiquettes de valeur |
series_names | list[str] | None | None | Noms des séries pour la légende |
palette | list[int] | None | None | Palette de couleurs personnalisée |
width | int | 900 | Largeur du canvas |
height | int | 480 | Hauteur du canvas |
legend_position | str | "right" | Position de la légende |
gridlines | bool | False | Lignes de grille |
Retourne
Chart
Exemples
import seraplot as sp
categories = ["T1", "T2", "T3", "T4"]
valeurs = [
120.0, 90.0, 150.0,
130.0, 110.0, 140.0,
100.0, 95.0, 160.0,
140.0, 120.0, 175.0,
]
chart = (
sp.build_grouped_bar(
"Ventes trimestrielles par produit",
category_labels=categories,
series_values=valeurs,
series_names=["Produit A", "Produit B", "Produit C"],
show_values=True,
gridlines=True,
legend_position="bottom",
)
.set_bg(None)
)
Voir aussi
- Barres empilées —
sp.build_stacked_bar() - Graphique en barres