blender-optics-simulator

Scope an optical-simulation request honestly — map "can this bench simulate X?" to a tier ((a) reproducible now / (b) via wave.py single-plane FFT-PSF / (c) needs an engine we lack), then cite the oracle-verified case or name the missing engine + the external tool to use. Use when asked "can it simulate …", "is X in scope", "what can/can't this engine do", "do you support FDTD / BPM / Monte-Carlo / hologram reconstruction / turbulence / g²", or "/optics-scope". Anti-overclaim only: this adds ZERO simulation capability.

Align an optical bench in the Blender Optics Simulator — steer the beam onto its target, recover a dark port, or null an interferometric tilt using the influence-matrix solvers. Use when asked to "align the bench", "get the beam on the detector", "walk the beam", "null the tilt / fringes", "maximize coupling", or "/optics-align".

Build or extend an optical bench in the Blender Optics Simulator — start from a canonical example or add and place components, set their parameters and mounts, and verify the result. Use when asked to "build a bench", "set up an interferometer / telescope / AO loop", "add a lens/mirror/beamsplitter", "assemble a cage/tube/rail system", or "/optics-build".

Run the correction-as-FEEDBACK loop on an optical bench — surface the proposed fixes, then judge each against user intent (refuse / partial / accept) rather than blindly auto-fixing. Use when asked to "fix the bench", "what's wrong and correct it", "clean up the alignment/energy", "review for problems and fix", or "/optics-correct". Never silently "improve" a bench the user built on purpose.

Inspect what an optical bench is actually doing — a structured, READ-ONLY numeric sweep of the Blender Optics Simulator scene (topology, per-element beam state, per-optic behaviour, sensor reads). Use when asked "what is this bench doing", "inspect the beam", "report the optical state", "is the beam aligned", "what does this detector see", or "/optics-inspect". The golden rule: never GUESS what the beam is doing — READ it.

Read and render what an optical sensor actually measures in the Blender Optics Simulator — a finite sensor's aperture capture, the modal wavefront (Zernike RMS, incl. the beam's own curvature defocus), and the dense zonal surface-figure map. Use when asked "what does the sensor / WFS see", "render the wavefront", "sensor render", "show the surface figure", "measure the aberration", or "/optics-sensor-render".