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

Stacked Bar Chart

Signature

sp.build_stacked_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.stacked_bar


Description

Stacked bar chart. Each bar is split into segments representing series contributions.

Same flat series_values layout as build_grouped_bar.


Parameters

ParameterTypeDefaultDescription
titlestrrequiredChart title
category_labelslist[str]requiredX-axis categories
series_valueslist[float]requiredFlat values row-major [cat0_s0, cat0_s1, ...]
show_valuesboolFalseShow segment value labels
series_nameslist[str] | NoneNoneLabels for each series

Returns

Chart


Examples

import seraplot as sp
months = ["Jan", "Feb", "Mar"]
costs = [
    400.0, 150.0, 80.0,
    380.0, 170.0, 95.0,
    420.0, 160.0, 90.0,
]
chart = sp.build_stacked_bar(
    "Monthly Costs",
    category_labels=months,
    series_values=costs,
    series_names=["Labor", "Materials", "Overhead"],
    legend_position="right",
    gridlines=True,
)
const sp = require('seraplot');
const months = ["Jan", "Feb", "Mar"]
const costs = [
    400.0, 150.0, 80.0,
    380.0, 170.0, 95.0,
    420.0, 160.0, 90.0,
]
const chart = sp.build_stacked_bar("Monthly Costs",
months,
{
    series_values: costs,
    series_names: ["Labor", "Materials", "Overhead"],
    legend_position: "right",
    gridlines: true
})
import * as sp from 'seraplot';
const months: string[] = ["Jan", "Feb", "Mar"]
const costs: number[] = [
    400.0, 150.0, 80.0,
    380.0, 170.0, 95.0,
    420.0, 160.0, 90.0,
]
const chart = sp.build_stacked_bar("Monthly Costs",
months,
{
    series_values: costs,
    series_names: ["Labor", "Materials", "Overhead"],
    legend_position: "right",
    gridlines: true
})
▶ Live Preview

See also

Signature

sp.build_stacked_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.stacked_bar


Description

Graphique en barres empilées. Chaque barre est divisée en segments représentant les contributions des séries.

Même disposition plate series_values que build_grouped_bar.


Paramètres

ParamètreTypeDéfautDescription
titlestrrequisTitre du graphique
category_labelslist[str]requisCatégories sur l'axe X
series_valueslist[float]requisValeurs plates ligne-major [cat0_s0, cat0_s1, ...]
show_valuesboolFalseAfficher les étiquettes de valeur sur les segments
series_nameslist[str] | NoneNoneNoms des séries pour la légende

Retourne

Chart


Exemples

import seraplot as sp

mois = ["Jan", "Fév", "Mar"]
coûts = [
    400.0, 150.0, 80.0,
    380.0, 170.0, 95.0,
    420.0, 160.0, 90.0,
]

chart = sp.build_stacked_bar(
    "Coûts mensuels",
    category_labels=mois,
    series_values=coûts,
    series_names=["Main-d\'oeuvre", "Matériaux", "Frais généraux"],
    legend_position="right",
    gridlines=True,
)

Voir aussi