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 3D

Signature

sp.build_stacked_bar3d_chart(
    title: str,
    category_labels: list[str],
    series_values: list[float],
    *,
    series_names: list[str] | None = None,
    show_values: bool = False,
    palette: list[int] | None = None,
    bg_color: str = "#1a1a2e",
    width: int = 900,
    height: int = 600,
    x_label: str = "",
    y_label: str = "",
    z_label: str = "",
) -> Chart

Aliases: sp.stacked_bar3d


Description

3D stacked bar chart — each bar is segmented into series, rendered as stacked prisms.

series_values is a flat list in row-major order: [cat0_s0, cat0_s1, …, cat1_s0, …].


Parameters

ParameterTypeDefaultDescription
titlestrrequiredChart title
category_labelslist[str]requiredCategory labels
series_valueslist[float]requiredFlat row-major series data
series_nameslist[str] | NoneNoneLegend names
show_valuesboolFalseLabels on segments
palettelist[int] | NoneNonePer-series colors
bg_colorstr"#1a1a2e"Background
widthint900Canvas width
heightint600Canvas height

Returns

Chart


Examples

import seraplot as sp
categories = ["Q1", "Q2", "Q3", "Q4"]
series_data = [
    [30, 40, 25, 50],
    [20, 35, 45, 30],
    [50, 25, 30, 20],
]
chart = sp.build_stacked_bar3d_chart(
    "Quarterly Revenue 3D",
    category_labels=categories,
    series_values=series_data,
    series_names=["Product A", "Product B", "Product C"],
)
const sp = require('seraplot');
const categories = ["Q1", "Q2", "Q3", "Q4"]
const series_data = [
    [30, 40, 25, 50],
    [20, 35, 45, 30],
    [50, 25, 30, 20],
]
const chart = sp.build_stacked_bar3d_chart("Quarterly Revenue 3D",
categories,
{
    series_values: series_data,
    series_names: ["Product A", "Product B", "Product C"]
})
import * as sp from 'seraplot';
const categories: string[] = ["Q1", "Q2", "Q3", "Q4"]
const series_data: number[] = [
    [30, 40, 25, 50],
    [20, 35, 45, 30],
    [50, 25, 30, 20],
]
const chart = sp.build_stacked_bar3d_chart("Quarterly Revenue 3D",
categories,
{
    series_values: series_data,
    series_names: ["Product A", "Product B", "Product C"]
})
▶ Live Preview

See also

Signature

sp.build_stacked_bar3d_chart(
    title: str,
    category_labels: list[str],
    series_values: list[float],
    *,
    series_names: list[str] | None = None,
    show_values: bool = False,
    palette: list[int] | None = None,
    bg_color: str = "#1a1a2e",
    width: int = 900,
    height: int = 600,
    x_label: str = "",
    y_label: str = "",
    z_label: str = "",
) -> Chart

Aliases: sp.stacked_bar3d


Description

Graphique en barres empilées 3D — chaque barre est segmentée en séries, rendues comme des prismes empilés.

series_values est une liste plate en ordre ligne-major : [cat0_s0, cat0_s1, …, cat1_s0, …].


Paramètres

ParamètreTypeDéfautDescription
titlestrrequisTitre du graphique
category_labelslist[str]requisÉtiquettes des catégories
series_valueslist[float]requisDonnées en ligne-major
series_nameslist[str] | NoneNoneNoms de légende
show_valuesboolFalseÉtiquettes sur les segments
palettelist[int] | NoneNoneCouleurs par série
bg_colorstr"#1a1a2e"Couleur de fond
widthint900Largeur du canvas
heightint600Hauteur du canvas

Retourne

Chart


Exemples

import seraplot as sp

categories = ["T1", "T2", "T3", "T4"]
données = [
    [30, 40, 25, 50],
    [20, 35, 45, 30],
    [50, 25, 30, 20],
]

chart = sp.build_stacked_bar3d_chart(
    "Revenus trimestriels 3D",
    category_labels=categories,
    series_values=données,
    series_names=["Produit A", "Produit B", "Produit C"],
)

Voir aussi