Static g3 Viewer

Bake the measured three-body distribution of a single supercell into a self-contained HTML file. The layout mirrors the interactive Jupyter widget but has no live selectors. A fixed colormap and root-bond shell window are baked in, so the file renders identically in any browser.

Usage¶

cell.export_g3_html("liquid_g3.html")

A fresh G3Distribution is measured on the current atoms using the grid passed to export_g3_html, independent of any cached distribution on the supercell itself. This keeps the embedded JSON small without affecting the main measurement state.

Layout¶

Top panel: 2D heatmap of the reduced g3 slice $\tilde{g}_3(r, \phi)$ at a fixed root-bond shell, plotted in r vs $\phi$ with the diverging RdBu_r colormap centred at $\tilde{g}_3 = 1$ (uniform random reference). Blue = depleted, white = uniform, red = enhanced.
Bottom panel: pair profile $g(r) / \text{uniform}$ for the same triplet channel, with the root-bond integration window highlighted as an amber band. The band shows exactly which range of distances was summed over to produce the slice above.
Right side: colorbar legend with tick marks at 0, 1.0, and the current colour max. The 1.0 label follows the white point as the maximum is changed.
Controls: drop-down channel selector (hidden when only one triplet type is present) and a numeric input for the colour maximum.

Parameters¶

Parameter	Default	Description
`output_path`	required	File path for the generated HTML.
`r_max`	10.0	Maximum radius of the embedded g3 grid in Å.
`r_step`	0.1	Radial bin width in Å.
`phi_num_bins`	45	Number of angular bins between 0 and 180°.
`background_color`	`"#f7f8f5"`	CSS colour for the viewer background.
`title`	`""`	Optional text shown at the top of the viewer.
`show_progress`	`False`	If `True`, show a progress bar during the g3 measurement.

The defaults (50 × 45 bins per triplet channel) keep the JSON footprint around 100 kB for monatomic systems and well under 1 MB for complex oxides.