alsdb.utils.viz.plot_waveforms_3d#

alsdb.utils.viz.plot_waveforms_3d(results: DataFrame, color_by: str = 'rh98', cmap: str = 'YlGn', alpha: float = 0.7, line_width: float = 1.5, backend: str = 'matplotlib', elev: float = 25.0, azim: float = -60.0, figsize: tuple[float, float] = (12, 8), title: str | None = None)[source]#

3-D waterfall plot of simulated GEDI-like waveforms.

Each shot is drawn as a vertical RH(p) curve at its (X, Y) position — height above ground on the Z axis, cumulative energy percentile (0–100) on the Y offset. Lines are coloured by a summary metric.

Requires rh0–rh100 columns in results (as returned by simulate_batch).

Parameters:

results – DataFrame from simulate_batch(), must contain center_x, center_y, and rh0–rh100 columns.
color_by – Column used to colour the lines (default "rh98"). Other useful choices: "cover", "rh50", "z_ground".
cmap – Matplotlib colormap name.
alpha – Line opacity.
line_width – Line width in points.
backend – "matplotlib" (static) or "plotly" (interactive).
azim (elev /) – Matplotlib 3-D view angles (ignored for plotly).
figsize – Figure size in inches (matplotlib only).
title – Optional figure title.

Return type:

matplotlib.figure.Figure or plotly.graph_objects.Figure