Bar Chart 3D
Signature
sp.build_bar3d_chart(
title: str,
labels: list[str],
values: list[float],
*,
color_hex: int = 0x6366F1,
palette: list[int] | None = None,
bg_color: str = "#1a1a2e",
width: int = 900,
height: int = 600,
x_label: str = "",
y_label: str = "",
z_label: str = "",
show_text: bool = False,
) -> Chart
Aliases: sp.bar3d
Description
3D bar chart rendering bars as extruded rectangular prisms on a WebGL canvas.
Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
title | str | required | Chart title |
labels | list[str] | required | Bar labels |
values | list[float] | required | Bar heights |
color_hex | int | 0x6366F1 | Single bar color |
palette | list[int] | None | None | Per-bar colors |
bg_color | str | "#1a1a2e" | Background color |
width | int | 900 | Canvas width |
height | int | 600 | Canvas height |
x_label | str | "" | X-axis label |
y_label | str | "" | Y-axis label |
z_label | str | "" | Z-axis label |
show_text | bool | False | Show value labels |
Returns
Chart
Examples
import seraplot as sp
chart = sp.build_bar3d_chart(
"Sales by Product",
x_values=[0.0, 1.0, 2.0, 3.0, 0.0, 1.0, 2.0, 3.0],
y_values=[0.0, 0.0, 0.0, 0.0, 1.0, 1.0, 1.0, 1.0],
z_values=[420.0, 380.0, 290.0, 510.0, 480.0, 420.0, 350.0, 590.0],
x_label="Product",
y_label="Year",
z_label="Units",
)const sp = require('seraplot');
const chart = sp.build_bar3d_chart("Sales by Product",
[0.0, 1.0, 2.0, 3.0, 0.0, 1.0, 2.0, 3.0],
[0.0, 0.0, 0.0, 0.0, 1.0, 1.0, 1.0, 1.0],
{
z_values: [420.0, 380.0, 290.0, 510.0, 480.0, 420.0, 350.0, 590.0],
x_label: "Product",
y_label: "Year",
z_label: "Units"
})import * as sp from 'seraplot';
const chart = sp.build_bar3d_chart("Sales by Product",
[0.0, 1.0, 2.0, 3.0, 0.0, 1.0, 2.0, 3.0],
[0.0, 0.0, 0.0, 0.0, 1.0, 1.0, 1.0, 1.0],
{
z_values: [420.0, 380.0, 290.0, 510.0, 480.0, 420.0, 350.0, 590.0],
x_label: "Product",
y_label: "Year",
z_label: "Units"
})▶ Live Preview
See also
Signature
sp.build_bar3d_chart(
title: str,
labels: list[str],
values: list[float],
*,
color_hex: int = 0x6366F1,
palette: list[int] | None = None,
bg_color: str = "#1a1a2e",
width: int = 900,
height: int = 600,
x_label: str = "",
y_label: str = "",
z_label: str = "",
show_text: bool = False,
) -> Chart
Aliases: sp.bar3d
Description
Graphique en barres 3D rendant les barres comme des prismes rectangulaires extrudés sur un canvas WebGL.
Paramètres
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
title | str | requis | Titre du graphique |
labels | list[str] | requis | Étiquettes des barres |
values | list[float] | requis | Hauteurs des barres |
color_hex | int | 0x6366F1 | Couleur unique des barres |
palette | list[int] | None | None | Couleurs par barre |
bg_color | str | "#1a1a2e" | Couleur de fond |
width | int | 900 | Largeur du canvas |
height | int | 600 | Hauteur du canvas |
x_label | str | "" | Étiquette de l'axe X |
y_label | str | "" | Étiquette de l'axe Y |
z_label | str | "" | Étiquette de l'axe Z |
show_text | bool | False | Afficher les étiquettes de valeur |
Retourne
Chart
Exemples
import seraplot as sp
chart = sp.build_bar3d_chart(
"Ventes par produit",
x_values=[0.0, 1.0, 2.0, 3.0, 0.0, 1.0, 2.0, 3.0],
y_values=[0.0, 0.0, 0.0, 0.0, 1.0, 1.0, 1.0, 1.0],
z_values=[420.0, 380.0, 290.0, 510.0, 480.0, 420.0, 350.0, 590.0],
x_label="Produit",
y_label="Année",
z_label="Unités",
)