Examples

This section is the Phase 2 entry point for example-driven documentation.

The notebooks under examples/notebooks/ remain the canonical rendered tutorial artifacts, synced from the source scripts in examples/scripts/. During docs builds, the notebooks are mirrored into the docs tree and rendered directly as pages below.

Recommended order:

1. basic_propagation for the core optics objects and a first forward pass

2. lens_optimization for the main differentiable-optics workflow

3. One domain-specific branch: 4f_correlator for Fourier optics, hologram_coherent_logo for phase-only design, or incoherent_camera for incoherent imaging

4. Then the family extensions and more specialized examples

Example families:

• lens_optimization -> sensitivity_analysis, metaatom_optimization

• 4f_correlator -> 4f_edge_optimization

• hologram_coherent_logo -> holography_polarized_dual

• Basic Propagation — First Optical Stack
• Diffractive Lens Optimization — Focusing a Plane Wave
• 4f Optical Correlator
• Coherent Hologram — Phase-Only Logo Reconstruction
• Incoherent Camera Imaging — PSF and OTF Modes
• Optical Neural Network (ONN) on MNIST — Phase-Mask Classifier
• 4f Edge Detection — Learning the Vortex Phase Filter
• Polarization-Multiplexed Holography — Dual Reconstructions
• Meta-Atom Library Optimization — Focusing with Interpolated Unit Cells
• Sensitivity Analysis and Fisher Information for a Diffractive Lens