Analyzer

The Analyzer scores your gemstone design against professional-grade optical metrics. It runs 39 GPU-accelerated simulations across different viewing angles to measure brightness, contrast, and scintillation.

Before you start

Run your code first so the interpreter outputs valid geometry.
Clear all errors. The Analyzer stays disabled until the last run finishes without errors.
The studio requires WebGPU support in your browser.

Run an analysis

Open a design and click Analyzer in the side panel.
When the run finishes, the metrics and charts update immediately.

Understand the results

Metric cards show Average Brightness, Contrast Density, Contrast Intensity, Scintillation Score, Compactness, and Shannon Entropy. Each value is shown as a percentage relative to a reference brilliant.
- Average Brightness is the mean return light over every valid pixel in the sweep.
- Contrast Density measures the amount of contrast areas visible. It describes the spatial distribution of light and dark zones.
- Contrast Intensity measures the strength of the contrast in areas where it exists.
- Scintillation Score counts blink events between angles and normalises them by the number of pixels and tilt steps.
- Compactness reports how much of the stone's bounding box is filled by the actual volume.
- Shannon Entropy measures the information content or "richness" of the light distribution.
Per-angle sparklines plot the same metrics for each of the 39 tilt angles so you can see where the stone rises or falls off.

Head Shadow Toggle

The Head Shadow checkbox controls whether the simulation includes a realistic head shadow—the occlusion caused by the viewer's head blocking some overhead light.

Enabled (default): Simulates realistic viewing conditions.
Disabled: Removes the head shadow for brighter overall scores, useful for comparing theoretical maximum brightness.

Toggle this setting and the Analyzer immediately re-runs.

Show Angle Images

Click 📷 Show Angle Images to see the actual rendered frames from all 39 viewing angles. A modal opens with a grid of images labeled by their tilt angle (e.g., L45° for 45° left tilt, 0° for upright view, T45° for 45° tilt).

This is invaluable for debugging:

See exactly where brightness drops or spikes
Identify problem areas like light leakage or dead zones
Verify that geometry is correct across viewing angles