---
name: fractal-data-visualization
description: "Choose, render, or review charts and scientific figures with truthful encodings and the appropriate product or scientific palette. Use for actual visuals, not prose that merely mentions charts."
---

# Build a data visualization

Read [core](../../../../core.md), [visualization rules](../../references/data-visualization-guide.md); use bundle `data-visualization`.

1. Establish the question, source data, units, variable types, uncertainty, missingness, ordering, and any derivation. Ask for missing evidence instead of inventing values.
2. Choose geometry that answers the question truthfully. Load the matching chart reference from the visualization guide before implementation. Several truthful forms may be valid; choose by the reader's task and final size.
3. Select a profile: for non-scientific product metrics load the [product visualization skill](../../../product-ui/skills/fractal-product-visualization/SKILL.md), or for scientific data read the [scientific profile](../../references/scientific-profile.md) and [catalogue](../../references/colourmaps.json). Keep category identity stable. Product status colors do not override scientific maps. Use the `product-charts` or `scientific-charts` signal (both only for distinct plots in a mixed artifact).
4. Encode only real distinctions. Explain transforms, units, uncertainty, and non-obvious encodings. Keep zero, missing, censored, and not-applicable states distinguishable.
5. Keep chart chrome neutral. UI frames/axes/gridlines and data-bearing strokes have distinct rules. Measure label extents and reserve space for vertical y titles, horizontal x titles, units, ticks, and legends.
6. Render at the final size. Check mark/background contrast, text, labels, accessible alternatives, and interaction without relying only on hover or color.

For 2D chemical structures, additionally read [chemical palettes](../../../product-ui/references/color.md#2d-chemical-structure-palettes). Use a trusted domain renderer and preserve atomic identity; do not recolor atoms with chart maps.

The optional [Matplotlib helper](../../../../resources/visualization/fractal_colors.py) and [style](../../../../resources/visualization/fractal.mplstyle) are implementation resources. Inspect their APIs and dependencies before using them. Their presence does not force a plotting tool.
