Line Chart 3D
Signature
sp.build_line3d_chart(
title: str,
x: list[float],
y: list[float],
z: list[float],
*,
color_hex: int = 0x6366F1,
palette: list[int] | None = None,
bg_color: str = "#1a1a2e",
width: int = 900,
height: int = 600,
x_label: str = "X",
y_label: str = "Y",
z_label: str = "Z",
series_names: list[str] | None = None,
show_points: bool = True,
) -> Chart
Aliases: sp.line3d
Description
3D line chart connecting sequential points in 3D space. Useful for trajectories, time-series in 3D space, and parametric curves.
Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
title | str | required | Chart title |
x | list[float] | required | X coordinates |
y | list[float] | required | Y coordinates |
z | list[float] | required | Z coordinates |
color_hex | int | 0x6366F1 | Line color |
palette | list[int] | None | None | Multi-series colors |
bg_color | str | "#1a1a2e" | Background color |
width | int | 900 | Canvas width |
height | int | 600 | Canvas height |
x_label | str | "X" | X-axis label |
y_label | str | "Y" | Y-axis label |
z_label | str | "Z" | Z-axis label |
series_names | list[str] | None | None | Series legend names |
show_points | bool | True | Show point markers |
Returns
Chart
Examples
Helix trajectory
import seraplot as sp
import math
t = [i * 0.1 for i in range(100)]
x = [math.cos(v) for v in t]
y = [math.sin(v) for v in t]
z = t
chart = sp.build_line3d_chart(
"Helix",
x_values=x, y_values=y, z_values=z,
x_label="cos(t)", y_label="sin(t)", z_label="t",
)const sp = require('seraplot');
import math
const t = [i * 0.1 for i in range(100)]
const x = [math.cos(v) for v in t]
const y = [math.sin(v) for v in t]
const z = t
const chart = sp.build_line3d_chart("Helix",
x,
y,
{
z_values: z,
x_label: "cos(t)",
y_label: "sin(t)",
z_label: "t"
})import * as sp from 'seraplot';
import math
const t: number[] = [i * 0.1 for i in range(100)]
const x: number[] = [math.cos(v) for v in t]
const y: number[] = [math.sin(v) for v in t]
const z = t
const chart = sp.build_line3d_chart("Helix",
x,
y,
{
z_values: z,
x_label: "cos(t)",
y_label: "sin(t)",
z_label: "t"
})▶ Live Preview
See also
Signature
sp.build_line3d_chart(
title: str,
x: list[float],
y: list[float],
z: list[float],
*,
color_hex: int = 0x6366F1,
palette: list[int] | None = None,
bg_color: str = "#1a1a2e",
width: int = 900,
height: int = 600,
x_label: str = "X",
y_label: str = "Y",
z_label: str = "Z",
series_names: list[str] | None = None,
show_points: bool = True,
) -> Chart
Aliases: sp.line3d
Description
Graphique en courbe 3D connectant des points séquentiels dans l'espace 3D. Utile pour les trajectoires, les séries temporelles 3D et les courbes paramétriques.
Paramètres
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
title | str | requis | Titre du graphique |
x | list[float] | requis | Coordonnées X |
y | list[float] | requis | Coordonnées Y |
z | list[float] | requis | Coordonnées Z |
color_hex | int | 0x6366F1 | Couleur de la courbe |
palette | list[int] | None | None | Couleurs multi-séries |
bg_color | str | "#1a1a2e" | Couleur de fond |
width | int | 900 | Largeur du canvas |
height | int | 600 | Hauteur du canvas |
x_label | str | "X" | Étiquette de l'axe X |
y_label | str | "Y" | Étiquette de l'axe Y |
z_label | str | "Z" | Étiquette de l'axe Z |
series_names | list[str] | None | None | Noms des séries pour la légende |
show_points | bool | True | Afficher les marqueurs de points |
Retourne
Chart
Exemples
import seraplot as sp
import math
t = [i * 0.1 for i in range(100)]
x = [math.cos(v) for v in t]
y = [math.sin(v) for v in t]
z = t
chart = sp.build_line3d_chart(
"Hélice",
x_values=x, y_values=y, z_values=z,
x_label="cos(t)", y_label="sin(t)", z_label="t",
)