Added performance stuff

source/PL_turbulence_test_paper_final.png:Zone.Identifier

@@ -0,0 +1,4 @@
+[ZoneTransfer]
+ZoneId=3
+ReferrerUrl=https://www.overleaf.com/project/64c81e0c7dd8b3bf79c08736
+HostUrl=https://www.overleaf.com/project/64c81e0c7dd8b3bf79c08736/file/66a62b75f3f612ff4dc7fcdf

source/_build/_sources/index.rst.txt

@@ -14,6 +14,7 @@ Welcome to first_control's documentation!
 
    Intro
    instrument_principle
+   instrument_performance
 
 
 .. toctree::

source/_build/_sources/instrument_performance.md.txt

@@ -0,0 +1,26 @@
+# Instrument performance
+
+## Injection efficiency
+
+### Injection efficiency versus focal ratio
+
+Below graph shows the on-axis, maximum and average injection efficiency of the Photonic Lantern, at 642 nm, for various focal ratios. The measurements were performed on the bench without any turbulence. The estimated Strehl ratio at 750 nm (from VAMPIRES) was about 90%.
+
+![](coupling_plot_corrected.png)
+
+*Figure 3 : Variation of the injection effciency measured at 642 nm as a function of the focal ratio (bottom horizontal axis), or as a function of the ratio between the PSF size and MFD of the PL (top horizonal axis). For each focal ratio experimentally tested, we represent the on-axis injection efficiency, the maximum efficiency and the average over the whole scanned area. The field of view projected on-sky is also plotted with red crosses (right axis).*
+
+The optimal injection efficiency was recorded for a focal ratio of 8. The current default setup of the Photonic Lantern injection module is f/8.
+
+### Injection efficiency versus Strehl Ratio
+
+To assess the injection efficiency into the PL in the presence of uncorrected atmospheric turbulence, turbulence is injected onto the SCExAO DM with various levels of upstream atmospheric turbulence correction. Turbulence screens are based on Kolmogorov spectrum with inner and outer scales, adopting the frozen flow approximation for temporal evolution, and are the closest to what we expect during on-sky observations. We fixed the wind speed at 10 m/s and modified the turbulence amplitude to vary the Strehl ratio. In order to study the behavior of the PL in various conditions, we varied the spatial frequency content of the simulated turbulence. We identified three distinct cases by adjusting the inner and outer scales of the turbulence:
+- Turbulence following the Kolmogorov power spectrum (inner scale = 0.01 meter, outer scale = 20 meters), the closest to what we expect on-sky
+- Turbulence dominated by high spatial frequencies (inner scale = 0.01 meter, outer scale = 1 meter), which would correspond to an ExAO case where low order aberrations are well corrected but there is still remaining high order aberrations (for example if the DM lacks actuators). 
+- Turbulence dominated by the low spatial frequencies (inner scale = 10 meters, outer scale = 100 meters), which would correspond to a more classic AO loop performing poorly on low order aberrations (for example, during the observation of a faint star).
+
+The injection module focal ratio was set to f/8. Results are shown on the below graph.
+
+![](PL_turbulence_test_paper_final.png)
+
+*Figure 4 : Relationship between the injection efficiency at 642 nm and the Strehl ratio measured at 750 nm for various atmospheric conditions. The turbulence is applied on the SCExAO DM and the flux is recorded at the 19-port PL output. The presented SMF results are simulations from Lin et al. (2021), where the simulated turbulence screens were following the Kolmogorov power spectrum.*

source/_build/genindex.html

@@ -45,6 +45,7 @@
 <ul>
 <li class="toctree-l1"><a class="reference internal" href="Intro.html">Introduction</a></li>
 <li class="toctree-l1"><a class="reference internal" href="instrument_principle.html">Instrument presentation</a></li>
+<li class="toctree-l1"><a class="reference internal" href="instrument_performance.html">Instrument performance</a></li>
 </ul>
 <p class="caption" role="heading"><span class="caption-text">Procedures</span></p>
 <ul>

source/_build/index.html

@@ -47,6 +47,7 @@
 <ul>
 <li class="toctree-l1"><a class="reference internal" href="Intro.html">Introduction</a></li>
 <li class="toctree-l1"><a class="reference internal" href="instrument_principle.html">Instrument presentation</a></li>
+<li class="toctree-l1"><a class="reference internal" href="instrument_performance.html">Instrument performance</a></li>
 </ul>
 <p class="caption" role="heading"><span class="caption-text">Procedures</span></p>
 <ul>
@@ -93,6 +94,10 @@ <h1>Welcome to first_control’s documentation!<a class="headerlink" href="#welc
 <li class="toctree-l2"><a class="reference internal" href="instrument_principle.html#general-information">General information</a></li>
 </ul>
 </li>
+<li class="toctree-l1"><a class="reference internal" href="instrument_performance.html">Instrument performance</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="instrument_performance.html#injection-efficiency">Injection efficiency</a></li>
+</ul>
+</li>
 </ul>
 </div>
 <div class="toctree-wrapper compound">

