{
 "cells": [
  {
   "cell_type": "markdown",
   "id": "7fb27b941602401d91542211134fc71a",
   "metadata": {},
   "source": [
    "# Relative Illumination\n",
    "\n",
    "Relative illumination (RI) is the image irradiance across the field, normalized to its maximum, for a uniform, planar, Lambertian object. It is a key specification for camera and sensor optics.\n",
    "\n",
    "`RelativeIllumination` follows M. Rimmer, \"Relative illumination calculations\", *Proc. SPIE* 655, 99 (1986). Radiance is conserved through the system apart from transmission losses, so the irradiance at an image point is proportional to the **projected solid angle** of the exit pupil seen from that point. In image space, that is the area the rays cover in direction-cosine space $(L, M)$. Vignetting, pupil aberrations, telecentricity and changes of F-number across the field all change this area, so the result is in general **not** a cos⁴ curve."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 1,
   "id": "acae54e37e7d407bbb7b55eff062a284",
   "metadata": {},
   "outputs": [],
   "source": [
    "from __future__ import annotations\n",
    "\n",
    "import numpy as np\n",
    "\n",
    "from optiland.analysis import RelativeIllumination\n",
    "from optiland.physical_apertures import RadialAperture\n",
    "from optiland.samples.objectives import CookeTriplet"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 2,
   "id": "9a63283cbaf04dbcab1f6479b197f3a8",
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "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",
      "text/plain": [
       "<Figure size 1000x400 with 1 Axes>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "lens = CookeTriplet()\n",
    "fig, ax = lens.draw()"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "8dd0d8092fe74a7c96281538738b07e2",
   "metadata": {},
   "source": [
    "By default the analysis uses the primary wavelength (relative illumination is monochromatic), 32 field points from the axis to the full field, and a pupil sampling of about 64 rays across the pupil diameter."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 3,
   "id": "72eea5119410473aa328ad9291626812",
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "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",
      "text/plain": [
       "<Figure size 800x550 with 1 Axes>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "ri = RelativeIllumination(lens)\n",
    "fig, ax = ri.view()"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "8edb47106e1a46a883d545849b8ab81b",
   "metadata": {},
   "source": [
    "## Comparison with cos⁴\n",
    "\n",
    "The cos⁴ \"law\" holds only for a thin, slow, aberration-free lens with the stop at the lens. The Cooke triplet, with its stop near the middle element and a 20° half field, comes close to it:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 4,
   "id": "10185d26023b46108eb7d9f57d49d2b3",
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "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ZJyyjOvPCncvvviidu7caZcGAwAA51arnVnOzQywLFsrHnWnSZMmduUvUy+n66Kt0goVZlJhgh0AAOeesm5Y02OHuldWD5V1j1cpgpvVI+69916NGzfupBUqhg8fXh3nCQAAgGpSpZY7s8LEm2++qQcffFB/+MMfbLn//vur6xwAAADOipmL1yxbGhsbqwEDBiguLq7C477++msFBQWpd+/e5aWgoOCM+4w5c+bY7uj27dvrjjvuUHFxcZX21bUqtdyZYGdGyjZs2LDmzwgAAOAMpk6dqilTptj16+fPn29/rlu37rRLoW7evPms9plp4KZPn66NGzeqadOmds5fs+793XffXek+jwl3bdq0IdgBAABr8r/WaW9Gfo18Gm2aBGv2LQMqPcZMy2LWvf/ss8/s4wkTJuiee+7Rrl27Kh1FejZMYBw/fryaNWtmH995552aMWOGDXCV7fspM8L4o48+sq2CRv/+/fXMM89o5MiRtvTr18+GUtOIdsstt+i8886zr5WSkmJviZs2bVrNhDvT3HnttdfqmmuuOemeO3NhAAAAtWnfvn2Kjo4uH71rBhmYud9ON0VIYmKinZvXTOd266236q677jrjPvNapnHrxJBmtp1p38+ZZuarr76y8wmb18nKytKKFSuUmppqWxVvu+22s25gq1K427Bhg/358ssvl28zHyThDgCAc8+ZWtbqk759+9pWsAYNGtifl156qSIiImyjVWX7aotpODPBslGjRmrXrp0dvGoylpmpxMwvbFr0ylr9qjXcmUQJAABQH7Rq1UoHDhywq2aZ1jszLYhpOTOtdz8VHh5e/nvLli11/fXX25YxE+Aq22dey7TqlTEhq+z1K9tXkROnLfnpwIsTe0RNyPvp4xNXBqvW0bLLly+vsAAAANS2qKgo2+o2b948+3jBggU2nFXUJXvgwAE74a+Rm5urxYsXq0+fPmfcZ+7jW7RokQ4ePGjD2SuvvKKJEyeecV9FvvvuO/szKSnJru71cwJbtbfcmalPyphZqs1qFd27d7ejRAAAAGrbrFmz7AhZM/jAtMDNnTu3fN/kyZPtrWOmmOBnbiszLXwmVP3qV7+y99YZle0zXaSPPvqohg4dah+bwQ9mhO6Z9p2uB9Scn+l6NSHQDP443dQttRbufjq0eO3atXrjjTdq6pwAAAAqZQYbmHl4KzJ79uzy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",
      "text/plain": [
       "<Figure size 800x550 with 1 Axes>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "field = np.asarray(ri.data[\"Hy\"]) * lens.fields.max_field\n",
    "cos4 = np.cos(np.radians(field)) ** 4\n",
    "\n",
    "fig, ax = ri.view()\n",
    "ax.plot(field, cos4, \"k--\", label=\"cos⁴θ\")\n",
    "ax.legend(bbox_to_anchor=(1.05, 0.5), loc=\"center left\")\n",
    "fig.tight_layout()"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "8763a12b2bbd4a93a75aff182afb95dc",
   "metadata": {},
   "source": [
    "A wide-angle lens is a different story. In this 100° field-of-view design, the exit pupil grows and tilts toward the off-axis image points (pupil coma), so the illumination stays almost flat across the field, while cos⁴ falls to 0.17 at 50°. This lens is even slightly brighter at the edge than on axis."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 5,
   "id": "7623eae2785240b9bd12b16a66d81610",
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "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",
      "text/plain": [
       "<Figure size 800x550 with 1 Axes>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "from optiland.samples.objectives import WideAngle100FOV\n",
    "\n",
    "wide = WideAngle100FOV()\n",
    "ri_wide = RelativeIllumination(wide)\n",
    "\n",
    "field = np.asarray(ri_wide.data[\"Hy\"]) * wide.fields.max_field\n",
    "fig, ax = ri_wide.view()\n",
    "ax.plot(field, np.cos(np.radians(field)) ** 4, \"k--\", label=\"cos⁴θ\")\n",
    "ax.legend(bbox_to_anchor=(1.05, 0.5), loc=\"center left\")\n",
    "fig.tight_layout()"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "7cdc8c89c7104fffa095e18ddfef8986",
   "metadata": {},
   "source": [
    "## Ray aiming\n",
    "\n",
    "The pupil rays follow the optic's ray aiming. The Cooke triplet sample uses paraxial aiming, so the off-axis beams fill the *paraxial* entrance pupil, which slightly underfills the real stop. Robust ray aiming fills the real stop at every field, and the relative illumination at the edge of the field rises noticeably. For lenses with large pupil aberrations, use real ray aiming."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 6,
   "id": "b118ea5561624da68c537baed56e602f",
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "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3N3LL78sR44csUrexRdfHLBj8k43QSMuNtJau9qlcyy9YpMy9h6VP/dkTNRYueNQjnX24mIjMoJeXEZ1z13li40k7AFORagD4Hchr2nTptaGDRtmlbzJkyd7Hp8wYYKsXLlSnnnmGav66bZmHTt2lNtuu02qV68uTpZ56ZX2df5eeiU93SW7DidbVc8zXm9vgizdckAWrv8ry3voenrugOdeUFkvdf09AIGN32IAfh/ydMasm+5fqztfaBVPq3k6w1areTqjVkPdsWPHZNSoUXLFFVdYt20gLaFytoKDg6RSiWhrHeuVzRL2th9MyhT0MkKfVvXmr8u6XZp7b1zCHhC4CHUAAoqOs9MZs9oeeughSU1NtQkWOvZO/fjjj1bhUzoB4/LLL/e0atWyTlI4H8KeeweNKy/4O+ylnUiXbQeSbPZt5mVXThv24mJtGZbktL93GwHgPwh1AAKaLpOiky7cNOx9++23Mnv2bJkzZ4588skn1nRXjA0bNthztmzZYtW/UqWyrjF3vggNCZYaZYpY69ygXJawt/1gRjfu6cLef1bOzgh57r1xT3bjMhsXKDyEOgCOEhMTI1dffbU197612k2r6+S56azbTz/9VJo3by6dOnWyppMu3Fuena807FUvHWMtc9g7ke6yyp57i7SFK9ZJYmikLbuyaEPWMXsa6twhr1amVq5o5HnRFQ4UJkIdAEfTLthevXplue+6666TtLQ0q+aNGDHCmobB999/X2688cZCO1Z/FRIclCnsidRK3SidO7fzTNDQit4G2x9Xt0o7Kn/szrn0SnR4iNQsU0RqlonJuIzT60WkaqloiQz7ewY0gLNHqANw3tGQp01n1uqki5kzZ1qrXbu2PX748GFp1qyZLZuiVTwdj3e+dtV6O0GjQ92MBaQ96+wdTbGwtzE+QTbaZaKFvtU7D2d9jyCRyiWjswQ+7RbWAKlr8FHdA7xHqANwXs+sbdWqlbV///vfnvu3bt1qEzJ0+zJtGixatGghV111lTz55JMSHBxcqMcdEOvsFY201rbW3+vsqYSUNNkU7w57iRmX8QmyaP1fMnftvizP1f1xq52sEGZuel+xKNbbA7Ij1AFANo0aNZI///zTwt2sWbOsiqddtd988408/fTT9hzdv3bnzp2200XFihX5Dr2k6+E1qlTcWmY6SWPHwWSr5m3+K1E270+UzfGJdj17dU+Vign/O+iViZGqJXWWb7RUKRUtRVlgGecpQh0AnELVqlWlf//+1rSrdvfu3Z7H3nzzTZk2bZonBGoVT5vuV3u+T7g420kaWoHTll1Sapps+SvJAt6W/YmyycJegmz6K1GWZdsjVxWPDpOqJaOtW9eCXkltMRb4dMKGjhEEnIhQBwBedtVWqlTJc3v8+PFWxZs+fbq1F1980dpbb70lQ4YMsedoJY8q3rmLDg+VCyoUtZbdoaRUC3s6O3fr/iS73LY/SbYeSJSVO3JW+MJDgqVSiSgLeIDTEOoA4CyUKVNGbr75Zmvp6emyYsUKC3ddunSxx7WqpyGwfv36cs0118i1116bZVkV5I/i0eHStIq2EjkeO3b8hGzXkJc58Nn1RPlxY9a9cgEnINQBwDnSiRM6W1abW0pKitx5553y3XffySuvvGItOjpaunbtKh9//DGTLQqALpVi+9uW/XubOTddjqXKBwVxFEDBIdQBgA/olmQ6c1aX99Aqnu5yoWEuPj7eE+g+/PBDWb9+vVXydAaudvGi4JZjAZyGUAcAPl7eo2nTptZ0WRRd885Nd7XQSt6zzz5r6+DpRAsNeLobRokSObsTASAvLLYEAAVI179z0yVSfvjhB3nsscekcuXK8tFHH8ktt9wiX3/9tec5WsnTah8AnA6hDgAKiXa3tmnTxip1y5cvlx07dsiYMWM8ky3WrVsnderUsZ0u7rvvPpkzZ46kpqZyvgDkilAHAH5Clz+56667pHTp0p6q3t13321B7vXXX5crrrjCHrv99tsL+1AB+CFCHQD4qRo1asjbb79tO1usXLlSnnvuOWnQoIHtTev23nvvyYgRI+S3336jmxY4zzFRAgACYLKF7lqh7dFHH5W0tDTPY++//7789NNPNi5PQ2C3bt2stWvXTsLC2B8VOJ9QqQOAAJ5sMW/ePNuH9p577rGw99prr0nHjh1l6tSp9rhOsshc2QPgXIQ6AAhgERER0qlTJ9uLdsuWLbYm3tNPPy1XXnmlPf7rr7/aODy97X4OAGci1AGAg7ppGzduLMOHD5ciRYrYfbqFmYa+hQsXytChQ6V69er2nJdeeqmwDxdAPiPUAYCDtWzZUqZNmyZ//fWXfPnll9K3b1/ZtWuXrFq1yvOciRMnyqxZs1guBQhwTJQAgPOAVu6uv/56aydOnPCMs9Mxdw888IBs375dihYtajtadO/e3Xa10NsAAgeVOgA4Dxc9LlmypOf29OnTbbmUevXq2dZlvXv3tnF4Oh4PQOAg1AHAeT4O74ILLrClUn7++Wfb1WLUqFFy7bXXyoUXXuiZYduqVStbD+/3339nPTzATxHqAABZdrUYNGiQTJ482bPO3bZt22zLMl0LTxc/7t+/vzz00ENU8gA/Q6gDAOSpT58+sm/fPpk5c6YMHjxYkpOT5cUXX5Rx48Z5nrNmzRomWgCFjIkSAIDTCg8Pt7XutHXt2tXG5BUvXtwe00WP27dvL8ePH7duW/dEi9jYWL5ZoABRqQMAnNk/HMHB0rp1a6lbt67dTk1NtRm0OtHik08+kV69etlECw14+/fv59sFCgihDgBwTqKjo+WRRx6xiRa6NMrbb78tl156qXXJlihRwp7zww8/2BZmW7du5dsGAjXUrV+/Xtq0aSN16tSxRTD1lzw7XfF82LBhNgNLN6zu0KGDbNiwwdeHBgDIZ5UqVZK7777bFjPWyRVa1VPjx4+X+++/X6pVqybNmjWTZ555Rn777Tdm0gKBFOoGDhwoAwYMsF9unS2lq5lnN2XKFPtf3MqVK22V88svv9ym1wMAAnscntsbb7whX331lU260P1nH3/8cVsy5fnnn/c8RxdCBuCnoU5nSy1btkxuvfVWu92jRw8rzWevwuk6SSkpKXLs2DH7pT5y5Ij9bw8A4Jwu2uuuu07++9//yt69e2X27NkyZMgQ6dy5sz2uM2p1jJ7OrtUqn066AOBHs181wJUvX15CQ0M94a1KlSq25lGtWrU8z9OZVN9//72UK1fOZkvpOknz58/35aEBAAqJrn+nPTLa3HSsnf4b8e6771rTmbX6b4Nua6Zh0N2NC8DPlzTRap6Ordi5c6ftNfjwww/b4pcTJkzI8dyRI0dac0tKSpIZM2ZIoNMqJZ/Df3A+/Avn4/w4H6+//rr9p//HH3+0ITn/+9//ZO7cuRIVFWWBb8+ePbaHrTYAuXD50N69e12xsbGu48eP2+309HRX2bJlXevXr8/yvCFDhriee+45z+3ffvvNVaFCBa9+RunSpV1OMH36dJcT8Dn8C+fDv3A+zsyWLVtcixYt8tzu0aOHKzQ01HXllVe6Ro0a5dq1a9c5nY+KFSue0+sBf+PTenZcXJzNcnJX3CZNmmRj5TJ3vaoaNWrY/8Z0rSM1depUadiwoS8PDQDg56pWrSpt27b13NZFjTt16mTDc3TsnQ7V0dUVfvrpp0I9TsBf+HyQwujRo63pkiY6y0mntSvdO1BnvSodLFu9enVp3LixLWkyZ84c21AaAAA3nXQ3bdo0iY+Pt0WO//GPf8jq1att2I46dOiQPPHEE7JixQpm0uK85PMxdTqbafHixTnuHzt2rOd6RESEvPfee74+FACAA2iI6927tzVdOcG9dMq3334rTz/9tDVdD08nWWjTal5ISEhhHzbgc0wnAgAELC0K6CQKdeONN8q8efPk3nvvtUXtX331VdvZQvehBc4HfjH7FQCAc6XLZ7Vv396aBrrly5fL5MmTbXiPW8+ePa1qp+umAk5DqAMAOI5W73Sinja3EydO2Hi8BQsWyObNmwv1+ABfINQBAM4LWqHTmbO7du2yNe+6detW2IcE5CtCHQDgvFKhQgVrgNMwUQIAAMABCHUAAAAOQKgDAABwAEIdAACAAxDqAAAAHIBQBwAA4ACEOgAAAAcg1AEAADgAoQ4AAMABCHUAAAAOQKgDAABwAEIdAACAAxDqAAAAHIBQBwAA4ACEOgAAAAcg1AEAADgAoQ4AAMABCHUAAAAOQKgDAABwAEIdAACAAxDqAAAAHIBQBwAA4ACEOgAAAAcg1AEAADgAoQ4AAMABCHUAAAAOQKgDAABwAEIdAACAAxDqAAAAHIBQBwAA4ACh3jzp0KFDMnr0aNm4caOkpaV57n///fd9eWwAAADIz1DXs2dPKVOmjFx88cUSEhLi7XsDAADAn0Ld7t27Zfbs2b4/GgAAAPhuTF3NmjWtCxYAAAABXKmLjo6WZs2ayVVXXSWRkZGe+0eOHOnLYwMAAEB+hrr69etbAwAAQACHuieeeML3RwIAAADfjqk7evSoDBkyROrUqWPtn//8p90HAACAAAp1d999t61P9/nnn8vEiRPlxIkTdh8AAAACqPt11apVsnLlSs/td955Rxo3buzL4wIAAEB+V+q0Mpe5uzUhIcHuAwAAQABV6m6//Xa56KKLpFevXnZbu2HvuOMOXx8bAAAA8jPU/d///Z80bNhQ5syZY7dffvllW7MOAAAAARTq1NVXX20NAAAAARbqHnjgAXnllVfk+uuvl6CgoByPf/nll748NgAAAORHqLvsssvssnv37t6+HwAAAPwt1HXt2tUuy5Ytm2MM3fTp0317ZAAAAMjfJU0effRRr+4DAACAH1bq1q1bJ2vXrpXDhw/LlClTPPfr7aSkpII4PgAAAJxrqFu8eLF88MEHsm/fPnn11Vc99xctWtQmUAAAACAAQp0uOqxt3Lhx0q9fv4I7KgAAAOT/OnUa6I4fPy6bN2+WY8eOee5v1KjRmf00AAAAFF6omzp1qtx1111y8OBBiYmJscuqVatayAMAAECAzH4dPny4/PTTT1K/fn3Zv3+/fPjhh9KzZ0/fHx0AAADyL9QFBwdbZS4tLc1u33rrrTJ37lzvfgIAAAD8I9SFhYXZZaVKlWTy5MmyfPly64L1xvr166VNmzZSp04dadmypaxZsybX561evdp2sNBqoDa2IAMAAMjnMXX33nuvhbhnn31WevfuLYcOHZLXXnvNqx8wcOBAGTBggPTt21e++OILu1y6dGmW5+iad9ddd51167Zr105OnDghBw4cOIOPAQAAcH7zKtTddNNNdtm8eXOrvHlL17dbtmyZzJw502736NFD7rnnHtmwYYPUqlXL87yPP/5YLrroIgt0KiQkRMqUKXOmnwUAAOC85VWoUz///LNs3LjRM65O9enTJ8/XbN++XcqXLy+hoRk/JigoSKpUqSLbtm3LEup+//13iYiIkC5dusiOHTtsqRRd3JhgBwAAkI+hbvDgwTJjxgxp0qSJVdHcAe10oc5bGhRnz55tM2wrVKhg+8rqz9Tu2uxGjhxpLXPXrR5boNP1//gc/oPz4V84H/7FKecDcJogl8vlOt2TateubRMZIiMjz+jNtftVK3I6Pk6rdfqjtHK3aNGiLJW6l19+WVatWmVj6pROpujcubNV7U5Hq3nx8fES6PQvSP3MgY7P4V84H/6F8+FfdPKfN//OAI6a/apBTLtHz1RcXJw0a9ZMJkyYYLcnTZpkv0SZA5268cYbbfLEkSNH7Pa3334rjRs3PuOfBwAAcL7yqvu1devWtthwr169slTrunXrdtrXjh492ma8jhgxQooWLSrjx4+3+/v372+v16bj7LTLVZc+0TXxKlasKGPGjDmXzwUAAHBe8SrU6QxWNWrUKM99OqbOm1BXt25dWbx4cY77x44dm+X2bbfdZg0AAAA+CnXff//9Wbw1AAAA/CLU6Zp0OklCJzHkRpceAQAAgJ+Huvvvv1+mTp1quz1kp92vmzZt8uWxAQAAID9CnQY6tXnzZm/fDwAAZKNLerkbcKa0kKYTSfNtRwldbmTLli1ZdpTQ5UoAAEDu0tPTbc1W3TOdQIdzERYWZquFhIeHn1uoe/XVV+Xxxx+3hX4z7yixbt26czpAAACcbOvWrVZhqVatmv2jDJwN/Q/B/v37c2yzelah7s0335Q///zTtvACAADeVel0SzWdcOjeAx04W6VKlbIduvTP1am6Yr3aUUIXAybQAQDgPXd3q/ZsAefK/ecor258r/7roLs9DB06VLp06ZJlR4lLL730nA8SAAAA586rUKc7Qnz44YeyaNGiLGPqlixZkg+HAAAACoqO79P93KOioiQ5OVnuuOMOefjhh0/7Ov13/+DBg1K8ePFzPgadOPLuu+969XMLSv/+/eWWW26RDh06FMjrCi3UaaDTma/5cSIBAEDh+uyzz6RJkyayc+dOueCCC6Rjx47SqlWrAvv5Guqef/55r0Odrrzh63GJY7NtX+rr1/mCV99Q1apVCXQAAJyj/v9dKlv3J/nke6xaKlrG3t7yjF6jY+br1atns3Q11G3YsEEGDRpky7DoYPwnn3xSunfv7nn+yy+/LNOmTZPExER54oknrEKVWxWvdOnStm+8LsGhw7fmzJljS3FoMPvhhx/sZxw9etSCpd7n3mPebd68eTJkyBC56KKL5JdffpHHHntMjh8/Lq+//rqkpqbaZIFnn31Wunbtaq+99dZb5Y8//vCMO2vTpo0MHz5crr766izv+/HHH+f6Huqyyy6T++67zz5v37597Xh1k4WNGzdaFU6P+cEHH7QZqPqckSNH5vo6rYLq97h9+3Zp2LChfPrpp/Ze+nm1qrdy5UpbTUTDdEpKinzwwQdSoKGuZcuWcuONN0rPnj2zjKnr1q1bvh0IAAAoWGvXrrWlMjSYKA1pd955pwwcONC2CtVQ1bRpUyvuKA1Ny5cvt7DTokULadu2rXXnnooGGA10a9assZB4+PBhCzja9aqBbsWKFad8rYa0d955R8aNG2e39ThvuukmOwbtPdRj0zCqx6EzQ2fNmiWdOnWy44uPj5errroqx3t27tw51/fQIJbd6tWr5fvvv7fj1gCmoVV/hgbCGjVqSL9+/aRBgwY5XqefSV+n76lzDyZNmmQ/8+mnn7Yub/1cCQkJFjybN28u+cmrUKcpWY0aNcpzn34hhDoAALx3ppU0X+nVq5eFFV2uTNei1cqRVpJ+/fVXq6QpXYqlXbt2snDhQk+o00qT0lCjgWXBggV5hjp9nnadalDUate1117r1c4I7te2b9/ec1t3t9LQuWPHDqvu6fIeep9WGu+991556623LNS9/fbbcvfdd+c66ziv98hOt0h1F7IuvPBCC4S61qA2DXkaenMLdddff71ER0fbda1+aqVPabjV71qPKzY21s6BVvQKPNRp4gQAAM4aUzd79mzrftQxdbmFs9Mtx+J+XCdRnjhxwnO/rs+nihUrJr/99pvMnz/fssQjjzxiQdCb8XFFihTJcrt37942Dk97DVXJkiU9P+eGG26wrlGt0k2ZMsW6iXOT13tkl7lnUj9f9tuZd9jK63Wnep4vlrrxKi7rCcitAQCAwHXFFVfI4MGD5d///rdVj3T7z/Hjx9tjWkXSVS8yL1/mfky7LrWCd8kll9ht3eXg559/tutffvmljblT2g2q17WCNmLECAuOv//+uxQtWtRm3mpXpre0+7N69ep2fcKECXbbTUPioEGDrAdRK2WnmtiZ13v4mgbn//73v7bOnHa/fv755/n+M7yq1D3wwAOe65potVyrg/+0TAsAAAKXTijQUKZDrT766CMLR9qVqZUkndmpkx3ctBqnY+w0qL3xxhue6p52K+qECA2H2sWqY9yUTha46667bJKDvlbH4OnkBe3C7NOnjzRq1MgqctknSuRGJzhohU0DmwakzMel+vXrZ+vq3nPPPWf9Hr6k263qMdavX98mkjRu3Dj/J6G6zsLPP//sGjx4sMsflC5d2uUE06dPdzkBn8O/cD78C+fDv1SsWNGn75+Wlub6/fff7RK+N3HiRFfHjh399qtOTU11JScn2/WEhARX27ZtXZ9++mm+/nk6q0VfdOCfzowBAAAobDrTdd26dTJ58mTxV9rVq1VKrVhqr6dOxNCVRfKTV6Fu1apVnut6MNpvrqVUAACAwjZ9+nTxd3FxcZ7VRHzFq1CnadLzgtBQm+asg/0AAADgH7wKdbqGCwAAAAI01B05ciTPF+uUZAAAAPh5qNOptjqlWddUyU7vz7zQIAAAAApPnosP62a3Gtz0Mnsj0AEAEHh0bbm6devajhK63ZVuq1VQdJsxb3ap0r1ov/rqK/EHjz/+uK3fV1CvOxdntaQJAAAI/G3CdDN7XQBYd4bQS2/otlfebPOVG13MOD+dy7F46+mnny7Q1/msUleiRAnbFy17c98PAAACV9WqVa1qp2u8jRw5Ulq2bGlhTy8XL16cpbr30EMP2Tq1t99+u+zZs0c6dOggzZs3t03tdRcH7cVTzz33nG3XpUO3UlJS7DnuilXmCtzHH38srVu3th0qdHeFb7755rTHq9uT6dAwPRbd0kx3vpgzZ45cfPHF9j56LOPGjbPn7tq1S8qWLStJSUme1998880yatSoHO97qvdQffv2lddee82uP/nkk7a2nO6XW6dOHenSpYvtbdu5c2e7fdNNN3m+h+yv69Wrl71Oq6O6m8WBAwfsMV0i7u6777bXX3TRRbaLl35PZyPPeLtixYqzelMAAJA7DQ25+frrr227Lt1zNfNSYpmtWbPGLmfMmCHDhg3L9bEzsXr1alm7dq2Fqvbt23ve86effrJQoo+57d+/39ap1TH1uniuhjDd4kuHY+nx6l6mvXv3tq26rrnmGnnllVds9YwWLVrILbfckuNnaxDSEKTvp2FNA41WDiMiIvI85sOHD9t3+MILL3gW9dU9akNCQiwoaTDT965UqZLtbat7vA4YMED27t0rs2fPljFjxuR4Tw2Ip3qP7HRLM11vTsOlhi/tUp41a5ZERUXZZ/3uu+9sq7Ts9LvT1+kWavo9jR49Wh555BE7nvXr13vOn353Zyv0dAkeAAA4i1aNNIRER0fL+++/b+vPzpw506psGt60S1P3eU9OTrbnKQ15GsCUVqO0WqZBSCty+/btsz3hNazoczRIaTDSnj0NM7nRwKdhb8eOHfbzNEzpffXq1cvz2HXf2FtvvdVzW49X91Rdt26dvY/e1uqZBrJ7773X9p7VUPfee+9ZiNQgml1e75Fdp06d7HO5w6CG0NjYWLutn1kD2ql2vXDviatVQQ3U7iqhfh79XEoroWfbTZ1nqNODc5/A3Pz6669n9UMBADhfna6iptW60z1Hq0hnU5nLPqbOLTU1VW644QabxKBdr7qkWbFixaz71B3qMoch7arVIKeBLTIy0ip8Wr1z04qbBr+jR49KYmKiPSc7DYDPP/+89OzZ027rsK7M73EqGkSDg/8ePTZo0CCrbk2aNMkyiwYt9/tod7E+Xz+XVsS0UpebvN4ju8yfRSt72W/rOD9vXneq5+WVu84p1Ln7ggEAgHNpgNFgV6VKFbv95ptv5vl87fIsV66cBRUdXzdx4kTp0aOHPaaBUAPb//73P1m6dKn06dNHpk6dmiOs6HtUr17drmtlT2+fDX2d9iwGBQXJggULZOXKlVke12qdHoOOZdNxa2fzHr6k4+t0fKGO91Mffvihb0Kd9q8DAABn080Enn32WatslS5d2kJZXjQoaYVNx7ZVqFDBxq65aTemdqvqRAodc6Yh6cUXX7Tu2sxef/11ew8dm6bBxh0oz5RW+3SiwTPPPGPVR518kZn+jMGDB9tkjrN9D18aOHCgdcVq6NRuXR2Xp5M8zkaQK7eVhQNImTJlJD4+XgKdDnrVcnqg43P4F86Hf+F8+BcdL6XjuXxFJxDoGC2tDml3GwrHsmXLrAqmkz4yd9v6E+2m1nF5OhNWA7HOGM4egr3588Q6dQAAwJH69+9vE0B04oG/BjqllU4dv6jd4O3atZOhQ4ee1fsQ6gAAgCONzefFjn3lVDOEz5TXsVVnhIwYMcKu79y50zMVFwAAAIUv2Nv9yzTtfvDBBxkvCg62gX0AACB37tmeAT50HX7C/ecoryVPvOp+1VWudU06nZGhypcvLwkJCfl1nAAAOI4WQHTJD+3d0u2q3IvLAmcT6HRBZP0zlNfYQK9CnS48mH2mBf/zAAAgb7r2mS7Sq9tg8e8mzoUGutMt+xLq7R/KhQsXWslPp9vq2LrMK1EDAICctKqii/RqpU5DHcEOZ0Pzlzezd70KdW+88YbtRaaTI2JiYmxBwY8++uisDgwAgPPxH+Vz2f4J8IZXoU7/hzF9+nRJSkqy/2VosAMAAECAzX7V/dy+/fZbG/BJoAMAAAjQUNetWzfbt61y5cq2bcWff/7p+yMDAABA/oY6HU83b948myyhM2GvueYaadu2rfc/BQAAAD51RhuhaaWuQYMGtpks1ToAAIAAC3W68PA///lPqVixou0qceedd8quXbt8f3QAAADIv9mvN910k9xxxx2yfPlyC3YAAAAIwFBHVysAAEAAh7pXXnlFHnjgARk2bFiuj48cOdJXxwUAAID8CnVFihSxy2LFip3JewIAAMCfQt3AgQPt8vrrr5dGjRpleWzVqlW+PTIAAADk7+zXvn37enUfAAAA/LBSt2/fPtmzZ48kJyfL6tWrbd9XdfjwYUlMTCyoYwQAAMC5hLpPPvlEXnvtNVuTTrcKc9Mxdg8++ODp3hsAAAD+EOruvfdea88884wMHz68oI4JAAAAvlinzh3oUlJSrLkVLVr0TH8eAAAACmuixM8//yz169eX6OhoKVGihKcBAAAggCp1Q4cOtT1fBw0aJAsWLJA33nhDIiMjfX90AAAAyL9K3fHjx6V169aSlpYmsbGx8thjj8mnn37q3U8AAACAf4S6sLAwuyxVqpT8+uuvEh8fbw0AAAABFOp69+4t+/fvl0cffVTat28vlStXlnvuucerH7B+/Xpp06aN1KlTR1q2bClr1qw55XN1HbyOHTtK8eLFvf8EAAAA8G5M3f3332+XnTp1kgMHDsixY8esG9YbutXYgAEDbAeKL774wi6XLl2a63NfffVVqVmzplUDAQAAkE+h7nT7u2bfDza3HSmWLVsmM2fOtNs9evSwCt+GDRukVq1aWZ6rFbyvvvpKxo8fLxMnTvT+EwAAAECCXO69v3JRvXr1U35FQUFBsmnTpjy/wl9++UVuvvlm+fPPPz33tWrVSp5//nnrZs08EUO7dceNGydRUVHSpEkTOXToUK7vOXLkSGtuBw8elC+//DLgT6VWP50wo5jP4V84H/6F8+Ff+vXrJzt27CjswwAKplK3efNmKQhPPfWU3HDDDbYW3pYtW/J87rBhw6y5lSlTRjp37iyBbsaMGXwOP8L58C+cD//ilPMBnJcTJdSkSZNkxIgRdl33gl29evVpX6MTKnbv3m1LoSgtCm7btk2qVKmS5Xnz58+XN998U6pVqybt2rWTI0eO2HVm2AIAAORjqHv88cdl7NixtgCxu+tVJ0CcTlxcnDRr1kwmTJjgCYaVKlXKMZ5u4cKFsnXrVqvSLVq0yLYf0+tahQMAAEA+hbqvv/5apk6dKjExMXa7fPnykpCQ4M1LZfTo0dZ0SRMdS6cTIVT//v1lypQpXr0HAAAA8mFJE528EBISkuW+POZXZFG3bl1ZvHhxjvu18pcb7XY91SQJAAAAnEOoq1q1qnWRarerzlTVsXU6QxUAAAABFOreeOMNuf32221yhHbBdujQQT766CPfHx0AAADyL9SVLVtWpk+fLklJSdbtqsFu+fLlUrp0ae9+CgAAAAp3ooTuCKGzVnXv1+joaJuV2r17d9syDAAAAAEQ6l544QW54oor5KWXXpKLL77Y1pJr2bKlLUmyfv36gjtKAAAAnH33q65L9/vvv0uFChVk7dq10rBhQ1tJ/PLLL8/7XQEAAOA/lTrdi1QDnapXr56tNUegAwAACLBKnW4+rTNe3WvS6WXm240aNSqYowQAAMDZh7rk5GTp1q1blvvct3XNuk2bNuX97gAAACj8UKczXQEAAOCQvV8BAADg3wh1AAAADkCoAwAAcABCHQAAgAMQ6gAAAByAUAcAAOAAhDoAAAAHINQBAAA4AKEOAADAAQh1AAAADkCoAwAAcABCHQAAgAMQ6gAAAByAUAcAAOAAhDoAAAAHINQBAAA4AKEOAADAAQh1AAAADkCoAwAAcABCHQAAgAMQ6gAAAByAUAcAAOAAhDoAAAAHINQBAAA4AKEOAADAAQh1AAAADkCoAwAAcABCHQAAgAMQ6gAAAByAUAcAAOAAhDoAAAAHINQBAAA4AKEOAADAAQh1AAAADkCoAwAAcABCHQAAgAMQ6gAAAByAUAcAAOAAhDoAAAAHINQBAAA4AKEOAADAAQh1AAAADkCoAwAAcABCHQAAgAMQ6gAAAByAUAcAAOAAhDoAAAAHINQBAAA4AKEOAADAAQh1AAAADuDzULd+/Xpp06aN1KlTR1q2bClr1qzJ8Zy5c+dKq1at5IILLpAGDRrIgw8+KOnp6b4+NAAAAMfweagbOHCgDBgwQNatWycPPfSQ9O3bN8dzSpQoIZ9++qn8/vvv8ssvv8iPP/4oH374oa8PDQAAwDF8Gur27dsny5Ytk1tvvdVu9+jRQ7Zv3y4bNmzI8rymTZtKjRo17HpkZKQ0adJEtmzZ4stDAwAAcBSfhjoNcOXLl5fQ0FC7HRQUJFWqVJFt27ad8jV79uyRL774Qrp06eLLQwMAAHCUjLTlJ44cOSJdu3a1MXUtWrTI9TkjR4605paUlCQzZsyQQHfs2DE+hx/hfPgXzod/ccr5AJwmyOVyuXzZ/VqrVi05cOCAVev0R2nlbtGiRXZ/ZkePHpXOnTvLNddcI//+97+9/hllypSR+Ph4CXT6F6R+/kDH5/AvnA//wvnwL5UqVZIdO3YU9mEAgdH9GhcXJ82aNZMJEybY7UmTJtkvUfZAl5CQIFdddZW1Mwl0AAAAKKDZr6NHj7amS5o8//zzMn78eLu/f//+MmXKFLv++uuvy5IlS+TLL7+0SRLannvuOV8fGgAAgGP4fExd3bp1ZfHixTnuHzt2rOf6Y489Zg0AAABnhx0lAAAAHIBQBwAA4ACEOgAAAAcg1AEAADgAoQ4AAMABCHUAAAAOQKgDAABwAEIdAACAAxDqAAAAHIBQBwAA4ACEOgAAAAcg1AEAADgAoQ4AAMABCHUAAAAOQKgDAABwAEIdAACAAxDqAAAAHIBQBwAA4ACEOgAAAAcg1AEAADgAoQ4AAMABCHUAAAAOQKgDAABwAEIdAACAAxDqAAAAHIBQBwAA4ACEOgAAAAcg1AEAADgAoQ4AAMABCHUAAAAOQKgDAABwAEIdAACAAxDqAAAAHIBQBwAA4ACEOgAAAAcg1AEAADgAoQ4AAMABCHUAAAAOQKgDAABwAEIdAACAAxDqAAAAHIBQBwAA4ACEOgAAAAcg1AEAADgAoQ4AAMABCHUAAAAOQKgDAABwAEIdAACAAxDqAAAAHIBQBwAA4ACEOgAAAAcg1AEAADgAoQ4AAMABCHUAAAAOQKgDAABwAEIdAACAAxDqAAAAHIBQBwAA4ACEOgAAAAcg1AEAADiAz0Pd+vXrpU2bNlKnTh1p2bKlrFmzJtfnjRs3TmrXri01a9aUu+66S44fP+7rQwMAAHAMn4e6gQMHyoABA2TdunXy0EMPSd++fXM8Z/PmzTJ8+HBZuHChbNiwQfbu3Stjxozx9aEBAAA4hk9D3b59+2TZsmVy66232u0ePXrI9u3bLbhl9sUXX0i3bt2kXLlyEhQUJIMGDZJPPvnEl4cGAADgKD4NdRrgypcvL6GhoXZbA1uVKlVk27ZtWZ6nt6tWreq5Xa1atRzPAQAAwKllpK0AMnLkSGtu+/fvl0qVKkmgS0hIkCJFikig43P4F86Hf+F8+Jc9e/YU9iEAgRPqKleuLLt375a0tDSr1rlcLqvAabUuM729ceNGz+0tW7bkeI7bsGHDrLlpoNuxY4cEOj6Hf+F8+BfOh39x0vkAnMSn3a9xcXHSrFkzmTBhgt2eNGmS/RLVqlUry/N0rN2UKVPsf00a/N59913p3bu3Lw8NAADAUXw++3X06NHWdEmT559/XsaPH2/39+/f34KcqlGjhjz11FPStm1bC3xlypSxWbMAAADwkzF1devWlcWLF+e4f+zYsVlu69p02s5U5q7YQMbn8C+cD//C+fAvnA/APwW5tL8TAAAAAY1twgAAAByAUAcAAOAAARHqnLB/7LFjx6R79+72GRo3bixXXnlljp013Mu5hISESJMmTTwt83Iv/kAXh9axku7j++yzzwLufOj6hpm/Yz0vuuzOgQMH/P58DB061M6BLua9YsWKM/498Zdzk9vn8Pb3xJ/OzanOh7e/J/58Prz9PfGX85HXnx/d4eiqq66y77lhw4ayYMGCU77P1KlTpV69evbcG264QY4cOVKAnwI4B64A0KFDB9f48ePt+sSJE10tWrTI8ZxNmza5ypcv79q9e7crPT3d1bVrV9dbb73l8hfJycmuadOm2bGpN99809W+ffscz9u8ebOrWLFiLn9WtWpV1/Lly/N8jr+fj+xeeuklV5cuXQLifMyfP9+1ffv2HOfBm98Tfzo3uX0Ob39P/OncnOp8ePN74u/nw9vfE385H3n9+bnjjjtcTzzxhF1fsmSJq2LFiq7U1NQc73H06FFXXFyc648//rDbQ4YMcf3rX/8q0M8BnC2/D3V79+51xcbGuo4fP2639Ze1bNmyrvXr12d53osvvugaOHCg57b+Yrdt29blr5YuXWp/efrjX4yn480/VoF2PurVq+eaPHlyQJ2PzOfB298Tfzw3ef15OtXviT+em7MNdYF0Pk71e+KP5yP7n5+YmBgLzm4tW7Z0zZo1K8drPv/8c1fnzp09t9esWWMBEAgEft/96tT9Y19//XW57rrrcn0sMTHRus904eann35aTpw4If6mT58+cuGFF0q/fv0kPj4+x+OBdD5+/PFHOXjwoHTp0iVgz4e3vyeBdm7y+j0JhHNzut+TQDofp/s98cfz4f7zo93I2qVdrly5037PuZ0P985IgL/z+1DnRCNGjLBxHv/5z39yPKb/MO/cuVOWLl0qs2fPloULF8orr7wi/kTHoqxatUp+/fVXKV26tNx+++0SyHQ8k/7j6w5EgXY+zsffk0A4N+fT74k/no/T/fkBnMjvQ13m/WNVXvvHbt261av9YwvTyy+/LF9++aV89913Eh0dnePxiIgI215NlSxZUu688077y9GfuL/XsLAwue+++3I9vkA5H7rB+ueff27fc24C4Xycye9JoJyb0/2eBMK58eb3JFDOx+l+T/ztfGT/81OqVCkLo7oV5em+59zOR+YqOODP/D7UOWn/2JEjR8onn3wis2bNkuLFi+f6HJ2h5Z75lpKSYn8xNW3aVPyFdq8cOnTIc1s/T27HFwjnQ+mMRJ0lpzPdAvF8nOnvSSCcG29+T/z93Hj7exII58Ob3xN/Oh+n+vPzj3/8w75bpdVErSq2b98+x+t1hqxWV9euXWu333nnHb87H8ApuQLA2rVrXRdddJGrdu3arubNm7tWrVpl9/fr18/19ddfe543ZswYV40aNazdeeeduc5sKiw6q0y/bj22xo0bW2vVqpU9Nnz4cNeoUaPs+qRJk1wNGjRwNWrUyHXBBRe47rnnHtexY8dc/mLjxo2uJk2auC688EJXw4YNXd26dbMB0oF2Ptwuvvhi1/vvv5/lPn8/HwMGDLCB2yEhITZLr2bNmnn+nvjrucntc+T1e+Kv5ya3z5HX70kgnY+8fk/88Xzk9ednz549riuvvNJVq1YtO765c+fm+jmUnpu6devad3Dddde5Dh06VKCfAzhbbBMGAADgAH7f/QoAAIDTI9QBAAA4AKEOAADAAQh1AAAADkCoAwAAcABCHRBAdMuiunXrSpMmTazVqFFD7r///tO+7oMPPpDu3bvn+thvv/1m7wsACGwskQ0EGF0IVgMdAACZUakDAlj2Ctz//vc/ad26te0ucemll8rKlStzfd2TTz4ptWvXlubNm8unn35agEcMAPAVKnVAgOnVq5dERUXZ9cybxP/www+2PZJuJK/7cOq+mzfffLOsWbMmy+unTZsmEydOlF9++UViY2PltttuK/DPAADIf4Q6IIC7X7VS5/b1119bZU4rdW4HDhyQ5OTkLK+fM2eO3HjjjVK0aFG7PXDgQFm0aFGBHT8AwDcIdYBD6GbwWrkbMWLEGb0uKCjIZ8cEACg4jKkDHKJbt24yYcIE2bZtm91OT0+XZcuW5XjeFVdcYd2vR48etSA4ZsyYQjhaAEB+o1IHOMQll1wiL774olx//fWSlpYmqampcu2110qLFi2yPO+aa66RJUuW2GQK7YK9+uqrC+2YAQD5J8il/1UHAABAQKP7FQAAwAEIdQAAAA5AqAMAAHAAQh0AAIADEOoAAAAcgFAHAADgAIQ6AAAAByDUAQAAOAChDgAAQALf/wPUQWRMU1N/nwAAAABJRU5ErkJggg==",
      "text/plain": [
       "<Figure size 800x550 with 1 Axes>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "aimed = CookeTriplet()\n",
    "aimed.ray_tracer.set_aiming(\"robust\")\n",
    "ri_aimed = RelativeIllumination(aimed)\n",
    "\n",
    "field = np.asarray(ri_aimed.data[\"Hy\"]) * aimed.fields.max_field\n",
    "fig, ax = ri_aimed.view()\n",
    "ax.lines[0].set_label(\"Robust ray aiming\")\n",
    "ax.plot(field, ri.data[\"relative_illumination\"][0], \"k--\", label=\"Paraxial ray aiming\")\n",
    "ax.legend(bbox_to_anchor=(1.05, 0.5), loc=\"center left\")\n",
    "fig.tight_layout()"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "938c804e27f84196a10c8828c723f798",
   "metadata": {},
   "source": [
    "## Data\n",
    "\n",
    "`ri.data` holds the normalized field coordinates, the relative illumination, the unnormalized projected solid angle (`\"irradiance\"`, in sr, weighted by transmission), and a reliability flag per field."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 7,
   "id": "504fb2a444614c0babb325280ed9130a",
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      " Hy     RI      irradiance (sr)  reliable\n",
      "0.00  1.0000         0.031671  True\n",
      "0.20  0.9901         0.031357  True\n",
      "0.40  0.9607         0.030427  True\n",
      "0.60  0.9130         0.028916  True\n",
      "0.80  0.8498         0.026913  True\n",
      "1.00  0.7775         0.024623  True\n"
     ]
    }
   ],
   "source": [
    "ri = RelativeIllumination(lens, num_fields=6)\n",
    "print(\" Hy     RI      irradiance (sr)  reliable\")\n",
    "for hy, value, area, ok in zip(\n",
    "    ri.data[\"Hy\"],\n",
    "    ri.data[\"relative_illumination\"][0],\n",
    "    ri.data[\"irradiance\"][0],\n",
    "    ri.data[\"reliable\"][0],\n",
    "    strict=True,\n",
    "):\n",
    "    print(f\"{hy:4.2f}  {value:6.4f}  {area:15.6f}  {ok}\")"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "59bbdb311c014d738909a11f9e486628",
   "metadata": {},
   "source": [
    "## Vignetting\n",
    "\n",
    "Clipping the front lens to a radius of 6 mm cuts the off-axis beams. The relative illumination drops at the fields where rays are vignetted, while the on-axis beam is untouched."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 8,
   "id": "b43b363d81ae4b689946ece5c682cd59",
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "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",
      "text/plain": [
       "<Figure size 800x550 with 1 Axes>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "vignetted = CookeTriplet()\n",
    "vignetted.surfaces[1].aperture = RadialAperture(r_max=6.0)\n",
    "\n",
    "nominal = RelativeIllumination(CookeTriplet(), num_pupil=128)\n",
    "clipped = RelativeIllumination(vignetted, num_pupil=128)\n",
    "\n",
    "field = np.asarray(nominal.data[\"Hy\"]) * vignetted.fields.max_field\n",
    "fig, ax = clipped.view()\n",
    "ax.lines[0].set_label(\"Front lens r = 6 mm\")\n",
    "ax.plot(\n",
    "    field,\n",
    "    nominal.data[\"irradiance\"][0] / max(nominal.data[\"irradiance\"][0]),\n",
    "    \"k--\",\n",
    "    label=\"Nominal\",\n",
    ")\n",
    "ax.legend(bbox_to_anchor=(1.05, 0.5), loc=\"center left\")\n",
    "fig.tight_layout()"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "8a65eabff63a45729fe45fb5ade58bdc",
   "metadata": {},
   "source": [
    "## How to read the plot, and limits\n",
    "\n",
    "- **RI = 1** is the brightest field point, which is not always on axis (some wide-angle lenses are brightest at the edge).\n",
    "- Transmission losses (coatings, absorption, apodization) are included through the traced ray intensity.\n",
    "- The method assumes that the image surface is a good conjugate of the object, so that rays from one field point land close together. Strong defocus or field curvature at the image surface make the result differ from the true irradiance.\n",
    "- If rays from different parts of the pupil reach the same image-space direction (a caustic in direction space), the area no longer measures the irradiance. The analysis then emits a `RuntimeWarning`, sets `data[\"reliable\"]` to `False` for that field, and marks it with an `x` in the plot.\n",
    "- Only planar image surfaces are supported."
   ]
  }
 ],
 "metadata": {
  "kernelspec": {
   "display_name": "Python 3",
   "language": "python",
   "name": "python3"
  },
  "language_info": {
   "codemirror_mode": {
    "name": "ipython",
    "version": 3
   },
   "file_extension": ".py",
   "mimetype": "text/x-python",
   "name": "python",
   "nbconvert_exporter": "python",
   "pygments_lexer": "ipython3",
   "version": "3.13.2"
  }
 },
 "nbformat": 4,
 "nbformat_minor": 5
}
