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

SPLOM Chart 3D

Signature

sp.splom3d(title, axes=None, series=None, *, variant="basic", orientation3d="iso", scene="default", theme="none", zone=None, max_points=None, bg_color="#1a1a2e", width=900, height=560, x_label="", y_label="", z_label="", **kwargs) -> Chart

Aliases: sp.build_splom3d_chart(), sp.splom_3d(), sp.splom3d_chart(), sp.splom3d_family(), sp.sploms3d().

Description

sp.splom3d() is the 3D twin of sp.splom(): every one of the 4 scatterplot-matrix variants has a 3D form, selected with the same variant keyword and fed with the same rows. Every axis pair becomes its own small scatter cell laid out on a grid, up to 8 axes at once; long tables are sampled down so every cell stays legible.

Variants

VariantAliasesUses3D form
basicdefault, classic, dotsaxes, seriesOne small scatter cell per axis pair, laid out on a grid.
correlationcorr, heat, shadedaxes, seriesThe same grid of cells, each toned by its own Pearson correlation coefficient.
densityalpha, overplot, cloudaxes, seriesThe same grid of cells, read as an overplotted cloud rather than individually styled points.
regressiontrend, fit, lmaxes, seriesThe same grid of cells, each with a linear best-fit line laid across its points.

Data

axes names each variable and series gives one row per sample, one value per axis in the same order.

3D planes

The viewpoint is independent from the variant: orientation3d picks the initial camera plane and applies to every variant; the view always stays draggable.

orientation3d="iso" — Isometric three-quarter view (default).
orientation3d="horizontal" — Side-on view, almost at floor level.
orientation3d="vertical" — Top-down view from above.
orientation3d="front" — Front elevation, nearly flat.

3D scenes

scene swaps the environment the columns are drawn in and applies to every variant and every plane.

scene="default" — Each series keeps its own categorical palette color, rendered as shaded 3D bars on a flat grid.
scene="terrain" — The data is resampled onto a dense grid and rendered as hundreds of thin colormap-colored columns, forming a continuous mountain-of-bars terrain.
scene="tower" — The data is resampled onto a dense field of round skyscraper-like towers instead of boxes, for a city-skyline reading of magnitude.
scene="radial" — The data is resampled onto a dense polar grid of rings and wedges radiating from the center, like a 3D radar/sonar sweep of the value field.
scene="podium" — The data is resampled onto a dense grid and quantized into stepped terrace levels, like a rice-terrace contour map, to read value bands at a glance.

Themes

theme restyles the whole canvas (colour grade and glow) and applies to every variant, scene and plane.

theme="deluxe"
theme="prism"
theme="aurora"
theme="inferno"
theme="frost"
theme="glow"
theme="glass"
theme="neon"
theme="cosmic"

Auto-scaling zone

The 3D zone (floor, walls, axes and camera) scales to the elements: its length, width and height follow the extents of the drawn blocks, a minimum floor depth keeps single rows readable, wide scenes are drawn flatter and the camera frames the whole box. The axis ticks read the real data range. Pass zone=[x, y, z] to force the proportions of the box instead; the longest side is normalised to 1.

Parameters

Returns

Chart object with an .html property and a .show() method.