source/_build/instrument_performance.html

@@ -0,0 +1,151 @@
+<!DOCTYPE html>
+<html class="writer-html5" lang="en" data-content_root="./">
+<head>
+  <meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
+
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>Instrument performance &mdash; FIRST control</title>
+      <link rel="stylesheet" type="text/css" href="_static/pygments.css?v=80d5e7a1" />
+      <link rel="stylesheet" type="text/css" href="_static/css/theme.css?v=19f00094" />
+
+
+  <!--[if lt IE 9]>
+    <script src="_static/js/html5shiv.min.js"></script>
+  <![endif]-->
+
+        <script src="_static/jquery.js?v=5d32c60e"></script>
+        <script src="_static/_sphinx_javascript_frameworks_compat.js?v=2cd50e6c"></script>
+        <script src="_static/documentation_options.js?v=01f34227"></script>
+        <script src="_static/doctools.js?v=9a2dae69"></script>
+        <script src="_static/sphinx_highlight.js?v=dc90522c"></script>
+    <script src="_static/js/theme.js"></script>
+    <link rel="index" title="Index" href="genindex.html" />
+    <link rel="search" title="Search" href="search.html" />
+    <link rel="next" title="Instrument setup" href="instrument_setup.html" />
+    <link rel="prev" title="Instrument presentation" href="instrument_principle.html" /> 
+</head>
+
+<body class="wy-body-for-nav"> 
+  <div class="wy-grid-for-nav">
+    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
+      <div class="wy-side-scroll">
+        <div class="wy-side-nav-search" >
+
+
+
+          <a href="index.html" class="icon icon-home">
+            first_control
+          </a>
+<div role="search">
+  <form id="rtd-search-form" class="wy-form" action="search.html" method="get">
+    <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" />
+    <input type="hidden" name="check_keywords" value="yes" />
+    <input type="hidden" name="area" value="default" />
+  </form>
+</div>
+        </div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <p class="caption" role="heading"><span class="caption-text">Instrument presentation</span></p>
+<ul class="current">
+<li class="toctree-l1"><a class="reference internal" href="Intro.html">Introduction</a></li>
+<li class="toctree-l1"><a class="reference internal" href="instrument_principle.html">Instrument presentation</a></li>
+<li class="toctree-l1 current"><a class="current reference internal" href="#">Instrument performance</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="#injection-efficiency">Injection efficiency</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="#injection-efficiency-versus-focal-ratio">Injection efficiency versus focal ratio</a></li>
+<li class="toctree-l3"><a class="reference internal" href="#injection-efficiency-versus-strehl-ratio">Injection efficiency versus Strehl Ratio</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+<p class="caption" role="heading"><span class="caption-text">Procedures</span></p>
+<ul>
+<li class="toctree-l1"><a class="reference internal" href="instrument_setup.html">Instrument setup</a></li>
+</ul>
+<p class="caption" role="heading"><span class="caption-text">Operating FIRST</span></p>
+<ul>
+<li class="toctree-l1"><a class="reference internal" href="camera_control.html">Camera control</a></li>
+<li class="toctree-l1"><a class="reference internal" href="saving_images.html">Save data</a></li>
+</ul>
+
+        </div>
+      </div>
+    </nav>
+
+    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu" >
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="index.html">first_control</a>
+      </nav>
+
+      <div class="wy-nav-content">
+        <div class="rst-content">
+          <div role="navigation" aria-label="Page navigation">
+  <ul class="wy-breadcrumbs">
+      <li><a href="index.html" class="icon icon-home" aria-label="Home"></a></li>
+      <li class="breadcrumb-item active">Instrument performance</li>
+      <li class="wy-breadcrumbs-aside">
+            <a href="_sources/instrument_performance.md.txt" rel="nofollow"> View page source</a>
+      </li>
+  </ul>
+  <hr/>
+</div>
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+           <div itemprop="articleBody">
+
+  <section id="instrument-performance">
+<h1>Instrument performance<a class="headerlink" href="#instrument-performance" title="Link to this heading"></a></h1>
+<section id="injection-efficiency">
+<h2>Injection efficiency<a class="headerlink" href="#injection-efficiency" title="Link to this heading"></a></h2>
+<section id="injection-efficiency-versus-focal-ratio">
+<h3>Injection efficiency versus focal ratio<a class="headerlink" href="#injection-efficiency-versus-focal-ratio" title="Link to this heading"></a></h3>
+<p>Below graph shows the on-axis, maximum and average injection efficiency of the Photonic Lantern, at 642 nm, for various focal ratios. The measurements were performed on the bench without any turbulence. The estimated Strehl ratio at 750 nm (from VAMPIRES) was about 90%.</p>
+<p><img alt="" src="_images/coupling_plot_corrected.png" /></p>
+<p><em>Figure 3 : Variation of the injection effciency measured at 642 nm as a function of the focal ratio (bottom horizontal axis), or as a function of the ratio between the PSF size and MFD of the PL (top horizonal axis). For each focal ratio experimentally tested, we represent the on-axis injection efficiency, the maximum efficiency and the average over the whole scanned area. The field of view projected on-sky is also plotted with red crosses (right axis).</em></p>
+<p>The optimal injection efficiency was recorded for a focal ratio of 8. The current default setup of the Photonic Lantern injection module is f/8.</p>
+</section>
+<section id="injection-efficiency-versus-strehl-ratio">
+<h3>Injection efficiency versus Strehl Ratio<a class="headerlink" href="#injection-efficiency-versus-strehl-ratio" title="Link to this heading"></a></h3>
+<p>To assess the injection efficiency into the PL in the presence of uncorrected atmospheric turbulence, turbulence is injected onto the SCExAO DM with various levels of upstream atmospheric turbulence correction. Turbulence screens are based on Kolmogorov spectrum with inner and outer scales, adopting the frozen flow approximation for temporal evolution, and are the closest to what we expect during on-sky observations. We fixed the wind speed at 10 m/s and modified the turbulence amplitude to vary the Strehl ratio. In order to study the behavior of the PL in various conditions, we varied the spatial frequency content of the simulated turbulence. We identified three distinct cases by adjusting the inner and outer scales of the turbulence:</p>
+<ul class="simple">
+<li><p>Turbulence following the Kolmogorov power spectrum (inner scale = 0.01 meter, outer scale = 20 meters), the closest to what we expect on-sky</p></li>
+<li><p>Turbulence dominated by high spatial frequencies (inner scale = 0.01 meter, outer scale = 1 meter), which would correspond to an ExAO case where low order aberrations are well corrected but there is still remaining high order aberrations (for example if the DM lacks actuators).</p></li>
+<li><p>Turbulence dominated by the low spatial frequencies (inner scale = 10 meters, outer scale = 100 meters), which would correspond to a more classic AO loop performing poorly on low order aberrations (for example, during the observation of a faint star).</p></li>
+</ul>
+<p>The injection module focal ratio was set to f/8. Results are shown on the below graph.</p>
+<p><img alt="" src="_images/PL_turbulence_test_paper_final.png" /></p>
+<p><em>Figure 4 : Relationship between the injection efficiency at 642 nm and the Strehl ratio measured at 750 nm for various atmospheric conditions. The turbulence is applied on the SCExAO DM and the flux is recorded at the 19-port PL output. The presented SMF results are simulations from Lin et al. (2021), where the simulated turbulence screens were following the Kolmogorov power spectrum.</em></p>
+</section>
+</section>
+</section>
+
+
+           </div>
+          </div>
+          <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
+        <a href="instrument_principle.html" class="btn btn-neutral float-left" title="Instrument presentation" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="instrument_setup.html" class="btn btn-neutral float-right" title="Instrument setup" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+    </div>
+
+  <hr/>
+
+  <div role="contentinfo">
+    <p>&#169; Copyright 2024, Sebastien Vievard.</p>
+  </div>
+
+  Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
+    <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
+    provided by <a href="https://readthedocs.org">Read the Docs</a>.
+
+
+</footer>
+        </div>
+      </div>
+    </section>
+  </div>
+  <script>
+      jQuery(function () {
+          SphinxRtdTheme.Navigation.enable(true);
+      });
+  </script> 
+
+</body>
+</html>

