.. _example_gallery:

Introduction
============

This gallery contains a collection of examples demonstrating the capabilities of Optiland. Each example is a self-contained Jupyter notebook that shows how to achieve a specific task using Optiland. The examples cover a wide range of topics, from basic lens design to freeform optics.
For more detailed explanations of how to use Optiland, see the step-by-step :doc:`learning guide <../learning_guide>`.

.. tip::

   The gallery is organized by Optiland feature. If you know the *question* you want answered
   rather than the feature you need, use the task-shaped :doc:`../how_do_i` index instead.

The following sections are covered:

1. :doc:`Basic Lenses <basic_lenses>`
2. :doc:`Specialized Lenses <specialized_lenses>`
3. :doc:`Reflective Systems <reflective_systems>`
4. :doc:`Analysis <analysis>`
5. :doc:`OPD, PSF, MTF <opd_psf_mtf>`
6. :doc:`Optimization <optimization>`
7. :doc:`Tolerancing <tolerancing>`
8. :doc:`Freeform <freeforms>`
9. :doc:`Diffractive and Phase Elements <diffractive_and_phase>`
10. :doc:`Coatings and Polarization <coatings_and_polarization>`
11. :doc:`Differentiable Ray Tracing <differentiable_ray_tracing>`
12. :doc:`Real-World Projects <real_world_projects>`
13. :doc:`External Tools Using Optiland <external_tools>`
14. :doc:`Extended Sources <extended_sources>`
15. :doc:`Non-Sequential Ray Tracing <nonsequential>`
16. :doc:`Miscellaneous <miscellaneous>`

.. toctree::
   :hidden:
   :maxdepth: 1

   basic_lenses
   specialized_lenses
   reflective_systems
   analysis
   opd_psf_mtf
   optimization
   tolerancing
   freeforms
   diffractive_and_phase
   coatings_and_polarization
   differentiable_ray_tracing
   real_world_projects
   external_tools
   extended_sources
   nonsequential
   miscellaneous