From 56287dfbc7dcf62762fe8d5b5c0fc04594524d01 Mon Sep 17 00:00:00 2001 From: Marshall Perrin Date: Fri, 22 Jun 2018 23:18:17 -0400 Subject: [PATCH] docs improvements, including new available_optics page --- .rtd-environment.yml | 13 + docs/available_optics.ipynb | 861 ++++++++++++++++++++++++++++++++++++ docs/conf.py | 6 + docs/fresnel.rst | 8 +- docs/index.rst | 1 + docs/overview.rst | 4 +- readthedocs.yml | 7 + 7 files changed, 893 insertions(+), 7 deletions(-) create mode 100644 .rtd-environment.yml create mode 100644 docs/available_optics.ipynb create mode 100644 readthedocs.yml diff --git a/.rtd-environment.yml b/.rtd-environment.yml new file mode 100644 index 00000000..7cc15e23 --- /dev/null +++ b/.rtd-environment.yml @@ -0,0 +1,13 @@ +name: packagename + +channels: + - http://ssb.stsci.edu/astroconda + +dependencies: + - setuptools + - numpy + - python>=3.0 + - pip: + - sphinx-automodapi + - stsci_rtd_theme + - nbsphinx diff --git a/docs/available_optics.ipynb b/docs/available_optics.ipynb new file mode 100644 index 00000000..2487fe14 --- /dev/null +++ b/docs/available_optics.ipynb @@ -0,0 +1,861 @@ +{ + "cells": [ + { + "cell_type": "code", + "execution_count": 1, + "metadata": { + "nbsphinx": "hidden" + }, + "outputs": [ + { + "name": "stdout", + "output_type": "stream", + "text": [ + "Populating the interactive namespace from numpy and matplotlib\n" + ] + }, + { + "data": { + "image/png": "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\n", + "text/plain": [ + "
" + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], + "source": [ + "%pylab inline\n", + "import poppy\n", + "import astropy.units as u\n", + "import matplotlib\n", + "matplotlib.rcParams['figure.figsize'] = (10,7)\n", + "matplotlib.rcParams['font.size'] =12\n", + "plt.figure(figsize=(1,1))\n", + "plt.plot(np.arange(10))\n", + "plt.title(\"Placeholder plot to make it load the rc file\")\n", + "plt.show()\n", + "matplotlib.rcParams['figure.figsize'] = (10,7)\n", + "matplotlib.rcParams['font.size'] =12" + ] + }, + { + "cell_type": "code", + "execution_count": 2, + "metadata": { + "nbsphinx": "hidden" + }, + "outputs": [ + { + "data": { + "image/png": "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\n", + "text/plain": [ + "
" + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], + "source": [ + "matplotlib.rcParams['figure.figsize'] = (10,7)\n", + "matplotlib.rcParams['font.size'] =12\n", + "plt.figure(figsize=(1,1))\n", + "plt.plot(np.arange(10))\n", + "plt.title(\"Placeholder plot to make it load the rc file\")\n", + "plt.show()" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "# Available Optical Element Classes\n", + "\n", + "There are many available predefined types of optical elements in poppy. In addition you can easily specify your own custom optics.\n", + "\n", + "* [Pupils and Aperture Stops](#Pupils-and-Aperture-Stops)\n", + "* [Image Plane Elements](#Image-Plane-Elements)\n", + "* [General Purpose Elements](#General-Purpose-Elements)\n", + "* [Wavefront Errors](#Wavefront-Errors)\n", + "* [Deformable Mirrors](#Deformable-Mirrors)\n", + "* [Supplying Custom Optics from Files or Arrays](#Supplying-Custom-Optics-from-Files-or-Arrays)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Pupils and Aperture Stops\n", + "\n", + "These optics have dimensions specified in meters, or other units of length. They can be used in the pupil planes of a Fraunhofer optical system, or any plane of a Fresnel optical system.\n", + "All of these may be translated or rotated around in the plane by setting the `rotation`, `shift_x` or `shift_y` parameters. " + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "### CircularAperture\n", + "A basic aperture stop." + ] + }, + { + "cell_type": "code", + "execution_count": 3, + "metadata": {}, + "outputs": [ + { + "data": { + "image/png": "iVBORw0KGgoAAAANSUhEUgAAAm8AAAGHCAYAAADmybX6AAAABHNCSVQICAgIfAhkiAAAAAlwSFlzAAALEgAACxIB0t1+/AAAADl0RVh0U29mdHdhcmUAbWF0cGxvdGxpYiB2ZXJzaW9uIDIuMi4yLCBodHRwOi8vbWF0cGxvdGxpYi5vcmcvhp/UCwAAIABJREFUeJzt3Xm8JFV99/HPb2ZgQGBUUAFBQSIooAKKGkUDxgURfTRRcEGRREVU4hIxMREVlbg96hO3RFEJLiiC4oYawRhQwAVxA1wQFWQbAUeWwWFgZn7PH6fuTN2evvd23+6+3dX9eb9ePdNdVV19qs/pU98+VXU7MhNJkiQ1w6JhF0CSJEmdM7xJkiQ1iOFNkiSpQQxvkiRJDWJ4kyRJahDDmyRJUoMY3hZIRLw9Ii4edjkGISK2joivRMTNEZERsd2QytGX9zgiTomIM/pRpkGKiO9FxAdmeiyNooi4V0T8T0TcGhFD+1tVEXFSRHyzD+s5OyI+2o8yDVJEXB4Rx870WM0yUuGt2vHPdrt82GXswfHA/lMPIuL4iPhl60IRcVVEvHZBS9a7fwD2Bh4BbA9c1+8XiIgtI+K4iLgoIv4cEX+MiO9GxEsiYvNqsWnv8QR6EvAvwyxARLwsIr4VEX+qPrP7dvi8HSPi9Ii4JSJujIhPRcQ2gy7vpIiIbSPi/dUO+/aIuD4iPhcRe7csd0RLn/uHiDgjIh5YW+bs2vw7IuK6iDgnIv6x9lmczb8C96D0Gdv3d0vXl3GbiHhnRPwqIm6ryvjtiDg8IpZUi70COGQQr98QDwX+3zALEBGvi4jv1L7479jh83aLiG9U+4IbIuJDEbHFoMs7SkYqvFE+yFO3p1bTHlab9tB2T4qITRekdD3IzJWZ+cdhl2NAdgV+lpmXZObyzFw3n5XMVI8RcVfge8CRwHuBv6S0hX8HDqcKbHO9xxGxOCIWz6dsgxARm/RzfZm5IjNv6ec65+FOwFl0ESKrnenXge2Av6aE0L2Azw2igJMmIu4F/BB4JPAS4L7AwcAdwPci4oktT1nLhj73aZSg9Y2IuHNtmU9X83cGHk+pq1cDP4qIe8xRpF2BH2TmrzNzeQ/bNVN/sSPwI+DpwJuBBwP7AR8DjgEeAJCZN2Xmn2ZZ/yYREfMtX7/1ez+Xmddn5q39XOc8LAW+DPxbp0+IiC2B/wHWUNr0ocATKfU7OTJzJG/Ao4AEdm4zbznwRuAEYAXwnWr6McDPgFuBa4BPAfeoPe+J1TofA5wHrAIuAh5TWyaqdV8OrKaMIn0dWFLNfztwMXAY8NvqtU4DtgCeBfwauBk4Bdiytt63AxdX94+qylG/vZYSUFqnbwdsQmmYv63K/BvgTcAmreunfJO8FFgJfBPYqeW9ezhwJnBLdfse8ODa/CdV01YBVwEfAe46Sz0tbynvf1fT71KV+QbgNuD7Le/z/avln1mV58/A8TO8xkeq7dmxzbxFwJ1b3+OW9+S51XuyBrhvNe+5wE+qst0AnDFVX1XdndHyOs+jtK3bgN8B7wQ277JNn1K9zquBK4B1wJLqPf82pS3fCHyrXifVc/+iqs/bque+uKqnD9SWmfVxNe144Je1x3tV672R0pZ/DjyzD5/fqfrdt4Nl/0/1Xuxcm/aQ6vl/Ocvz5vVZnLQbZee4HFjWZt7XqnmbV4+PANa0LLNfVRcHVo/PBj7aZl07An8CTpylLK3920nV9O2rerqR0vecXW87wAHV8gcD51afg6NneI2vVNt05zbzNgG2qO6fBHyzNu+k6rPwD5T+fx0b+oSXVZ+NqX3C52rP2+j9qNbxy6qcvwZeR7UP6aLezqb0oW8BrgWur6Y/h9Kf3kTpu74K7Nby3L2A86vXv5QScC4Hjq0tM+vjatpHgbNrjx9F2XdO7T9+OtUuemyjU/W7UR/fZtkjqzZy59q0g6vn32eW59Xr9yrKPuWjVZs4itKv/omSKzYd9ud2rtvU8HETvRp4ByWMTG3HOuCVlJ3rPSlDwp8EDmx57rsoYekKyjez0yJi58xcCTy7WsdhlB3DNpSwV7czJSQ9Fbg78Pnqdjvwt9VzPg+8hhIEW30cuB/wZODR1bRbKI3mYuBEYOrcpeuATSmN7ZnA9cA+1bK3AW+rrXcnSuf7TEoI/US13IEAEbEPpUM4jfJhuYUygrW4mn9QNe8YyujJNsC7gc8CT2izHQAPpISrLSgBZ3U1/ZPAHpSd6DWUD8zXI2KPzPxt7fnvBP6ZEkY2Ov+lGpV5FqWTv6p1fpZRvptmKBvAfYC/o4S1m4FrI+IllBG8NwBfonx4Hzf1PrQpw1GU0PNySiDaCfggcFfgRbO8djv7U4LqUyh1tJby3v075YvEUuCfgP+OiF0z86aIWETZAd9EaS9rgfcAe1JGVHpxGqWT/wdK3e1O+RwBEBHfoox+z+YxmXlBD2XYjxIoL5+akJkXRsT1lJ3F92Z57s709lkca9Wo9cHAGzPz5jaLvI3yxeHxlDbWzqrq/1lHijPzqog4GXheRLww24/Abw+cTumjXw2sqka3vkhp+0+mtPNjgbOqz8ANtee/m/L5uIgycti6vVtTvgy9MTM36hcy8452z6t5GKVffBrlc3ZbRLypKutrKV80t6xeo62IOI7S57yS8gVxd+BDwGbA62d57XYOBU4GHsuG/mkpJdD9AlhG+SL/1YjYMzNvrw5df40SrB5OGQ1/H2UEdd6qoxZfpoSgI6rJD6D0Z1PLXELpH2ezR2b+voei7Ad8t6V+z6T0W/tR2tZMHgpcTWnvuwKnUrLCDcBBwC6UPvHHwH/2UMbBG3Z6nCUlzzXy9tUO1vGIah3bVI+nRt6eVFtm52ra/tXjf6EEqLbfkijf9m8D7lKb9jHKzuKutWkfBs5teV59VGjaCEht+lXAazvYtn8BLmpZ/+qWMhxB6agWV49PAy4AYoZ1fg84rmXabtX7c/9ZyjJtpIoSKhL469q0AC4B/qN6PDUy85o5tvPe1XIv7eA9aTfytgbYvqUcfwDe1cn2VMtfCxzRsswTKJ3Fnbpo06dQOolZR+woX0ZuBZ5ePX4yZUeyc22Ze1Ztbt4jb9W23QY8a5ay7Eg5zDbbbWmb53Uz8vYJ4Fttpl8EvHuO+u76szhJN0oYSeBvZpi/df1zSMvIGyUQf4USqO5RTTubNiNv1bypowr3mKVM055PCSZJ2alPTVtafe7eUD0+oFrmeR1u79928N6cxMYjbzcy/YjJFpTwekwn20MJSn8GntiyzOHAjV3W3dmUUbNFcyw3VYf7VY9fSBlVqn8GHlAtM++RN8qX1QQOmKUsOzF3f7HRvpXuRt7OBD7dZvr1zLI/qer3OmqjapRRyxuo9WGUL/Sfm6scw741eeTtB60TIuJxlFGc+1MO202d07cTUD8X6ie1+1dX/29b/f8Z4KXA5RFxJmWY9Us5/dyAKzLzxtrj5cCVOf38ieVsPGI3bxHxUsq3uZ0oHcQSyk6q7oqWMlxdLbcNpdE+BDglqxbasv6o5u8dEce0KcKulMMAndiTEmzOnZqQmRkR36nm1W1Uj61Fm1pFh6/d6srMvLb2+F6Ub6Bndvj8HSmHrv8jpl/JGdXtLygho1MXZeaq+oSI2JXy7fnhlJ3lImBzNnyD3QO4JqePTF0TEfURzK5VdfIu4JMRcSRlZ/GlzPxpbZmNRjsX2Fz1vuCfxYaZ65ytdu/v4ohYWd3fgvK5f0ZmdnIh0nw+r3sCf8zMn68vVObqiPg+C99f/CLLEZh62Taj8/5iT8pn9/Mx/UraxcBmEXH3zLy+i/JcmC0jmNVFJm+kXPBxNzZs806UQ5p7VNux/jOQmRdHxGxHKOaUmX+KclXtN6oR+XOAL2Tmr2rLXNHLa/TBXPX+i8ys7zeXA7/KzNUt03bve8n6bNQuWOjGtBMtI+K+lPOJfkU5bLgvG64kaj3Rs155U5W9CKDaQe5KOa6+gnJY9RcRUb8qqnXYPWeY1pf3NyKeRzlM9knK0O4+lEPGs23XVBloKcdMjTuq5d5M6RTqt10p52H1Ktq8/lwnzF5N+RbZ2ol3aqb1d9q5T713RzH9PdmL8r5c2ofyfJ3y5eEoysUYe1NGOqbqt9371ol1bLzznnboKzOPpXRUp1Pa1QURsf7QTnXl6Mo5bm0vJOrCtZSA3GpbSkc6mwX9LDbQrynt4AEzzJ+a/qvatLVsaOPLMnP3zDyrw9d7AGX0qtuLs9q17/n0F1PbO+z+4hCm9xcPpPQXK3opT0TciRIkE/h7ykjjQ6vHC9FfvIjyJf8syikgF0fEi2vlu6SD/uLe8yhb3Ub9RXXx19ZMUH8x8gXswsMpDe2VmXl+9W1gXn9vLDNvy8yvZeYxlA/d3SiHrvrpdtqfY9Vu+l8B38/M92XmhZn5a8q5XN26EHhCuyuoqm93P6Icurisza2bq5IuobStR01NqF5zv2pexzJzDeWcuyPaXUYeEYtaroKby5WUUcjW8yDnWn63Gd6X1XOtYDYRsQNl9O74zDyrGn1YRxk5nnIJsENE7FR73vaU8zNmcx3l8Grdg1sXqrbjA5n5N8BbKSFyyuFsHOZbbz+bazvncB5w/3qnHhEPpoxCnjvjszSnzFxB+XLwsohY1maRf6WcRnBWy/Muy8zfZBdXL1efz8Moh5y6ueL8EuBuEbFHbV1LKcGk2/5ianuPbtcvVFeQdvMnJX5OOTTfaX9xSbX8LjP0F2u7eO12dqd8Ll6Xmf+bmb+gHM6s9+mXAHtExPo+JCL2BObqJ9v1F/u0LpSZF2fmezLzIMppCkfWZj+JufuLa+bayDmcBzyipT0/nrLPOa/HdTdGkw+btrqUUnmviojPUXZSXf/Nq+pbxBrKuWE3Uc6T24xycmg//Q64V5S/g3U5cGt1OO13wKOrjvA2yjfYXwHPioiDq/tPY35h8u2Uk9NPioj3UbZvX+A3WU44P5Zy4us1lJNkb6V8W3wm8IJOO57MvCQivgKcUJ3sfzXlZP/7Uq4s7NY/US4J/0E1KvQDymjcQ4B/pIwW/neHZcuIeAvwnoi4gXKi9BLKeTcnZctJzpm5Lsofsnx/dSjpy5RwtQfw2Mx82Ty2p+46ykjFiyPiKsoh3XdS6n7K1yn1fnJEvLJ6/Xex4eKQmXwTeFdE/C3l0O6zKN/Sl8P6k7uPA75AaXfbUDrB+uGrrg6bVqFyW8q5pAC7RcQaymHf66pl3g3snplTJ31/jbLD+XS1fZtQTvA+JzNnu1hBnXkZ5XP/raotX0L5YvsqyuHkp7Ueyu/A5lH+GPciypfbv6L0t1fTfb/7Lcpn+tMR8TJKv/R6Sr87n5PGX0rZiV8YEW+gnCZzO2VU+zXA85l+6syMMnNl1V6Pi4hVlJC7OeW86bfNsPxbgbdW35HPovQvDwT2ycx/nsf21F1B+dz/Q1WunSn9en2k7dOUCxo+FRGvq8r7XjZceDKTbwIvjYgvVK9zFOVQ7ApYf3TrRZRzIK+kBL1HU770A90fNq2+sG1N2TdACZ13A35fBXEi4hPVug+vbd/rKe3lddXzPwh8NjN/183rN9nYjLxV4eMfKX948eeUq+deNY9V3UhpoN+mBLaXUk5W7/cIwGmUIHAm5UTLV1TTj6V0rL+upm8LvL9a/lOU0bMHUU4870pmXkjprO9F2b4fU0LVmmr+Nygn4j+U0vn9hBISVlC7ArFDh1POiTilWs+DgYNy+pWmnZZ7BWVk9aOUOv4B5X14NeXK3bO7XN8HKN8WD6OMGp1Nudq0bTjNzI9Qrlb9m+p1f0Cpp/XBJiKOinn8ukSWq98OoRxuuohy5e47qB12qkLz/6F02udSTqg9jblHJU6gfDP+cFXmbSihaMrtlLD4X5Rw+DXKF4nDmb9XUNrVF6rHJ1eP/762zA7URg2r0dWDKO39bEoQv5jyd7rUo2qHui/lz0t8mPKnhr5OuSjgEZnZ0RefFs+hHL66ghK+DqFcCbpvTr86tJPyJeUL6S8pJ5BfQOkDH9/tuqr1/Z7S33yJ8uXkR5Tw+iLg/1LaVjdeT/lTHy+vnnsmbUawa6//Fsq+54WUKz7PrR5fPrVMlD843vWhzer9eC7lS9YllP75GGr9c2b+mTICtg3lc38y5S8vzHXO4jso7/9nge9QQvRptflTX+ZPoQyWfJ7yvh7d7XbUvJnSP3ykevyN6nH9S/69qxtQAjKlv94U+C7lbwyeCbygh3I0TrQ5d11SlyLinZQOdd8+HBqRNMaq0aTtMnOmP8EkzWqcDptKw3Qw8EKDm6TZRPm7jY9lcq+AVh848iZJktQgY3POmyRJ0iRo/GHTiPgx5dLpy4ZdFkkL4r6U33nc6M8YNI39lzSReu7DGh/eKB3fDtVN0mQYl8/73ZcsWbLDsmXLxmV7JM3h5ptvZs2aNT2tYxzC22WMT0cuabJctmzZsh0e+chHDrsckhbI+eefz4oVK3oabfecN0mSpAYxvEmSJDWI4U2SJKlBDG+SJEkNYniTJElqEMObJElSgxjeJEmSGsTwJkmS1CCGN0mSpAYxvEmSJDWI4U2SJKlBDG+SJEkNYniTJElqEMObJElSgxjeJEmSGsTwJkmS1CCGN0mSpAYxvEmSJDWI4U2SJKlBDG+SJEkNYniTJElqEMObJElSgxjeJEmSGsTwJkmS1CCGN0mSpAYxvEmSJDWI4U2SJKlBDG+SJEkNYniTJElqEMObJElSgxjeJEmSGsTwJkmS1CCGN0mSpAYxvEmSJDWI4U2SJKlBDG+SJEkNYniTJElqkJELbxFxdET8MCJWR8RJwy6PJHXK/kvSQlgy7AK0cQ1wPHAgsPmQyyJJ3bD/kjRwIxfeMvN0gIjYF9hxyMWRpI7Zf0laCCMX3qTZZOas8yNigUoiSd057dRTZ51/yKGHLlBJ1HSNDW8RcSRwJHC/YZdF/TFXMOvXOgx4GrZ6/7V69ephF0d9MFcw69c6DHiCBoe3zDwBOCEizgb2H3Jx1KV+BLV+vraBTgup3n8tXbrU/qth+hHU+vnaBrrJ09jwpmYZZljrRGv5DHOSpgwzrHWitXyGufE3cuEtIpZQyrUYWBwRmwFrMnPNcEumbox6WJuLYU7zYf81HkY9rM3FMDf+Ri68AccCb6w9fi7wJuC4oZRGHWt6YJtNfdsMcpqF/VdDNT2wzaa+bQa58TBy4S0zj8OOrlHGObS1M7W9hji1sv9qnnEObe1Mba8hrtlGLrypGSYtsLXjaJzUTJMW2NpxNK7ZDG/qiqGtPUfjpNFnaGvP0bjmMbypI4a2zhjipNFjaOuMIa45DG+alaFtfgxx0vAZ2ubHEDf6DG9qy9DWH4Y4aeEZ2vrDEDe6DG+axtA2GIY4afAMbYNhiBs9i4ZdAI0Og9vg+R5Lg2FwGzzf49HhyJsMFAvMUTipfwwUC8tRuNHgyNuEM7gNj++91BuD2/D43g+XI28TyuAwGhyFk7pncBgNjsINjyNvE8jgNnqsE6kzBrfRY50sPMPbhDEkjC7rRpqdIWF0WTcLy8OmE8Jg0AweRpU2ZjBoBg+jLhxH3iaAwa15rDOpMLg1j3U2eIa3MWcIaC7rTpPOENBc1t1gedh0TLnjHw8eRtUkcsc/HjyMOjiOvI0hg9v4sU41KQxu48c67T/D25hxJz++rFuNO3fy48u67S/D2xhx5z7+rGONK3fu48867h/D25hwpz45rGuNG3fqk8O67g/D2xhwZz55rHONC3fmk8c6753hTZIkqUEMbw3nCMzksu7VdI7ATC7rvjeGtwZz5y3bgJrKnbdsA/NneGsod9qaYltQ07jT1hTbwvwY3iRJkhrE8NZAjrSolW1CTeFIi1rZJrpneGsYd9KaiW1Do86dtGZi2+iO4a1B3DlrLrYRjSp3zpqLbaRzhjdJkqQGMbw1hCMq6pRtRaPGERV1yrbSGcNbA7gzVrdsMxoV7ozVLdvM3AxvkiRJDWJ4G3GOoGi+bDsaNkdQNF+2ndkZ3kaYO1/1yjakYXHnq17ZhmZmeJMkSWoQw9uIcsRE/WJb0kJzxET9Yltqz/AmSZLUIIa3EeRIifrNNqWF4kiJ+s02tTHDmyRJUoMY3kaMIyQaFNuWBs0REg2KbWs6w5skSVKDGN5GiCMjGjTbmAbFkRENmm1sA8ObJElSgxjeRoQjIlootjX1myMiWii2tcLwJkmS1CCGN0mSpAYxvI0AD2Npodnm1C8extJCs80Z3iRJkhrF8DZkjoBoWGx76pUjIBqWSW97hjdJkqQGMbxJkiQ1iOFtiDxspWGzDWq+Jv2wlYZvktug4U2SJKlBDG+SJEkNsmSuBSJilw7XtS4zL++tOJIkSZrNnOENuAxIIOZYbhWwRc8lmhCea6RRkZlEzPXxljaY5HONNFpOO/VUDjn00GEXY8F1Et5uzcyt5looIv7Uh/JIkiRpFp2c8/aKDtf1ql4KIkmSpLnNGd4y88ROVpSZJ/VcGkmSJM2qq6tNI+IxEXGf6v72EfHxiDgxIrYbTPHGk+e7adTYJtUpz3fTqJnENtntnwr5D2Btdf/dwCaUixlO6GehJEmS1F4nFyzU7ZCZv4+IJcCBwE7A7cA1fS+ZJEmSNtJteLs5IrYFHgD8PDNXRsSmlBE4SZIkDVi34e39wAXApsArq2n7Ab/sZ6EkSZLUXrfnvP1f4HHAfpl5SjXtauCFfS3VGPPEcI0q26bmMoknhqsZJq1tdjzyFhGLgZXAXTJz9dT0zLx0EAWTJEnSxjoeecvMtcClwDaDK44kSZJm0+05bycDZ0TEe4GrKH8mBIDM/FY/CyZJkqSNdRveXlL9f1zL9AR26bk0kiRJmlVX4S0z7zOogkiSJGlu3V5tSkRsEhGPjohnVo+3iIgt+l80SZIkter2t00fSLlo4SPAx6rJ+wMd/Xi9JEmSetPtyNt/Am/IzPsDd1TTzgEe1ddSSZIkqa1uw9uewKeq+wmQmbcCm/ezUOPKP4KqUWcb1Uwm7Y+gqnkmqY12G94uBx5SnxARDwMu61eBImLriPhCRNwaEVdExHP6tW5JGiT7L0kLods/FfJ64KsR8SFg04j4F+Ao4EV9LNMHgduBbYG9q9f7aWZe0sfXkKRBsP+SNHBdjbxl5hnAQcDdKee67QT8bWae2Y/CVFetPh14fWauzMxzgS8Dz+vH+iVpUOy/JC2UrkbeIuKQzDwNeGnL9Gdk5uf6UJ7dgLUtv5f6U8oVra1lORI4ErhfH15Xkno1r/5r9erVrbMlaVbdnvP2sRmmn9BrQSpbAje1TLsJ2Kp1wcw8ITP3BS7s02tLUi/m1X8tXbp0IcomaYx0NPIWEVM/fbUoIu4DRG32LsBtfSrPSmBZy7RlwC19Wr8kDYr9l6QF0elh08sofxokgN+0zFvOxr91Ol+XAksiYtfM/HU1bS/Ak30ljTr7L0kLoqPDppm5KDMXA9+p7tdv98zMvhw2rf5m3OnAm6uf3doPeCrwyX6sf9giYu6FpCGyjc7fuPdfhxx66LCLIM1qktpot1eb7g8QEfeKiL8cTJF4KeWP/l4HfAZ4iZfZS2oI+y9JA9ft1ab3Ak6h/P2iBLaMiGcAT8zMF/ajQJm5AnhaP9YlSQvJ/kvSQuj2atMTgK9Srp6a+m3Ts4DH97NQkiRJaq/bX1h4GHBwZq6LiKnfNr0pIu7c/6JJkiSpVbcjb38A7lufEBF7AL/vW4kkSZI0o27D27uAMyLi7yiXxD8b+Czwjr6XTJIkSRvp6rBpZp4YESsoP+tyJfB8yu/4fXEQhZMkSdJ03Z7zRhXUDGuSJElD0HV4i4hHA/tQfsdvvcx8a78KNc4igswcdjGkjfgHejWXQw49lNNOPXXYxZA2Mkl/oBe6/ztv7wcOBb4DrKrNMo1IkiQtgG5H3g4DHpCZ1wyiMJIkSZpdt1ebXgmsHkRBJEmSNLduR95eAHwkIj5D+Ztv62Xmt/tWKkmSJLXVbXh7CHAQ8FdsfM7bvftVqHHnRQsaNV6soE550YJGzaRdrADdh7e3Ak/JzG8OojCSJEmaXbfnvN0KeHhUkiRpSLoNb28A/j0itouIRfXbIAonSZKk6boNXScCRwFXA3dUtzXV/+qC5xhpVNgW1a1JPMdIo2lS22K357zdZyClkCRJUke6/WH6KwZVEEmSJM1tzsOmEfGWTlYUEW/qvTiSJEmaTSfnvL0yIu4TEbvMdgNePujCjhvPNdKw2QY1X5N6rpFGxyS3wU4Om24BXAbM1cvf1ntxJEmSNJs5w1tm+mdAJEmSRoTBbMg8bKVhse2pV5N82ErDNeltz/AmSZLUIIa3EeAIiBaabU79MukjIFp4tjnDmyRJUqMY3iRJkhrE8DYiPIylhWJbU795GEsLxbZWGN4kSZIaxPA2QhwR0aDZxjQojoho0GxjGxjeJEmSGsTwNmIcGdGg2LY0aI6MaFBsW9MZ3iRJkhrE8DaCHCFRv9mmtFAcIVG/2aY2ZniTJElqEMPbiHKkRP1iW9JCc6RE/WJbas/wJkmS1CCGtxHmiIl6ZRvSsDhiol7ZhmZmeBtx7nw1X7YdDZs7X82XbWd2hjdJkqQGMbw1gCMo6pZtRqPCERR1yzYzN8NbQ7gzVqdsKxo17ozVKdtKZwxvkiRJDWJ4axBHVDQX24hGlSMqmottpHOGt4Zx56yZ2DY06tw5aya2je4Y3hrInbRa2SbUFO6k1co20T3DmyRJUoMY3hrKkRZNsS2oaRxp0RTbwvwY3hrMnbZsA2oqd9qyDcyf4a3h3HlPLuteTefOe3JZ970xvEmSJDWI4W0MOAIzeaxzjQtHYCaPdd47w9uYcGc+OaxrjRt35pPDuu4Pw9sYcac+/qxjjSt36uPPOu4fw9uYcec+vqxbjTt37uPLuu0vw9sYcic/fqxTTQp38uPHOu2/JcMugAZjamefmUMuiXphaNMkmtrZn3bqqUMuiXphaBscR97GnDv/5rLuNOnc+TeXdTdYhrcJYAhoHutMKgwBzWOdDZ6HTSeEh1GbwdAmbczDqM1gaFs4jrxNGMPB6LJupNkZDkaXdbOwDG8TyJAweqwTqTOGhNFjnSw8D5tOKA+jjgZDm9Q9D6OOBkPb8DjyNuEMD8NnQ/xGAAAWA0lEQVTjey/1xvAwPL73w+XImxyFW2CGNql/HIVbWIa20eDIm9YzVAye77E0GIaKwfM9Hh2OvGkaR+EGw9AmDZ6jcINhaBs9hje1ZYjrD0ObtPAMcf1haBtdhjfNyhA3P4Y2afgMcfNjaBt9hjd1xBDXGUObNHoMcZ0xtDWH4U1dMcS1Z2iTRp8hrj1DW/MY3jQv9bAyqUHOwCY1Uz2sTGqQM7A1m+FNPZu00ThDmzQ+Jm00ztA2Hgxv6ptxHo0zsEnjbZxH4wxs48fwpoFoDTtNC3OGNWlytYadpoU5w9r4G5nwFhFHA0cADwQ+k5lHDLVA6qtRD3OGNfXKPmx8jXqYM6xNnpEJb8A1wPHAgcDmQy6LBqxdWFqoQGdQ04DYh02IdmFpoQKdQU0wQuEtM08HiIh9gR2HXBwNQSehaq6AZzDTsNiHTbZOQtVcAc9gpk6NTHjrVkQcCRwJ3G/YZdHCMZxpHNT7r9WrVw+7OFoghjP1y6JhF2C+MvOEzNwXuHDYZZGkbtT7r6VLlw67OJIaZkHCW0ScHRE5w+3chSiDJM2XfZikUbIgh00z84CFeB1JGgT7MEmjZGTOeYuIJZTyLAYWR8RmwJrMXDPckknS3OzDJC2UUTrn7VhgFfBa4LnV/WOHWiJJ6px9mKQFMTIjb5l5HHDckIshSfNiHyZpoYzSyJskSZLmYHiTJElqEMObJElSgxjeJEmSGsTwJkmS1CCGN0mSpAYxvEmSJDWI4U2SJKlBDG+SJEkNYniTJElqEMObJElSgxjeJEmSGsTwJkmS1CCGN0mSpAYxvEmSJDWI4U2SJKlBDG+SJEkNYniTJElqEMObJElSgxjeJEmSGsTwJkmS1CCGN0mSpAYxvEmSJDWI4U2SJKlBDG+SJEkNYniTJElqEMObJElSgxjeJEmSGsTwJkmS1CCGN0mSpAYxvEmSJDWI4U2SJKlBDG+SJEkNYniTJElqkMjMYZehJxFxFbDDsMshaWFlZgy7DL2KiKuWLFmyw7Jly4ZdFEkL5Oabb2bNmjVXZ+aO813Hkn4WaEiur/6/bKil6Mz2wLXDLsSY8T3trya8n/dlw+e+6a5fs2YNK1assP+aTL6n/deE97TnPqzxI29NEhE/zMx9h12OceJ72l++n5qJbaP/fE/7b1LeU895kyRJahDDmyRJUoMY3hbWCcMuwBjyPe0v30/NxLbRf76n/TcR76nnvEmSJDWII2+SJEkNYniTJElqEMObJElSgxjehiAijo6IH0bE6og4adjlaaKI2DoivhARt0bEFRHxnGGXqclsk+qUbaV39l/9NYltchx+YaGJrgGOBw4ENh9yWZrqg8DtwLbA3sBXI+KnmXnJcIvVWLZJdcq20jv7r/6auDbpyNsQZObpmflF4I/DLksTRcQWwNOB12fmysw8F/gy8Lzhlqy5bJPqlG2lN/Zf/TeJbdLwpibaDVibmZfWpv0U2HNI5ZGkTtl/qWeGNzXRlsBNLdNuArYaQlkkqRv2X+qZ4a3PIuLsiMgZbucOu3xjYiWwrGXaMuCWIZRFGhv2XwvC/ks984KFPsvMA4ZdhglwKbAkInbNzF9X0/YCPNlX6oH914Kw/1LPHHkbgohYEhGbAYuBxRGxWUQYpDuUmbcCpwNvjogtImI/4KnAJ4dbsuayTapTtpXe2H/13yS2ScPbcBwLrAJeCzy3un/sUEvUPC+lXBJ+HfAZ4CVeZt8T26Q6ZVvpnf1Xf01cm/SH6SVJkhrEkTdJkqQGMbxJkiQ1iOFNkiSpQQxvkiRJDWJ4kyRJahDDmyRJUoMY3iRJkhrE8CZJktQghjdJkqQGMbxJkiQ1iOFNkiSpQQxvkiRJDWJ4kyRJahDDmyRJUoMY3iRJkhrE8CZJktQghjdJkqQGMbxJkiQ1iOFNkiSpQQxvkiRJDWJ4kyRJahDDmyRJUoMY3iRJkhrE8CZJktQghjdJkqQGMbxJkiQ1iOFNkiSpQQxvkiRJDWJ4kyRJahDDmyRJUoMY3iRJkhrE8CZJktQghjdJkqQGMbxJkiQ1iOFNkiSpQQxvkiRJDWJ4kyRJapAlwy5AryLi34G9h10OSQvqJ5n5ymEXolf2X9LE6qkPa3x4o3R8+wNEbeJc9+czfxDrbMr8US7b1IRo+Z/YML/dcjNNH9T8wfwf1QtW/8eijaeN2f/nnPNtxsjewP6x5XZMbV9MNZz19zc0rPXzWpcliNp7FNH6PNY/jto/09vq1LrmWGb9/Y2Xidp6ovZ4w/xYP716ZrXM1LTOH097vfX3N7zOVPE2vNZMz2/Zhtpzalu8YZvZ8D/Tlm2ZX3+/W5bdMC0hq/+nlsncMA+g/njasi2Ps7aOafOympVlmfr99c/bMD1nmD5t+dr9nLYM054/bV3JhmWzXqap9cywXG36+m2Ztkz9NdvcX1+Eje9Pe836NrDhNvVaWSvG9Hkb5tefu/7dnypr7XnXsppejUN4A2Ax5RhwzPL/1P1OH3f6f7frne/rDOv5i4f42rO+dwGLFkFUt0WLNjzu9v+Znt+6bLfPn/qfgdwWw6Il029LNtt42pjdDvjrx3HOOecwLmKL7dhktycTixZvuC1ezKL640WLNpo/dX/6cotZtGTTafPLMkEsKqFu/f1FwaKo3V8UpS3PtUxE1bY3XufiNrcl0x4vmj4/ZlpujluUci2OUo7Wx+vvV+vf+DEbnrOomt7yOAIWVaFuUbDxY+rLVe/b+uVqj5l6fmz0vFi3lsh1kOuqvfy62uPqtm7dnMtEtVzb+evWkuvK/6xbS65dW5Zdt5ZcV+5nNY9166r5azd+3izryHXryLXVrXZ/3dqN561bO8Oy6++vbVlHfbmsHifr1mZtWlbryA3LrM3Zl1+3rppWPXdq+UzWZrI22ej/29e1n17/fx2zz1+b8GWW9xzgFvXc80iSJGnBGN4kSZIaxPAmSZLUIIY3SZKkBjG8SZIkNYjhTZIkqUEMb5IkSQ1ieJMkSWoQw5skSVKDGN4kSZIaZGx+HmstsK72OOa4P5/5g1hnU+aPZNkSolbxk/fbptXGxx3ViwXELRvuj+n/Y/bbpuSty7nj0jOY2j5/27Szx9Neb/39Da8zVTx/29TfNi2r8LdNR81PgO2Ba7M2MWdYeAxtD1w77EIM0fZktf0TVOmV7SGvncQNB9YMuwB98hNg+1y5fP1neAJrc5L7MLd9cvXUh0Vm87uKiPhhZu477HIMwyRvO0z29rvt47Ht47Qt8zHJ2++2T+a2Q+/b7zlvkiRJDWJ4kyRJapBxCW8nDLsAQzTJ2w6Tvf1u+3gYp22Zj0nefrd9cvW0/WNxzpskSdKkGJeRN0mSpIlgeJMkSWoQw5skSVKDjGR4i4itI+ILEXFrRFwREc+ZYbmIiHdExB+r2zsjan8bO2LviLgwIv5c/b/3wm3F/HWx/a+JiIsj4paI+F1EvKZl/uURsSoiVla3MxdmC+avi20/LiLuqG3byojYpTZ/3Ov+6y3bfntEXFSb38S6PzoifhgRqyPipDmWfVVELI+ImyLixIhYWpu3c0T8b1X3v4yIxw288F2IiLMj4rZa3fxqlmVn7eOaJCKWRsTHqnZ9S0T8OCIOmmX5IyJibUs7P2ABi9yzfu3Lmqib+h6Hum7V6ed8vnU/kuEN+CBwO7AtcBjwnxGxZ5vljgSeBuwFPAh4MvBigIjYFPgS8CngrsDHgS9V00ddp9sfwOGU7XsicHREPKtlmadk5pbV7QmDLHSfdLrtAJ+tbduWmflbmIy6z8yD6tsOnA+c1rJY0+r+GuB44MTZFoqIA4HXAo8FdgZ2Ad5UW+QzwI+BbYDXAZ+LiLsPoLy9OLpWN/ebZbkZ+7gGWgJcCewP3Bl4PXBqROw8y3O+2/IZP3vgpeyvnvdlDdZtfTe9rtvp5HM+v7rP6vfHRuUGbEFp7LvVpn0SeHubZc8Hjqw9fgHwver+E4Crqa6orab9HnjisLexX9vf5rnvA95fe3w58Lhhb9OA6v444FMzrGei6p4SYNYC92lq3bdsz/HASbPM/zTw1trjxwLLq/u7AauBrWrzvwMcNeztqpXnbOCFHS47Yx83DjfgZ8DTZ5h3BHDusMvYw7b1ZV82TreZ6rvpdT3Dtnb0OZ9v3Y/iyNtuwNrMvLQ27adAu28re1bz2i23J/CzrN6Nys9mWM8o6Wb716uGWR8NXNIy6+SIuD4izoyIvfpb1L7rdtufEhErIuKSiHhJbfpE1T1l9PU7mfm7lulNqvtutPvcbxsR21TzfpuZt7TMH7W6f1tE3BAR581xeGi2Pq7RImJbSptv7bPq9qnep0sj4vUR0aTf4+7XvmwsdFDfTa7rmXTyOZ9X3Y9ieNsSuKll2k3AVh0sexOwZRVkulnPKJlvuY+j1Od/1aYdRhmV2Qn4X+AbEXGXvpRyMLrZ9lOB3YG7Ay8C3hARz57HekbJfMt9OHBSy7Sm1X032n3uobxPTaj7f6Yc6t2B8oc6vxIRfzHDsrP1cY0VEZsAJwMfz8xfzrDYt4EHAPcAng48G3jNDMuOon7tyxqvg/puel230+nnfF51P4rhbSWwrGXaMuCWDpZdBqysRly6Wc8o6brcEXE0ZQd+cGaunpqemedl5qrM/HNmvg24kTI6N6o63vbM/HlmXpOZazPzfOC9wDO6Xc+ImU/dPwrYDvhcfXoD674b7T73UN6nodZ9dZJyznA7FyAzv5+Zt2Tm6sz8OHAe8KQZVjlbHzdSOtn2arlFlMOHtwNHz7S+zPxtZv4uM9dl5kXAm9nwGW+Cfu3LGq2T+h6Dut5IF5/zedX9KIa3S4ElEbFrbdpetB9qvaSa1265S4AHtaTXB82wnlHSzfYTEX9PdfJ2Zl41x7qTcpHDqOpq21vUt20i6r7yfOD0zFw5x7pHve670e5z/4fM/GM1b5eI2Kpl/oLUfWYekJkxw+1RMz2Nmetmtj5upHSy7dVn8mOUE/ifnpl3dPMSNKsN92tf1lg91HfT6roTM23T/Op+2Cf1zXAC3ymUK8a2APajDCPu2Wa5o4BfUIYl71lt8FHVvE2BK4BXAEspif8KYNNhb18ft/8wYDmwe5t5966euymwGWUI+npgm2FvX5+2/amUK0kDeBjlAoXnT0rdV8tuThlR++sxqfslVXnfRvmmvhmwpM1yT6za/R5VG/gWtZPAge8B76qe/zfVe3T3YW9fVba7AAdObVv1Gb4VuN8My8/YxzXxBnyoqp8tO1j2IGDb6v79gYuBNw57G7rc3p73ZU2+dVrf41DXLdvT8ed8vnU/9I2cYcO3Br5YbezvgedU0x9NGU6cWi6AdwIrqts7mX6F4T7AhcAq4EfAPsPetj5v/++AOyjDrlO3D1Xz9qScpH8r8Efgf4B9h71tfdz2z1TbtRL4JfDylvWMdd1X055NCaXRMr2pdX8c5dtp/XYcJYyuBO5dW/YfgT8AN1PO81xam7cz5UqvVcCvGKGrbinnaF5AOXR2I2XH9vja/K76uCbdKOdfJnBbS591WDV/Wj1TAvgfqnb8W8qhtE2GvR1dbnNf9mVNvM1W3+NY1y3bPuPnvF917w/TS5IkNcgonvMmSZKkGRjeJEmSGsTwJkmS1CCGN0mSpAYxvEmSJDWI4U2SJKlBDG8aOxFxWEScOexySJJGV0QcHRE/jIjVEXHSANa/suW2NiLe3491G940UBFxeUSsamnA9+zj+neufjtxydS0zDw5M5/Qr9eQpH6qfgf2hcMuh7gGOB44cRArz8wtp26UnwhbBZzWj3Ub3rQQnlJvxJl5TX1mPXhJkmYXEYuHXYZxkJmnZ+YXKb9EM01EPDkifhIRN0bE+RHxoB5f7hnAdcB3elwPYHjTENRGy14QEb+n/DYlEXFaRCyPiJsi4tsRsWftOZtHxLsj4opq/rkRsTnw7WqRG6tRvUdExBERcW7tuY+MiAuq510QEY+szTs7It4SEedFxC0RcWZE3G2B3gpJDVIdSXhNRPwsIm6NiI9FxLYR8fWq//hmRNy1WvYvq53+jRHx04g4oJr+b5SfSPpA1Wd9oJp+/4g4KyJWRMSvIuLQ2uueFBH/GRFfi4hbgcdExJMi4ufV614dEccs/DsyniLiwZTRuBcD2wAfBr4cEUt7WO3zgU9kn37WyvCmYdof2J3yA74AXwd2Be5B+T3Sk2vLvgt4CPBIyu8F/hOwDvirav5dqlG979ZfICK2Br4KvI/yIXwP8NWI2Ka22HOAv6ted1PATlDSTJ4OPB7YDXgKpd/6V+BulH3qyyNiB0q/czylvzoG+HxE3D0zX0cZfTm66rOOjogtgLOAT1P6oWcD/1H/Akvpp/4N2Ao4F/gY8OLM3Ap4ANWXYPXFi4APZ+b3M3NtZn4cWA385XxWFhH3puzvPt6vAhretBC+WH37vDEivlibflxm3pqZqwAy88TMvCUzV1N+kHyviLhzRCwC/h54RWZeXX2Yzq+Wm8vBwK8z85OZuSYzP0P5Ifun1Jb5r8y8tCrHqcDefdhmSePp/Zn5h8y8mhLCvp+ZP676oy8A+wDPBb6WmV/LzHWZeRbwQ+BJM6zzycDlmflfVT/1I+DzlENtU76UmedV67sNuAPYIyKWZeafqueoP3YCXl3bb90I3Au4J6w/YpMz3M5ts77DgXMz83f9KqDhTQvhaZl5l+r2tNr0K6fuRMTiiHh7RPwmIm4GLq9m3a26bQb8Zh6vfU/gipZpVwA71B4vr93/M7DlPF5H0mT4Q+3+qjaPt6Ts/A9p2fk/Cth+hnXuBDy8ZfnDgO1qy1zZ8pynU8LgFRFxTkQ8Yv6bpBZXAv9W22/dJTPvVH35JzMPyMyY4faoNus7nD6OuoHhTcNVP/b/HOCpwOOAOwM7V9MDuAG4DfiLOdbRzjWUjrHu3sDVXZZVkjp1JfDJlp3/Fpn59mp+a791JXBOy/JbZuZLastMe05mXpCZT6UcZv0i5aiBuhARSyJiM2AxsDgiNqsuoPsIcFREPDyKLSLi4IjYah6v8UjKYEFfrjKdYnjTqNiKck7BH4E7AW+dmpGZ6ygnj74nIu5ZjdI9ojp59HrKuW+7zLDerwG7RcRzqg/qM4E9gDMGuC2SJtungKdExIFVf7VZRBwQETtW8//A9D7rDEo/9byI2KS6PTQidm+38ojYNMrfs7xzZt4B3AysHegWjadjKaOlr6Uc6l4FHJuZP6Sc9/YB4E/AZcAR83yN5wOnZ+YtPZe2xvCmUfEJyuHMq4GfA99rmX8McBFwAbACeAewKDP/TDmJ97zqcMO0E0oz84+U80leTQmG/wQ8OTNvGOC2SJpgmXkl5UjCv1K+YF4JvIYN+9z3As+IiD9FxPuqHfsTgGdRjhYsp/Rxs13d+Dzg8uo0k6Mo4UNdyMzj2hz2PK6a99+Z+dBqFHT7zDxkPgEsM1+cmc/rd9mjT1etSpIkaQE48iZJktQghjdJkqQGMbxJkiQ1iOFNkiSpQQxvkiRJDWJ4kyRJahDDmyRJUoMY3iRJkhrk/wN+Z1EXdauGygAAAABJRU5ErkJggg==\n", + "text/plain": [ + "
" + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], + "source": [ + "optic = poppy.CircularAperture(radius=1)\n", + "optic.display(what='both');" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "### SquareAperture\n", + "A square stop. The specified size is the length across any one side. " + ] + }, + { + "cell_type": "code", + "execution_count": 4, + "metadata": {}, + "outputs": [ + { + "data": { + "image/png": "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\n", + "text/plain": [ + "
" + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], + "source": [ + "optic = poppy.SquareAperture(size=1.0)\n", + "optic.display(what='both');" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "#### RectangularAperture\n", + "Specify the width and height to define a rectangle." + ] + }, + { + "cell_type": "code", + "execution_count": 5, + "metadata": {}, + "outputs": [ + { + "data": { + "image/png": "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\n", + "text/plain": [ + "
" + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], + "source": [ + "optic = poppy.RectangleAperture(width=0.5*u.m, height=1.0*u.m)\n", + "optic.display(what='both');" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "### HexagonAperture\n", + "For instance, one segment of a segmented mirror." + ] + }, + { + "cell_type": "code", + "execution_count": 6, + "metadata": {}, + "outputs": [ + { + "data": { + "image/png": "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\n", + "text/plain": [ + "
" + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], + "source": [ + "optic = poppy.HexagonAperture(side=1.0)\n", + "optic.display(what='both');" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "### MultiHexagonAperture\n", + "Arbitrarily many hexagons, in rings. You can adjust the size of each hex, the gap width between them, and whether any hexes are missing (in particular the center one). " + ] + }, + { + "cell_type": "code", + "execution_count": 7, + "metadata": {}, + "outputs": [ + { + "data": { + "image/png": "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\n", + "text/plain": [ + "
" + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], + "source": [ + "optic = poppy.MultiHexagonAperture(side=1, rings=1, gap=0.05, center=True)\n", + "optic.display(what='both');" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "### NgonAperture\n", + "Triangular apertures or other regular polygons besides hexagons are uncommon, but a generalized N-gon aperture allows modeling them if needed. " + ] + }, + { + "cell_type": "code", + "execution_count": 8, + "metadata": {}, + "outputs": [ + { + "data": { + "image/png": "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\n", + "text/plain": [ + "
" + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], + "source": [ + "optic = poppy.NgonAperture(nsides=5)\n", + "optic.display(what='both');" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "### SecondaryObscuration\n", + "This class adds an obstruction which is supported by a regular evenly-spaced grid of identical struts, or set `n_supports=0` for a free-standing obscuration." + ] + }, + { + "cell_type": "code", + "execution_count": 9, + "metadata": {}, + "outputs": [ + { + "data": { + "image/png": "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\n", + "text/plain": [ + "
" + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], + "source": [ + "optic = poppy.SecondaryObscuration(secondary_radius=1.0, \n", + " n_supports=4, \n", + " support_width=5*u.cm)\n", + "optic.display(what='both');" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "### AsymmetricSecondaryObscuration\n", + "This class allows making more complex \"spider\" support patterns than the SecondaryObscuration class. Each strut may individually be adjusted in angle, width, and offset in x and y from the center of the aperture. Angles are given in a convention such that the +Y axis is 0 degrees, and increase counterclockwise (based on the typical astronomical convention that north is the origin for position angles, increasing towards east.) " + ] + }, + { + "cell_type": "code", + "execution_count": 10, + "metadata": {}, + "outputs": [ + { + "data": { + "image/png": "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\n", + "text/plain": [ + "
" + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], + "source": [ + "optic = poppy.AsymmetricSecondaryObscuration(secondary_radius=0.3*u.m, \n", + " support_angle=(40, 140, 220, 320),\n", + " support_width=[0.05, 0.03, 0.03, 0.05], \n", + " support_offset_x=[0, -0.2, 0.2, 0],\n", + " name='Complex secondary')\n", + "optic.display(what='both');" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "### ThinLens\n", + "This models a lens or powered mirror in the thin-lens approximation, with the retardance specified in terms of a number of waves at a given wavelength. The lens is perfectly achromatic. " + ] + }, + { + "cell_type": "code", + "execution_count": 11, + "metadata": {}, + "outputs": [ + { + "data": { + "image/png": "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\n", + "text/plain": [ + "
" + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], + "source": [ + "optic = poppy.ThinLens(nwaves=1, reference_wavelength=1e-6*u.m, radius=10*u.cm)\n", + "optic.display(what='both');" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "### GaussianAperture\n", + "This Gaussian profile can be used for instance to model an apodizer in the pupil plane, or to model a beam launched from a fiber optic. " + ] + }, + { + "cell_type": "code", + "execution_count": 12, + "metadata": {}, + "outputs": [ + { + "data": { + "image/png": "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\n", + "text/plain": [ + "
" + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], + "source": [ + "optic = poppy.GaussianAperture(fwhm=1*u.m)\n", + "optic.display(what='both');" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "#### KnifeEdge\n", + "A knife edge is an infinite opaque half-plane." + ] + }, + { + "cell_type": "code", + "execution_count": 13, + "metadata": {}, + "outputs": [ + { + "data": { + "image/png": "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\n", + "text/plain": [ + "
" + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], + "source": [ + "optic = poppy.optics.KnifeEdge(rotation=0)\n", + "optic.display(what='both');" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Image Plane Elements\n", + "Image plane classes have dimensions specified in units of arcseconds projected onto the sky. These classes can be placed in image planes in either Fraunhofer or Fresnel optical systems. " + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "### SquareFieldStop" + ] + }, + { + "cell_type": "code", + "execution_count": 14, + "metadata": { + "scrolled": false + }, + "outputs": [ + { + "data": { + "image/png": "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\n", + "text/plain": [ + "
" + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], + "source": [ + "optic = poppy.SquareFieldStop()\n", + "optic.display(what='both');" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "### RectangularFieldStop\n", + "\n", + "This class can be used to implement a spectrograph slit, for instance." + ] + }, + { + "cell_type": "code", + "execution_count": 15, + "metadata": {}, + "outputs": [ + { + "data": { + "image/png": "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\n", + "text/plain": [ + "
" + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], + "source": [ + "optic = poppy.RectangularFieldStop()\n", + "optic.display(what='both');" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "### AnnularFieldStop\n", + "You can also use this as a circular field stop by setting `radius_inner=0`." + ] + }, + { + "cell_type": "code", + "execution_count": 16, + "metadata": {}, + "outputs": [ + { + "data": { + "image/png": "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\n", + "text/plain": [ + "
" + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], + "source": [ + "optic = poppy.optics.AnnularFieldStop(radius_inner=1, radius_outer=3)\n", + "optic.display(what='both');" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "### HexagonFieldStop" + ] + }, + { + "cell_type": "code", + "execution_count": 17, + "metadata": {}, + "outputs": [ + { + "data": { + "image/png": "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\n", + "text/plain": [ + "
" + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], + "source": [ + "optic = poppy.optics.HexagonFieldStop()\n", + "optic.display(what='both');" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "### CircularOcculter" + ] + }, + { + "cell_type": "code", + "execution_count": 19, + "metadata": {}, + "outputs": [ + { + "data": { + "image/png": "iVBORw0KGgoAAAANSUhEUgAAAm8AAAGHCAYAAADmybX6AAAABHNCSVQICAgIfAhkiAAAAAlwSFlzAAALEgAACxIB0t1+/AAAADl0RVh0U29mdHdhcmUAbWF0cGxvdGxpYiB2ZXJzaW9uIDIuMi4yLCBodHRwOi8vbWF0cGxvdGxpYi5vcmcvhp/UCwAAIABJREFUeJzt3Xm8JGV97/HPb2bYZABFVkFFEURQQNBr3CIaFHfNNXoRRTFuaDAxLokajURJNN5cb+IevRoXXAJGxQUVNxA0IKCIoogojICD4sLAIIw487t/PM+Zqek5S/c5fU73c87n/XrVTHfV01XPU8vT366qPh2ZiSRJktqwbNQVkCRJUv8Mb5IkSQ0xvEmSJDXE8CZJktQQw5skSVJDDG+SJEkNMbyNkYh4Y0R8f9T1mA8RsXNEfCYiboiIjIg9Rl2nxaSVfSciHlm3/y6jrovGV0TcMSK+EhE3RYR/z2rIIuL9EfHlUddjJhFxXET8YdT1GEfNhbfa8U83XDnqOs7BScBDJp5ExEkRcWlvoYi4OiJesaA1m7sXAYcC9wf2BH452upoHETEkYb58RARu0fEWyPiyoj4fURcFxEfj4hDe8od19Pn/iIiPhsR9+qUObMz/daI+GVEnBURL4mI7fqozquA3Sh9xp7DbalaFRFPN8wXzYU3yoE8MTyhjvsfnXH3nexFEbH1gtRuDjJzbWb+etT1mCf7ARdn5iWZeW1mbpjNTFrYjhoN943Zi4g7AhcADwBeANwNeAxwK3BuRDyy5yXr2dTnPpEStL4YETt1ynykTt8HeDjwceClwLcjYrcZqrQf8K3M/HFmXjuHdrlPaFLN7xuZ2ewAPAhIYJ9Jpl0LvBZ4N/Ab4Ow6/mXAxcBNwM+Bk4HdOq97ZJ3nQ4FvADcD3wMe2ikTdd5XAusoZ5E+D6yo098IfB94GvDTuqxTge2Bo4EfAzcAHwNWdub7RuD79fHxtR7d4RXAuZOM3wPYCnhvXd7NwE+AfwC26p0/8GTgMmAt8GXgzj3r7n7AGcCNdTgXOKwz/dF13M3A1cB7gNtNs52u7anvF+r429Y6/wq4BTivZz0fUMv/r1qf3wEnTbGMjwGf7Rn3HOCWQdpf1/ta4Ajgu3WZ5wGHdMoMsq4H2gfqa4+l7KO3AFcAbwK260y/DfD/6ut/A7wF+D8T+84022HvWoc1tV1f6barlrk78Engt7XMRcAj+tk36Oy/nfJH1m24R8/xtUtn+26xb/S5Hs4F3lmXey1w1aj7pFYH4NN1He44ybTT67Tt6vPjgD/0lHlg3X5H1ednAv9vin3wt8D7pqlL7z7x/jp+z3q8XF+PuzOB+3Red0Qt/xjgnLrfnDDFMraoH/Bq4MrO8/dT+ofnAavq8XYasGunzInA5ZQTCZdSjvOvAft2ytyO8j7zs1rvH1FCbEyyrBdR+tS1lGN8K0qftKqut3cDW/fU+0V12bdQ+pW/o74XdZb/n7Vuv6Bc4fkA8OUZ9om7A5+rdVkLfAa4W0+Zw4Ev1HWzFvgWcL/O9COBsyl9yRrgrIl1M9Hmnvk9HcjO8437Wmf7brFv9Lkerqxtfwfwa+D8UR93czpmR12BOVV+5vB2Q92A+wH3qONfAjwMuAulw/kW8MXO6ybeXC6kfFrcn9Jh/Ir6JgscUw+kRwN3Au5d59sNb2uBTwH3qsv7bd3JP13HHVF3oH/oLLsb3rYD/m/dCfeow/bAzpTQeVJn/DJgW0qAuC/lk+6fAtcBr+yZ/431gLw3cBglYHTbf29KB/NByoG5PyWA3LdOfxSlE5j4dH4/Skd5xjTbade6Lr5U63u7Ov4zlOBzJHAg5Y34FuCudfrEm/sqSuC5y2TbupbtN7zN1P7jKWcbzqSchTiQ0hn/EFhWy/S7rmezDxxP2deOAe5K+RDxA+A9nTLvBFYDjwXuQQlvNzBNeKv7yEVsOrtyMCWkXQfctpbZuy7785TL2/sC/5Ma3vrYNwYNb8spQTrr+ujuG/2sh3Pr9nxLXQ/3GnWf1OJAeXNfD7x6iukPrtvo8fX5cWwZ3g6rZR5bn5/JJOGtTnsb5Y182RTT9wC+CXy4Pt6J8oH5vLoPP6juL/9Zj6ld6uuOqHW4FHg8pb/Ye4plbFE/Jg9va4CPAvesx80q4AOdMidS+sMv1GPiEOA7wFk97fnbuo7uQgkoa4FnTbKsD9R9+fGUvvD0erwdSDnebwZe0LP8VZQ+6C6U96SfAa/vlPkkJWA+DDiIEiRvYJrwRnn/WUX5gHd4Hb5W57N1LXNQbftHgftQ3mefCty/Tj+y7lf/WtfLAcCzgQM6bR4kvG0N/AWbTljsAew0wHq4srb7RErfdeCoj705HbejrsCcKj9zePtcH/O4f53H7evziTeXR3fK7FPHPaQ+fyXlTX/FFPN8Yz3wbtsZ917g93TOUAH/DpzT87rvd56fBFw6yfyvBl7RR9teCXyvZ/7reupwHCWsLK/PTwXOp/OpsGee5wIn9ozbv66fA6apy2bhqh74CTysMy6AS4B31OcT4e3lfbS13/A2U/snznge2ClzRB135wHX9UD7QG3/auC4nnk/AthAOeN221rfY3vW2/eYPrw9ps7jbp1xt6EEpL+pz/83cBWw7RTzmGnfGCi8TTa93/XQ2Re/P1V9HPobKLedJPCnU0zfuXsc0hPeKB/OPkMJH7vVcWcydXibOMZ2m6ZOm70e+JNJjstt6n7y9/X5xHF67HTtnap+TB7ergO26Yx7BbC68/xE4A9sfjbu6LqfTnoc1TL/BnypZ1m/pHNWjfIh81c9yz8N+Hh9fBvKGa1H9sz7GcD19fHd6jp5eGf61sA1TB/enl3nvUtn3O6U8PiM+vxDlKsTU4Xws+npk3umv7+3DkwT3iab3u96qM+vBL6y0MfXfA0rWNy+1TsiIo6kfAo6gPJGOHHf350pZ0EmXNR5fE39f/f6/0eBFwJXRsQZlNPdp2XmTZ3XrMrM6zvPJy7r/LZn3EMHatE0IuKFwLMobbkNsIISFrpW9dThmlru9pTO43DgY1n39p75R51+aES8bJIq7Ef51NuPgygd3DkTIzIzI+LsOq1ri+04BzO1H0rA+2FPGSjbfxUMtK4H2Qf2pnyafEdEvK1TJuqwL+UT8QrKmQlg43r7BuXDzFQOAn6emZd3Xve7iLiATev7cMrtBbdMMY8p940h62c9fK+OO38B6rPYxQzTJ1u/yyNibX28PeW4/7PM7OeLSBPLG2S7HQT8OjN/sLFSmesi4jzmt7/4YWau6zy/hk3vAxN+npnX9ZQJyn2AP4uIZcDfUELd3pQz91tR+5KeZXX7kGuBH/Us/1rKmTko7d4O+K+em/iXA9tGxK6UM3aweX/x+4g4H1g5dbM5CPhBZv6q87pfRMSP2Ly/+EJOff/y4ZSwO99mXA+d7TPMfWOkFnt464YpIuJuwGcp9xK8lhLW9qV8wum9ebF7EE3sEMsAMvPKiNiPchr6YcDrgDdGxP0yc3Ute2vP/HKKcUP50khEHAu8mdJJfINyevjplKDa1RswNmtbz7gtFlPLvRY4ZZLpqycZN6iYZPk3TVawxwa2fBPaapJy/bT/Dz2BYLMyA6zrQfeBif+Pp9PZdlxF+fZdt06DmOw1vet7pvlON73fbTCTftbDhH72DU3vx5Rtd0/KJbZe96z//6gzbj1lX0zgl5l54wDLuyflvrVBv5zVz/4L899f9L5upj7lpZQz8y8Bvk251P/XlLPhXbPtLybu4e31m0nqOojW+ovp1sOERdNftPht07m4H2XneHFmfjMzf0T5hD+wzLwlM0/PzJdR7r/YhXJPwjD9nvLpoZ/xfwycl5lvycwLM/PHlGv/g7oQeEQ9y7aZ+gnr25RLF5dPMgxyYFxC2f82ni2qy3xgnTaoXwJ36Bl32Czm049hreteV1Hasf8U63cdpXP6A2U9dT1ghnlfAuxVP8AAEBG3oayjifV9IfDHEbHtFPOYct+ofgnsUc80TJhpG0y88XX3537Wg4YkM39Duc/xLyJix0mKvIpyo/uXel53eWb+ZJDgFhF7U+6T/Pg0Z2wmcwmwS0RMnEkiIrahXPJtob/4Qma+NzO/U89+7zeE+V7CpnuEJztO1rNp3WzsH+q3LCf9qww98z6o+/cYI2J3yi0y3f7iyJ7jvetC4KhpljGbbfD7Wpduf9HPelh0llp4u4zS5r+OiLtExJMon4gGEhHPj4hnR8TBEXFnyrX1bdn8UtswXAHcMSLuExG7dP4+0hXAgyNi7zo+KJ+KD4uIx0TE3eplzdmEyTdSbmZ/f0QcXud1dERMHOyvBo6OiDdFxCF1+qPqH32cLGhOKjMvodwn8+76t77uQfkW0N0o35wc1Jcpl3OfFxH7RsQLKH/CYD4Ma11vpr6ZvRp4WUS8IiIOjIgDIuJ/RsTba5nfAu+jnOl9dJ3+r5T7Mqfzeco3Nz8aEfevf5Prw3Xae+r/b6FcAvtkLXPXiHh8RDy8Tp9p3/gq5eb319Rt8FTKN/Wmc2X9/zERsVtE7NjPetDQ/QXlbNpXo/wh5TtGxH0j4iOUy/rHZebNA85zu4jYIyLuUPvKEyhfOriGwfvdr1IueX0kIh4YEfek3Mi/LeULPIP6MiV4PKXux6+gfDFjPvwIOCIiHhoR+0fESZQTCXOSmWuBfwL+KSJOiIi7R8RB9Zj851rmcsoXpN5el38g5crTDjPM/iOU+/3+MyIOi4jDKfcVX0P5ogiUb3/vB3y4vkftGxFPjoj71+mvBx4VEf9at//do/yNwLvX6V8GDqh13zcings8ZYZ6XVH/f3xE7BoRK/tZD4vRkgpvmXk+5dT1X1G+ufYiyunrQV0PPBf4OiWwvZDSuZ0z7asGdyrlwDuDciD9VR3/asoZwx/X8bsDb63lT6Z84jmY8oWHgWTmhZTO+o6U9n0H+EvK2R4y84uUG8fvS7lkeBHwL5RT04P+7bZnUL46/rE6n8OAR2XmT2dR789SLl+fWOd1f8oBPR+Gsq4nk5nvoVyC/dM6729RtvfVnWIvAb5IWW//Tbnk/x6mUQPRYyn32XyB8ia6E+VG5utrmasoZ0JvrfP/HuVbtRPzmGnfuJhyLDyrvvYYyre9p6vXz4DXULbbtdTL8X2uBw1JZq6ifGPwPMqXaH5CCfzbUL49+IVZzPYYyq0Uqyjh68mUD2b36d5L1Wf9kvJh7FLKbS7nU/rAhw86r+oDwNsp33y9gLJPv2UW8+nH6yn93GmU4/V2w1pWZr6e8h72HMqXB86pz6/sFPtzSp/42VqPa5j88nh3vjdT+vl1lGP9LMolx0dO3JeXmd+jfElk1zr9Isqf4lpfp59B+dbn/Sj71beAZ1IvBWfmlynH9Ctr3SduQZquXudTvuzxLsrZ4LcNsB4WlfBeX0mSpHYsqTNvkiRJrTO8SZIkNcTwJkmS1JDm/85bRHyHcsPk5TOVlbQo3A24LjPvPeqKzJX9l7QkzbkPaz68AbvutNNOex166KF7jboikubfRRddxMqVKxfL8b7rTjvttNfBBx+8WNojaQYXX3wxa9asmdM8FkN4u/zQQw/d68wzzxx1PSQtgCOOOGLUVRimyw8++OC9zvjiF0ddD0kL5BFHHcXZZ589p7Pt3vMmSZLUEMObJElSQwxvkiRJDTG8SZIkNcTwJkmS1BDDmyRJUkMMb5IkSQ0xvEmSJDXE8CZJktQQw5skSVJDDG+SJEkNMbxJkiQ1xPAmSZLUEMObJElSQwxvkiRJDTG8SZIkNcTwJkmS1BDDmyRJUkMMb5IkSQ0xvEmSJDXE8CZJktQQw5skSVJDDG+SJEkNMbxJkiQ1xPAmSZLUEMObJElSQwxvkiRJDTG8SZIkNcTwJkmS1BDDmyRJUkMMb5IkSQ0xvEmSJDXE8CZJktQQw5skSVJDDG+SJEkNMbxJkiQ1xPAmSZLUEMObJElSQwxvkiRJDTG8SZIkNcTwJkmS1BDDmyRJUkMMb5IkSQ0xvEmSJDXE8CZJktQQw5skSVJDxi68RcTJEbE6Im6IiMsi4jmjrpMk9cP+S9JCGLvwBrwB2CczdwQeD5wUEYePuE6S1A/7L0nzbuzCW2ZekpnrJp7WYd8RVkmS+mL/JWkhjF14A4iId0TE74BLgdXA6ZOUeV5EXAAcvnr16oWuoiRNyv5L0nwby/CWmS8EdgAeDHwCWDdJmXdn5n2AC/fcc88FrqEkTc7+S9J8G8vwBpCZ6zPzHGBv4AWjro8k9cv+S9J8Gtvw1rEC7xmR1Cb7L0lDN1bhLSJ2i4ijI2JlRCyPiKOApwJfHXXdJGk69l+SFsqKUVegR1IuMbyLEixXAS/OzNNGWitJmpn9l6QFMVbhLTOvAx4y6npI0qDsvyQtlLG6bCpJkqTpGd4kSZIaYniTJElqiOFNkiSpIYY3SZKkhhjeJEmSGmJ4kyRJaojhTZIkqSGGN0mSpIYY3iRJkhpieJMkSWqI4U2SJKkhhjdJkqSGGN4kSZIaYniTJElqiOFNkiSpIYY3SZKkhhjeJEmSGmJ4kyRJaojhTZIkqSGGN0mSpIYY3iRJkhpieJMkSWqI4U2SJKkhhjdJkqSGGN4kSZIaYniTJElqiOFNkiSpIYY3SZKkhhjeJEmSGmJ4kyRJaojhTZIkqSGGN0mSpIYY3iRJkhpieJMkSWqI4U2SJKkhhjdJkqSGGN4kSZIaYniTJElqiOFNkiSpIYY3SZKkhhjeJEmSGmJ4kyRJaojhTZIkqSErRl0BqR8RMVD5zJynmkjSYJ78lKcMVP7UU06Zp5posTC8aWwNGtimeq1BTtJCGzSwTfVag5wmY3jT2JlLaJtufoY4SfNtLqFtuvkZ4tRleNPYGHZom2r+hjhJwzbs0DbV/A1xgj7CW0R8vc953ZKZj5hjfbQEzXdom2p5hjhJczXfoW2q5RnilrZ+zrzdFzh+hjIB/Nvcq6OlZqGDW++yDXCSZmuhg1vvsg1wS1c/4e2bmfmBmQpFxDFDqI+WkFEGt24dDHCSBjXK4NatgwFuaZrx77xl5p/0MyMvmWoQ4xDcJoxTXSSNv3EIbhPGqS5aOAP9kd6IODQi7tgz7k4Rcchwq6XFbBzD0jjWSdL4GcewNI510vwa9BcWTga26hm3FfCh4VRHi904h6Rxrpuk0RvnkDTOddPwDRre7pSZP+2OyMyfAPsMrUZatFoIRy3UUdLCayEctVBHDceg4e3qiDisO6I+//nwqiRJkqSpDBre/i9wWkS8KCIeHREvAj4JvHn4VdNi0tIZrZbqKmn+tXRGq6W6avYG+oWFzHxPRFwPPBu4I3AV8NLM/Ph8VE6SJEmbG/TMG5l5amY+MjMPqv8b3DStFs9ktVhnScPX4pmsFuuswQz6p0IiIp4bEV+JiIvruD+OCPcUSZKkBTDombfXUS6Zvge4Ux13NfC3w6yUFo+Wz2C1XHdJc9fyGayW666ZDRrejgMem5kfAyZ+U+gK4K7DrJQkSZImN2h4Ww6srY8nwtvKzjhJkiTNo0HD2+nAmyNiGyj3wAGvBz4z7IqpfYvhsuNiaIOkwS2Gy46LoQ2a3KDh7SXAHYA1wE6UM253xnveJEmSFsSgf+ftBuCJEbEbJbRdlZnXzkvNJEmStIVB/1TIrhGxMjN/CXwbeFREHBsRA/+9uGmWsXNEfDIiboqIVRFxzLDmLUnzyf5L0kIY6Mwb8FngeOA7wD8CjwNuBQ4D/npIdXo78Htgd+BQ4HMR8d3MvGRI85ek+WL/JWneDXrGbH/govr46cCjgIcBRw+jMhGxPfAk4DWZuTYzzwE+DRw7jPlL0nyx/5K0UAYNb+uBrSPiXsCazPwZcD3lz4UMw/7A+sy8rDPuu8BBvQUj4nkRcQFw+OrVq4e0eEmaNfsvSQti0PD2eeAU4J3Ax+q4A4FrhlSflZRvsnatAXboLZiZ787M+wAX7rnnnkNavCTNmv2XpAUx6D1vzwGeSbnP7YN13C7AiUOqz1pgx55xOwI3Dmn+kjRf7L8kLYhBwxvAf2TmrZ3n3wSG9ZdMLwNWRMR+mfnjOu4QwJt9JY07+y9JC2LQy6ZfAg7vGXcY8MVhVCYzbwI+AbwuIraPiAcCTwA+NIz5S9J8sf+StFAGDW/3As7rGfctyqfLYXkhsB3wS+CjwAv8mr2kRth/SZp3g142XUP5+0XdX1XYHbhpWBXKzN8ATxzW/DQ6mdn8b4Nm5qiroIbYfy0ep55ySvO/DXrqKaeMugqaJ4Oeefsv4CMRcc+IuE39kyEfpHwDVZIkSfNs0PD2d8APKZdKbwTOBS4FXjnkekmSJGkSfYe3+vulDwBeAmwP7AGszMwXZea6eaqfGtfyZceW6y5p7lq+7Nhy3TWzvu95y8wNEXFaZk78wcnr5qlOkiRJmsKgl02/HhF/NC810aLV4hmsFussafhaPIPVYp01mEG/bboK+HxEnAZcBWx8h8vMvx9mxSRJkrSlQc+8bQd8ihLa9gbu2BmkKbV0Jqulukqafy2dyWqprpq9gc68Zeaz5qsikiRJmtmgZ94AiIgdIuIuEXHXiWHYFdPi08IZrRbqKGnhtXBGq4U6ajgGCm8RcWBEfIfySwuX1+HHdZBmNM7haJzrJmn0xjkcjXPdNHyDnnl7B/A1YGfgBuB2wL8DzxxyvbSIjWNIGsc6SRo/4xiSxrFOml+DhrdDgL/NzOuByMw1wMuB1w+9ZlrUxiksjVNdJI2/cQpL41QXLZxBw9stwFb18a8i4k51Hrcfaq20JIxDaBqHOkhqzziEpnGog0Zj0PB2NvCU+vjjwOeBs4CvDrNSWjpGGZ4MbpLmYpThyeC2tA36p0Ke0nn6KuD7wA7AB4dZKS0tEyEqIhZ0eZI0VxMh6slPecoMJYe7PC1tg/7CwkaZuQE4eYh10RI33yHO0CZpvsx3iDO0qWvG8BYRr8/M1/RR7h8y87XDqZaWsmGHOEObpIUy7BBnaNNk+jnz9uKIeB8w0zvpXwKGNw1NN3QNGuQMbJJGqRu6Bg1yBjbNpJ/wtj3lj/HO9O55y9yrI03OMCapVYYxDduM4S0zZ/UTWpIkSRo+g5kkSVJDDG+SJEkNMbxJkiQ1xPAmSZLUEMObJElSQwxvkiRJDTG8SZIkNcTwJkmS1BDDmyRJUkMMb5IkSQ0xvEmSJDXE8CZJktQQw5skSVJDDG+SJEkNMbxJkiQ1xPAmSZLUEMObJElSQwxvkiRJDTG8SZIkNcTwJkmS1BDDmyRJUkMMb5IkSQ0xvEmSJDXE8CZJktQQw5skSVJDDG+SJEkNMbxJkiQ1xPAmSZLUEMObJElSQwxvkiRJDTG8SZIkNcTwJkmS1BDDmyRJUkMMb5IkSQ0xvEmSJDXE8CZJktQQw5skSVJDDG+SJEkNMbxJkiQ1xPAmSZLUEMObJElSQwxvkiRJDTG8SZIkNcTwJkmS1BDDmyRJUkMMb5IkSQ0Zm/AWESdHxOqIuCEiLouI54y6TpLUL/swSQtlbMIb8AZgn8zcEXg8cFJEHD7iOklSv+zDJC2IsQlvmXlJZq6beFqHfUdYJUnqm32YpIUyNuENICLeERG/Ay4FVgOnT1P2eRFxAXD46tWrF6qKkjSlfvsw+y9JczFW4S0zXwjsADwY+ASwbpqy787M+wAX7rnnngtUQ0maWr99mP2XpLlYkPAWEWdGRE4xnNMtm5nrM/McYG/gBQtRP0majn2YpHGyYiEWkplHzOJlK/B+EUljwD5M0jgZi8umEbFbRBwdESsjYnlEHAU8FfjqqOsmSTOxD5O0kBbkzFsfknJ54V2UQLkKeHFmnjbSWklSf+zDJC2YsQhvmXkd8JBR10OSZsM+TNJCGovLppIkSeqP4U2SJKkhhjdJkqSGGN4kSZIaYniTJElqiOFNkiSpIYY3SZKkhhjeJEmSGmJ4kyRJaojhTZIkqSGGN0mSpIYY3iRJkhpieJMkSWqI4U2SJKkhhjdJkqSGGN4kSZIaYniTJElqiOFNkiSpIYY3SZKkhhjeJEmSGmJ4kyRJaojhTZIkqSGGN0mSpIYY3iRJkhpieJMkSWqI4U2SJKkhhjdJkqSGGN4kSZIaYniTJElqiOFNkiSpIYY3SZKkhhjeJEmSGmJ4kyRJaojhTZIkqSGGN0mSpIYY3iRJkhpieJMkSWqI4U2SJKkhhjdJkqSGGN4kSZIaYniTJElqiOFNkiSpIYY3SZKkhkRmjroOcxIRV++00057HXrooaOuiqQFcNFFF7Fy5UquvvrqGHVd5mqi/zr44INHXRVJC+Tiiy9mzZo112Tm3rOdx2IIb98BdgUuH3VdhmRPYPWoK9EQ19dgFsP6uhtwXWbee9QVmSv7ryXP9TWYxbK+5tyHNR/eFpuIuCAz7zPqerTC9TUY15fmk/vXYFxfg3F9beI9b5IkSQ0xvEmSJDXE8DZ+3j3qCjTG9TUY15fmk/vXYFxfg3F9Vd7zJkmS1BDPvEmSJDXE8CZJktQQw5skSVJDDG9jKCJOjojVEXFDRFwWEc8ZdZ3GTUTsHBGfjIibImJVRBwz6jqNM/cpLRT3tZnZfw3GfWpLfmFhDEXEQcDlmbkuIg4AzgQek5kXjrZm4yMiPkr58PFs4FDgc8ADMvOSkVZsTLlPaaG4r83M/msw7lNb8szbGMrMSzJz3cTTOuw7wiqNlYjYHngS8JrMXJuZ5wCfBo4dbc3Gl/uUFor72vTsvwbnPrUlw9uYioh3RMTvgEspv+V2+oirNE72B9Zn5mWdcd8FDhpRfZrgPqWF4r42LfuvWXCf2pzhbUxl5guBHYAHA58A1k3/iiVlJbCmZ9wayvrSFNyntFDc16Zl/zUL7lObM7wtsIg4MyJyiuGcbtnMXF9Pqe8NvGA0NR5La4Ede8btCNw4gro0xX1Kc2H/NRT2X7PkPrXJilFXYKnJzCNm8bIVLPHr+z0uA1ZExH6Z+eM67hDAm3375z6lgdl/DYX919wt+X3KM29jJiJ2i4ijI2JlRCyPiKOApwJfHXXdxkVm3kQ5bf66iNg+Ih4IPAH40GhrNp7cp7RQ3NdmZv81GPepyfmnQsZMROwKfJzySWwZsAp4S2a+Z6QVGzMRsTPwPuDhwK8Wr1YqAAAQ80lEQVSBV2TmR0Zbq/HkPqWF4r7WH/uv/rlPTc7wJkmS1BAvm0qSJDXE8CZJktQQw5skSVJDDG+SJEkNMbxJkiQ1xPAmSZLUEMObJElSQwxvkiRJDTG8SZIkNcTwJkmS1BDDmyRJUkMMb5IkSQ0xvEmSJDXE8CZJktQQw5skSVJDDG+SJEkNMbxJkiQ1xPAmSZLUEMObJElSQwxvkiRJDTG8SZIkNcTwJkmS1BDDmyRJUkMMb5IkSQ0xvEmSJDXE8CZJktQQw5skSVJDDG+SJEkNMbxJkiQ1xPAmSZLUEMObJElSQwxvkiRJDTG8SZIkNcTwJkmS1BDDmyRJUkMMb5IkSQ0xvEmSJDVkxagrMFcR8a/AoaOuh6QFdVFmvnjUlZgr+y9pyZpTH9Z8eKN0fA8BiM7ImR7PZvp8zLOV6eNct4kR0fM/sWn6ZOWmGj9f0+fn/6gLrP/Hsi3HLbL/zzrr6ywihwIPiZV7MNG+mNhxNj7etGNtnNZbliA66yii93VsfB6dfzbfVyfmNUOZjY+3LBOd+UTn+abpsXF8fWUtMzGu/+ebLW/j403LmajepmVN9fqeNnRe02nxpjaz6X82K9szvbu+e8puGpeQ9f+JMpmbpgF0n29Wtud5duax2bSsk7KU6T7e+LpN43OK8ZuV7zzOzcqw2es3m1eyqWx26zQxnynKdcZvbMtmZbrLnOTxxips+XizZXbbwKZhYlnZqcbm0zZN775249qfqGvndatZx1wthvAGwHLKNeCY5v+Jx/0+7/f/Qec72+WM6vXLR7jsadddwLJlEHVYtmzT80H/n+r1vWUHff3E/8zLsByWrdh8WLHtluMW2XDEw47krLPOYrGI7fdgq/0fSyxbvmlYvpxl3efLlm0xfeLx5uWWs2zF1ptNL2WCWFZC3cbHy4Jl0Xm8LMq+PFOZiLpvbznP5ZMMKzZ7vmzz6TFVuRmGKPVaHqUevc83Pq7z3/I5m16zrI7veR4By2qoWxZs+ZxuubreNpbrPGfi9bHF62LDeiI3QG6o7/IbOs/rsGHDjGWilpt0+ob15IbyPxvWk+vXl7Ib1pMbyuOs09iwoU5fv+XrpplHbthArq9D5/GG9VtO27B+irIbH6/vmUe3XNbnyYb12RmXdR65qcz6nL78hg11XH3tRPlM1meyPtni/99vmHx89/8NTD99fcKnuXbOAW7ZnHseSZIkLRjDmyRJUkMMb5IkSQ0xvEmSJDXE8CZJktQQw5skSVJDDG+SJEkNMbxJkiQ1xPAmSZLUEMObJElSQxbNz2OtBzZ0nscMj2czfT7m2cr0saxbQnQ2/NL7bdPa+Li1Liwgbtz0eJH+v8h+25S86VpuveyzTLTP3zbt7/lmy9v4eNNyJqrnb5v626ZlFv626bi5CNgTWJ2dkTlF4UVoT2D1qCsxQnuStf1LaKNXe0KuXooNB/4w6goMyUXAnrn22o3H8BLcmku5D7PtS9ec+rDIbL+riIgLMvM+o67HKCzltsPSbr9tXxxtX0xtmY2l3H7bvjTbDnNvv/e8SZIkNcTwJkmS1JDFEt7ePeoKjNBSbjss7fbb9sVhMbVlNpZy+2370jWn9i+Ke94kSZKWisVy5k2SJGlJMLxJkiQ1xPAmSZLUkLEMbxGxc0R8MiJuiohVEXHMFOUiIv45In5dhzdFdP42dsShEXFhRPyu/n/owrVi9gZo/8sj4vsRcWNEXBERL++ZfmVE3BwRa+twxsK0YPYGaPuJEXFrp21rI+KunemLfdt/vqftv4+I73Wmt7jtT4iICyJiXUS8f4ayfx0R10bEmoh4X0Rs05m2T0R8rW77SyPiyHmv/AAi4syIuKWzbX40Tdlp+7iWRMQ2EfHeul/fGBHfiYhHTVP+uIhY37OfH7GAVZ6zYb2XtWiQ7b0YtnWvfo/z2W77sQxvwNuB3wO7A08D3hkRB01S7nnAE4FDgIOBxwLPB4iIrYHTgJOB2wEfAE6r48ddv+0P4BmU9j0SOCEiju4p87jMXFmHR8xnpYek37YD/GenbSsz86ewNLZ9Zj6q23bgm8CpPcVa2/Y/B04C3jddoYg4CngF8CfAPsBdgX/oFPko8B3g9sDfAR+PiF3nob5zcUJn29x9mnJT9nENWgFcBTwE2Al4DXBKROwzzWv+u+cYP3Peazlcc34va9ig27v1bT2Zfo7z2W37rL8/Ni4DsD1lZ9+/M+5DwBsnKftN4Hmd588Gzq2PHwFcQ/1GbR33M+CRo27jsNo/yWvfAry18/xK4MhRt2metv2JwMlTzGdJbXtKgFkP3KXVbd/TnpOA908z/SPAP3We/wlwbX28P7AO2KEz/Wzg+FG3q1OfM4Hn9Fl2yj5uMQzAxcCTpph2HHDOqOs4h7YN5b1sMQ1Tbe/Wt/UUbe3rOJ/tth/HM2/7A+sz87LOuO8Ck31aOahOm6zcQcDFWddGdfEU8xkng7R/o3qa9cHAJT2TPhwR10XEGRFxyHCrOnSDtv1xEfGbiLgkIl7QGb+ktj3l7OvZmXlFz/iWtv0gJjvud4+I29dpP83MG3umj9u2f0NE/CoivjHD5aHp+rimRcTulH2+t8/qunddT5dFxGsioqXf4x7We9mi0Mf2bnlbT6Wf43xW234cw9tKYE3PuDXADn2UXQOsrEFmkPmMk9nW+0TK9vyPzrinUc7K3Bn4GvDFiLjtUGo5PwZp+ynAPYBdgecCfx8RT53FfMbJbOv9DOD9PeNa2/aDmOy4h7KeWtj2f0u51LsX5Q91fiYi9p2i7HR9XLMiYivgw8AHMvPSKYp9HbgnsBvwJOCpwMunKDuOhvVe1rw+tnfr23oy/R7ns9r24xje1gI79ozbEbixj7I7AmvrGZdB5jNOBq53RJxAeQN/TGaumxifmd/IzJsz83eZ+QbgesrZuXHVd9sz8weZ+fPMXJ+Z3wT+DfizQeczZmaz7R8E7AF8vDu+wW0/iMmOeyjraaTbvt6knFMM5wBk5nmZeWNmrsvMDwDfAB49xSyn6+PGSj9tr+WWUS4f/h44Yar5ZeZPM/OKzNyQmd8DXsemY7wFw3ova1o/23sRbOstDHCcz2rbj2N4uwxYERH7dcYdwuSnWi+p0yYrdwlwcE96PXiK+YyTQdpPRPw59ebtzLx6hnkn5UsO42qgtvfotm1JbPvqmcAnMnPtDPMe920/iMmO+19k5q/rtLtGxA490xdk22fmEZkZUwwPmuplTL1tpuvjxko/ba/H5HspN/A/KTNvHWQRtLUPD+u9rFlz2N6tbet+TNWm2W37Ud/UN8UNfB+jfGNse+CBlNOIB01S7njgh5TTkneoDT6+TtsaWAX8FbANJfGvArYedfuG2P6nAdcC95hk2p3qa7cGtqWcgr4OuP2o2zektj+B8k3SAP4H5QsKz1wq276W3Y5yRu1hi2Tbr6j1fQPlk/q2wIpJyj2y7vcH1n3gq3RuAgfOBf6lvv5P6zraddTtq3W7LXDURNvqMXwTcPcpyk/Zx7U4AO+q22dlH2UfBexeHx8AfB947ajbMGB75/xe1vLQ7/ZeDNu6pz19H+ez3fYjb+QUDd8Z+FRt7M+AY+r4B1NOJ06UC+BNwG/q8CY2/4bhvYELgZuBbwP3HnXbhtz+K4BbKaddJ4Z31WkHUW7Svwn4NfAV4D6jbtsQ2/7R2q61wKXAX/bMZ1Fv+zruqZRQGj3jW932J1I+nXaHEylhdC1wp07ZlwC/AG6g3Oe5TWfaPpRvet0M/Igx+tYt5R7N8ymXzq6nvLE9vDN9oD6upYFy/2UCt/T0WU+r0zfbzpQA/ou6H/+Uciltq1G3Y8A2D+W9rMVhuu29GLd1T9unPM6Hte39YXpJkqSGjOM9b5IkSZqC4U2SJKkhhjdJkqSGGN4kSZIaYniTJElqiOFNkiSpIYY3LToR8bSIOGPU9ZAkja+IOCEiLoiIdRHx/nmY/9qeYX1EvHUY8za8aV5FxJURcXPPDnyHIc5/n/rbiSsmxmXmhzPzEcNahiQNU/0d2OeMuh7i58BJwPvmY+aZuXJioPxE2M3AqcOYt+FNC+Fx3Z04M3/endgNXpKk6UXE8lHXYTHIzE9k5qcov0SzmYh4bERcFBHXR8Q3I+LgOS7uz4BfAmfPcT6A4U0j0Dlb9uyI+BnltymJiFMj4tqIWBMRX4+Igzqv2S4i/k9ErKrTz4mI7YCv1yLX17N694+I4yLinM5rHxAR59fXnR8RD+hMOzMiXh8R34iIGyPijIjYZYFWhaSG1CsJL4+IiyPipoh4b0TsHhGfr/3HlyPidrXsH9U3/esj4rsRcUQd/4+Un0h6W+2z3lbHHxARX4qI30TEjyLiKZ3lvj8i3hkRp0fETcBDI+LREfGDutxrIuJlC79GFqeIOIxyNu75wO2Bfwc+HRHbzGG2zwQ+mEP6WSvDm0bpIcA9KD/gC/B5YD9gN8rvkX64U/ZfgMOBB1B+L/BvgA3AH9fpt61n9f67u4CI2Bn4HPAWykH4ZuBzEXH7TrFjgGfV5W4N2AlKmsqTgIcD+wOPo/RbrwJ2obyn/mVE7EXpd06i9FcvA/4rInbNzL+jnH05ofZZJ0TE9sCXgI9Q+qGnAu/ofoCl9FP/COwAnAO8F3h+Zu4A3JP6IVhD8Vzg3zPzvMxcn5kfANYBfzSbmUXEnSjvdx8YVgUNb1oIn6qfPq+PiE91xp+YmTdl5s0Amfm+zLwxM9dRfpD8kIjYKSKWAX8O/FVmXlMPpm/WcjN5DPDjzPxQZv4hMz9K+SH7x3XK/EdmXlbrcQpw6BDaLGlxemtm/iIzr6GEsPMy8zu1P/okcG/g6cDpmXl6Zm7IzC8BFwCPnmKejwWuzMz/qP3Ut4H/olxqm3BaZn6jzu8W4FbgwIjYMTN/W1+j4bgz8NLO+9b1wB2BO8DGKzY5xXDOJPN7BnBOZl4xrAoa3rQQnpiZt63DEzvjr5p4EBHLI+KNEfGTiLgBuLJO2qUO2wI/mcWy7wCs6hm3Ctir8/zazuPfAStnsRxJS8MvOo9vnuT5Ssqb/5N73vwfBOw5xTzvDNyvp/zTgD06Za7qec2TKGFwVUScFRH3n32T1OMq4B8771u3zczb1A//ZOYRmRlTDA+aZH7PYIhn3cDwptHqXvs/BngCcCSwE7BPHR/Ar4BbgH1nmMdkfk7pGLvuBFwzYF0lqV9XAR/qefPfPjPfWKf39ltXAWf1lF+ZmS/olNnsNZl5fmY+gXKZ9VOUqwYaQESsiIhtgeXA8ojYtn6B7j3A8RFxvyi2j4jHRMQOs1jGAygnC4byLdMJhjeNix0o9xT8GrgN8E8TEzJzA+Xm0TdHxB3qWbr715tHr6Pc+3bXKeZ7OrB/RBxTD9T/BRwIfHYe2yJpaTsZeFxEHFX7q20j4oiI2LtO/wWb91mfpfRTx0bEVnW4b0TcY7KZR8TWUf6e5U6ZeStwA7B+Xlu0OL2acrb0FZRL3TcDr87MCyj3vb0N+C1wOXDcLJfxTOATmXnjnGvbYXjTuPgg5XLmNcAPgHN7pr8M+B5wPvAb4J+BZZn5O8pNvN+olxs2u6E0M39NuZ/kpZRg+DfAYzPzV/PYFklLWGZeRbmS8CrKB8yrgJez6T3334A/i4jfRsRb6hv7I4CjKVcLrqX0cdN9u/FY4Mp6m8nxlPChAWTmiZNc9jyxTvtCZt63ngXdMzOfPJsAlpnPz8xjh133GNK3ViVJkrQAPPMmSZLUEMObJElSQwxvkiRJDTG8SZIkNcTwJkmS1BDDmyRJUkMMb5IkSQ0xvEmSJDXk/wNsu+VbZq0l0wAAAABJRU5ErkJggg==\n", + "text/plain": [ + "
" + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], + "source": [ + "optic = poppy.optics.CircularOcculter()\n", + "optic.display(what='both');" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "#### BarOcculter" + ] + }, + { + "cell_type": "code", + "execution_count": 20, + "metadata": {}, + "outputs": [ + { + "data": { + "image/png": "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\n", + "text/plain": [ + "
" + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], + "source": [ + "optic = poppy.optics.BarOcculter(width=1, height=10)\n", + "optic.display(what='both');" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "### BandLimitedCoronagraph" + ] + }, + { + "cell_type": "code", + "execution_count": 21, + "metadata": {}, + "outputs": [ + { + "data": { + "image/png": "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\n", + "text/plain": [ + "
" + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], + "source": [ + "optic = poppy.BandLimitedCoronagraph()\n", + "optic.display(what='both');" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "### Four Quadrant Phase Mask\n", + "The class is named `IdealFQPM` because this implements a notionally perfect 4QPM at some given wavelength; it has precisely half a wave retardance at the reference wavelength. " + ] + }, + { + "cell_type": "code", + "execution_count": 22, + "metadata": {}, + "outputs": [ + { + "data": { + "image/png": "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\n", + "text/plain": [ + "
" + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], + "source": [ + "optic = poppy.IdealFQPM(wavelength=1*u.micron)\n", + "optic.display(what='both');" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## General Purpose Elements" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "### ScalarTransmission\n", + "This class implements a uniformly multiplicative transmission factor, i.e. a neutral density filter. " + ] + }, + { + "cell_type": "code", + "execution_count": 3, + "metadata": { + "scrolled": false + }, + "outputs": [ + { + "data": { + "image/png": "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\n", + "text/plain": [ + "
" + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], + "source": [ + "optic = poppy.ScalarTransmission(transmission=0.85)\n", + "optic.display(what='both');" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "### Inverse Transmission\n", + "This optic acts on another to flip the transmission: Areas which were 0 become 1 and vice versa. This operation is not meant as a representative of some real physical process itself, but can be useful in building certain types of compound optics. " + ] + }, + { + "cell_type": "code", + "execution_count": 4, + "metadata": {}, + "outputs": [ + { + "data": { + "image/png": "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\n", + "text/plain": [ + "
" + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], + "source": [ + "circ = poppy.CircularAperture(radius=1)\n", + "ax1= plt.subplot(121)\n", + "circ.display(what='amplitude', ax=ax1)\n", + "\n", + "ax2= plt.subplot(122)\n", + "inverted_circ = poppy.InverseTransmission(circ)\n", + "inverted_circ.display(grid_size=3, what='amplitude', ax=ax2)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Wavefront Errors" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "### ZernikeWFE\n", + "Wavefront errors can be specified by giving a list of Zernike coefficients, which are ordered using the Noll indexing convention. The different Zernikes are then added together to make an overall wavefront map.\n", + "\n", + "Note that while the Zernikes are defined with respect to some notional circular aperture of a given radius, by default this class just implements the _wavefront error_ part, not the aperture stop. " + ] + }, + { + "cell_type": "code", + "execution_count": 5, + "metadata": {}, + "outputs": [ + { + "data": { + "image/png": "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\n", + "text/plain": [ + "
" + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], + "source": [ + "optic = poppy.ZernikeWFE(radius=1*u.cm, \n", + " coefficients=[0.1e-6, 3e-6, -3e-6, 1e-6, -7e-7, 0.4e-6, -2e-6],\n", + " aperture_stop=False)\n", + "optic.display(what='both', opd_vmax=1e-5, grid_size=0.03);" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "You can optionally set the parameter `aperture_stop=True` to ZernikeWFE if you want it to also act as a circular aperture stop. " + ] + }, + { + "cell_type": "code", + "execution_count": 8, + "metadata": {}, + "outputs": [ + { + "data": { + "image/png": "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\n", + "text/plain": [ + "
" + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], + "source": [ + "optic = poppy.ZernikeWFE(radius=1*u.cm, \n", + " coefficients=[0, 2e-6, 3e-6, 2e-6, 0, 0.4e-6, 1e-6],\n", + " aperture_stop=True)\n", + "optic.display(what='both', opd_vmax=1e-5, grid_size=0.03);" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "### SineWaveWFE\n", + "A sinusoidal ripple across a mirror, for instance a deformable mirror. Specify the ripple by the spatial frequency (i.e. cycles per meter). Use the `amplitude`, `rotation` and `phaseoffset` parameters to adjust the sine wave. " + ] + }, + { + "cell_type": "code", + "execution_count": 16, + "metadata": {}, + "outputs": [ + { + "data": { + "image/png": "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\n", + "text/plain": [ + "
" + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], + "source": [ + "optic = poppy.SineWaveWFE(spatialfreq=5/u.meter, \n", + " amplitude=1*u.micron,\n", + " rotation=20)\n", + "optic.display(what='both', opd_vmax=1*u.micron);" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": {}, + "outputs": [], + "source": [] + } + ], + "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.6.5" + } + }, + "nbformat": 4, + "nbformat_minor": 2 +} diff --git a/docs/conf.py b/docs/conf.py index cf6bb70d..467b6d4f 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -53,6 +53,10 @@ # -- General configuration ---------------------------------------------------- + +extensions.append('nbsphinx') +extensions.append('sphinx.ext.mathjax') + # By default, highlight as Python 3. highlight_language = 'python3' @@ -66,6 +70,8 @@ # List of patterns, relative to source directory, that match files and # directories to ignore when looking for source files. exclude_patterns.append('_templates') +exclude_patterns.append('_build') +exclude_patterns.append('**.ipynb_checkpoints') # This is added to the end of RST files - a good place to put substitutions to # be used globally. diff --git a/docs/fresnel.rst b/docs/fresnel.rst index c65bb263..0bb8df1f 100644 --- a/docs/fresnel.rst +++ b/docs/fresnel.rst @@ -14,11 +14,9 @@ amplitude aberrations. .. caution:: The Fresnel code has been cross-checked against the `PROPER library by John Krist - ` to verify accuracy and correctness of + `_ to verify accuracy and correctness of output. A test suite is provided along with ``poppy`` in the tests subdirectory - and users are encouraged to run these tests themselves. However this is still - a relatively new addition to ``poppy``, and it is possible there may still be - some bugs. + and users are encouraged to run these tests themselves. @@ -67,7 +65,7 @@ serves the same purpose in Fresnel propagation. Note that when adding function and must specify a physical distance separating that optic from the previous optic, again as an `astropy.Quantity `_ of dimension length. This replaces -the ``addImage`` and ``addPupil`` methods used in Fraunhofer propagation. +the ``add_image`` and ``add_pupil`` methods used in Fraunhofer propagation. diff --git a/docs/index.rst b/docs/index.rst index 70719e62..092c89e7 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -56,6 +56,7 @@ Contents relnotes.rst overview.rst examples.rst + available_optics.ipynb wfe.rst coronagraphs.rst fresnel.rst diff --git a/docs/overview.rst b/docs/overview.rst index f2a9ca67..3b89cc21 100644 --- a/docs/overview.rst +++ b/docs/overview.rst @@ -34,7 +34,7 @@ Given a specified instrument configuration, an appropriate `~poppy.OpticalSystem .. _fraunhofer: Fraunhofer domain calculations -================================ +-------------------------------- ``poppy``'s default mode assumes that optical propagation can be modeled using Fraunhofer diffraction (the "far field" approximation), such that the @@ -72,7 +72,7 @@ onto a common pixel scale) more than makes up for this and the MFT is faster. Working with OpticalElements -=================================== +---------------------------- OpticalElements can be instantiated from FITS files, or created by one of a large number of analytic function definitions implemented as `~poppy.AnalyticOpticalElement` subclasses. Typically these classes take some number of arguments to set their properties. diff --git a/readthedocs.yml b/readthedocs.yml new file mode 100644 index 00000000..872c5627 --- /dev/null +++ b/readthedocs.yml @@ -0,0 +1,7 @@ +conda: + file: .rtd-environment.yml +python: + setup_py_install: true + version: 3 +formats: + - pdf