source/_build/objects.inv

@@ -2,4 +2,4 @@
 # Project: first_control
 # Version: 
 # The remainder of this file is compressed using zlib.
-xڅ�=N1����`�hi��@Z��r�M�L��)�؎kp=NB&��D���������!�zT^��
��p��5uT�d흐h)�$�&����>vM��S�^0�g2��v-��gmO�6^�Ho	�Û���ɯ��y}����w9'q,��vRCc��z4B��"��D��?Ҋw�TTa����zhF���s�����;]y�n�^��'mq��7�ʿ��@!�H�Q.㹪��?eV|���
+xڅ�1n!E{NA�HiӦr�R���	�w��Y��w���瓄�E
�V:���7_��s Y�jRr�"���<���ņ�P�0��hm��}˚�41�7^�w�Y�B��Z��������'ZE%�<�����\�L�Cϰ�}J��!Ì�H��W؃�M�.Փ��A�����!�������l�y�вwCʪp���v>�Qr��'S�r���'v8�D�OG8?����m�%�
'�DDj��m�,�!e�/�/��

source/_build/search.html

@@ -48,6 +48,7 @@
 <ul>
 <li class="toctree-l1"><a class="reference internal" href="Intro.html">Introduction</a></li>
 <li class="toctree-l1"><a class="reference internal" href="instrument_principle.html">Instrument presentation</a></li>
+<li class="toctree-l1"><a class="reference internal" href="instrument_performance.html">Instrument performance</a></li>
 </ul>
 <p class="caption" role="heading"><span class="caption-text">Procedures</span></p>
 <ul>