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

Analyzer

Before you start

  • Process the design first so the interpreter, viewer, and Analyzer are working on the same geometry.
  • Clear every FSL error. The Analyzer is disabled until the last run finished without errors.
  • The studio needs WebGPU and the Analyzer feature on your account.

Run an analysis

  1. Open a design and click Analyzer in the side bar.
  2. When the run finishes the metrics, charts, and timings update immediately.

Understand the results

  • Metric cards list Average Brightness, Contrast Density, Contrast Intensity, Scintillation Score, and Compactness. Each value is shown as a percentage relative to the Hearts & Arrows brilliant reference that ships with the studio.
    • Average Brightness is the mean return light over every valid pixel in the sweep.
    • Contrast Density measures the amount of contrast areas visible on the stone. 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 comes from the current mesh and reports how much of the stone's footprint-and-height envelope is filled by the actual volume.
    • Shannon Entropy New! measures the information content or "richness" of the light distribution. A higher entropy score means the stone returns a complex, varied range of light levels—avoiding "flat" or monotone appearances.
  • Per-angle sparklines ("Brightness by Angle", "Contrast Density", "Contrast Intensity") plot the same metrics for each of the 19 tilt angles so you can see where the stone rises or falls off.
  • Lighting sweep renders each frame with cosine-weighted lighting and a standard head shadow. The 19 tilt positions start 45° down on the X axis, move through the upright view, and finish 45° toward the Y axis. Step sizes tighten near upright so more samples are taken where the stone spends most of its time, making every average a weighted view of the sweep.

Try it now

Paste the snippet below, process the design, and run the Analyzer to watch how tiny angle tweaks change the sparkline profiles.

set name "Analyzer Demo"
set gear 96
set girdle 4.5

P1 0 @ 41.8 : 0.18 x8
P2 6 @ 39.6 : mp(P1) x8

G1 0 @ 90 : size x16
C1 0 @ 32.2 : mp(G1,P1) + girdle x16
T 0 @ 0 : 0.86