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

The Analyzer renders your design on the GPU, tilts it through 19 viewing positions, and reports how much light returns toward the viewer. It runs the same optical pipeline the optimizer uses, so the scores you see here match the ones the optimizer chases.

Before you start

  • Process the design first (Cmd/Ctrl + Enter) so the interpreter, viewer, and Analyzer are working on the same geometry.
  • Clear every FSL error. The Analyze button is disabled until the last run finished without errors.
  • The studio needs WebGPU and the Analyzer feature on your account. When either is unavailable the button reads Analyze (Locked) or Analyze (Unsupported) and shows the reason in its tooltip.

Run an analysis

  1. Open a design and click Open Analyzer in the Performance column.
  2. Press Analyze. The studio keeps the Analyzer panel open, switches the button text to Analyzing..., and shows "Analyzing optical performance..." while it renders every tilt frame with the head shadow and cosine lighting enabled.
  3. When the run finishes the metrics, charts, and timings update immediately. Editing the FSL afterwards replaces the message with "Design changed. Run performance analysis again..." so you know the results are stale.

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 is the share of the stone that blinks between bright and dark as it tilts.
    • Contrast Intensity is how strong those blinks are when they happen.
    • 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.
  • 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.
  • Timings show total, GPU, and CPU milliseconds for the most recent run.

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 down 0 @ 41.8 : 0.18 x8
P2 down 6 @ 39.6 : mp(P1) x8

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