Appendix — Examples
===================

This appendix is a faithful conversion of Section 7 of the provisional manual
(``KrakenOS/Docs/USER_MANUAL_KrakenOS_Provisional.pdf``, pages 29–90). Each
example has its own page with a short description, the figures from the PDF,
and a ``literalinclude`` of the corresponding script under
``KrakenOS/Examples/``.

The authors of the manual recommend practicing with these scripts as the
fastest way to learn the library.

.. toctree::
   :maxdepth: 1

   ex_01_ray
   ex_02_perfect_lens
   ex_03_doublet_3d_color
   ex_04_doublet_tilt
   ex_05_doublet_parax
   ex_06_doublet_tilt_nulls
   ex_07_doublet_nonsec
   ex_08_doublet_zernike
   ex_09_doublet_tilt_nonsec
   ex_10_doublet_pupil
   ex_11_doublet_commands
   ex_12_doublet_pupil_seidel
   ex_13_doublet_cylinder
   ex_14_axicon
   ex_15_axicon_cylinder
   ex_16_flat_mirror
   ex_17_parabole_shift
   ex_18_grating_transmission
   ex_19_grating_reflection
   ex_20_tel2m_spot
   ex_21_tel2m_tilt_m2
   ex_22_tel2m_pupila
   ex_23_tel2m_error_map
   ex_24_tel2m_wavefront
   ex_25_tel2m_imageslicer
   ex_26_tel2m_atm_refract
   ex_27_micro_lens_array
   ex_28_radial_sine
   ex_29_xy_cosines
   ex_30_multicore
   ex_31_solid_stl_array
   ex_32_source_distribution