Added camera control stuff

scexao-org · Sep 24, 2024 · 062962c · 062962c
1 parent 52e50bd
commit 062962c
Show file tree

Hide file tree

Showing 67 changed files with 6,362 additions and 6 deletions.
diff --git a/source/_build/.buildinfo b/source/_build/.buildinfo
@@ -0,0 +1,4 @@
+# Sphinx build info version 1
+# This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done.
+config: 6f1870d5ffd06422d33dbaff855b317d
+tags: 645f666f9bcd5a90fca523b33c5a78b7
diff --git a/source/_build/.doctrees/Intro.doctree b/source/_build/.doctrees/Intro.doctree
diff --git a/source/_build/.doctrees/camera_control.doctree b/source/_build/.doctrees/camera_control.doctree
diff --git a/source/_build/.doctrees/environment.pickle b/source/_build/.doctrees/environment.pickle
diff --git a/source/_build/.doctrees/index.doctree b/source/_build/.doctrees/index.doctree
diff --git a/source/_build/.doctrees/instrument_principle.doctree b/source/_build/.doctrees/instrument_principle.doctree
diff --git a/source/_build/.doctrees/instrument_setup.doctree b/source/_build/.doctrees/instrument_setup.doctree
diff --git a/source/_build/.doctrees/saving_images.doctree b/source/_build/.doctrees/saving_images.doctree
diff --git a/source/_build/Intro.html b/source/_build/Intro.html
@@ -0,0 +1,120 @@
+<!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>Introduction &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 presentation" href="instrument_principle.html" />
+    <link rel="prev" title="Welcome to first_control’s documentation!" href="index.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 current"><a class="current reference internal" href="#">Introduction</a></li>
+<li class="toctree-l1"><a class="reference internal" href="instrument_principle.html">Instrument presentation</a></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="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">Introduction</li>
+      <li class="wy-breadcrumbs-aside">
+            <a href="_sources/Intro.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="introduction">
+<h1>Introduction<a class="headerlink" href="#introduction" title="Link to this heading"></a></h1>
+</section>
+
+
+           </div>
+          </div>
+          <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
+        <a href="index.html" class="btn btn-neutral float-left" title="Welcome to first_control’s documentation!" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="instrument_principle.html" class="btn btn-neutral float-right" title="Instrument presentation" 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>
diff --git a/source/_build/_images/Betelgeuse_mean_img.png b/source/_build/_images/Betelgeuse_mean_img.png
diff --git a/source/_build/_images/HIP84893_processed.png b/source/_build/_images/HIP84893_processed.png
diff --git a/source/_build/_images/PL_img_hardware.png b/source/_build/_images/PL_img_hardware.png
diff --git a/source/_build/_images/SK_processed.png b/source/_build/_images/SK_processed.png
diff --git a/source/_build/_images/save_telemetry.png b/source/_build/_images/save_telemetry.png
diff --git a/source/_build/_sources/Intro.md.txt b/source/_build/_sources/Intro.md.txt
@@ -0,0 +1 @@
+# Introduction
diff --git a/source/_build/_sources/camera_control.md.txt b/source/_build/_sources/camera_control.md.txt
@@ -0,0 +1,31 @@
+# Camera control
+
+## Change camera parameters
+Enter in the tmux session `fircam_ctrl`
+- Change exposure time : `set_tint()`
+- Check exposure time : `get_tint()`
+- Change readout mode : `set_readout_mode()` 
+    - Options:
+        - 'FAST' : < 100 ms
+        - 'SLOW' : > 100 ms
+- Change crop size : `set_camera_mode`
+    - Options:
+        - 'FIRSTPL' : For the regular Photonic Lantern mode
+        - 'FIRSTPLWFS' : For the Wavefront sensing mode
+        - 'FIRSTPLSMF' : For imaging of the SMF
+        - 'FULL' : Full frame
+
+## Change data type
+In a terminal, execute the command line `first_datatype DATA_TYPE`,
+with DATA_TYPE being one of the following list:
+- "ACQUISITION"
+- "BIAS"
+- "COMPARISON"
+- "DARK"
+- "DOMEFLAT"
+- "FLAT"
+- "FOCUSING"
+- "OBJECT"
+- "SKYFLAT"
+- "STANDARD"
+- "TEST"
diff --git a/source/_build/_sources/index.rst.txt b/source/_build/_sources/index.rst.txt
@@ -0,0 +1,39 @@
+.. first_control documentation master file, created by
+   sphinx-quickstart on Mon Aug 26 15:50:58 2024.
+   You can adapt this file completely to your liking, but it should at least
+   contain the root `toctree` directive.
+
+Welcome to first_control's documentation!
+=========================================
+
+**Contact:** Sébastien Vievard (vievard@naoj.org)
+
+.. toctree::
+   :maxdepth: 2
+   :caption: Instrument presentation
+
+   Intro
+   instrument_principle
+
+
+.. toctree::
+   :maxdepth: 2
+   :caption: Procedures
+
+   instrument_setup
+
+.. toctree::
+   :maxdepth: 2
+   :caption: Operating FIRST
+
+   camera_control
+   saving_images
+
+
+
+Indices and tables
+==================
+
+* :ref:`genindex`
+* :ref:`modindex`
+* :ref:`search`
diff --git a/source/_build/_sources/instrument_principle.md.txt b/source/_build/_sources/instrument_principle.md.txt
@@ -0,0 +1,27 @@
+# Instrument presentation
+
+The Fibered Imager foR a Single Telescope (FIRST) is a spectro-interferometer operating in the visible wavelengths at a resolution of about 4,000. It is fed by the SCExAO system. FIRST was developed in collaboration with the Paris Observatory.
+
+FIRST feeds a Photonic Lantern device from a focal plane. The Photonic Lantern consists of a multi-mode input slowly transitioning into 19 Single-mode fibers. The multi-mode input’s core has a diameter of 25 micrometers. 
+
+```{image} PL_img_hardware.png
+:width: 500 px
+```
+*Figure 1: Photonic Lantern hardware. The input is a multi-mode fiber, and the outputs are 19 single mode fibers spliced into a V-groove*
+
+
+The 19 outputs of the Photonic Lantern feed a mid resolution spectrograph (R~4,000), optimized for wavelengths ranging from 620 nm to 780 nm. The spectrograph is equipped with a wollaston, allowing to split the polarization for each output, providing a total of 38 spectra (see below). More information on the instrument and its integration on SCExAO are available [here](https://arxiv.org/abs/2407.15412).
+
+```{image} Betelgeuse_mean_img.png
+```
+*Figure 2: Example of imaging of `Aua (Betelgeuse) using the Photonic Lantern. This image is averaged from 200,000 frames, and displays 38 spectra, corresponding to the two polarizations from each of the 19 outputs of the Photonic Lantern.*
+
+## General information
+
+| FIRST parameters |  |  |
+| - | - | - |
+| Operating wavelength | 620 - 780 nm |  |
+| Spectral resolution | R~4,000 |  |
+| Spatial resolution | TBD |  |
+| Field of view | 80 mas @ f/8 | Optimal injection efficiency is for a focal ratio of 8, providing a field of view of 80 mas.The field of view is defined as the area where the injection efficiency drops to 50% compared to the center of the field. |
+| Exposure times | 7.2us - 1800 s. | Fast or Slow readout modes possible |
diff --git a/source/_build/_sources/instrument_setup.md.txt b/source/_build/_sources/instrument_setup.md.txt
@@ -0,0 +1,45 @@
+# Instrument setup
+
+## Send light to the Photonic Lantern
+
+On scexao2 computer, execute <br />
+`first_pickoff in`
+
+## Optimization procedure
+### 1. Start the process of flux recording
+In  /home/first/src/firstctrl/FIRST_photom_control/ run :  <br />
+`python first_pl_flux.py`
+
+### 2. Optimization
+In  /home/first/src/firstctrl/FIRST_photom_control/ run :<br />
+`ipython`  <br />
+`run first_pl_optimization_injection_iocam.py`<br />
+
+#### 2.1 Take a dark
+`pl_inj.acq_dark()`
+- Option :
+    - `vis_block = True/False` (adding the vis block in/out during dark measurement - check with VAMPIRES instrument when using this block)
+
+#### 2.2 Optimize the injection
+`pl_inj.optimization_raster(x0=98997,y0=173268,window_step=1000, channel_opt=0, n_raw=10, npt=19,Target='Your_Target')`
+
+|Injection optimization parameters||
+|-|-|
+| x0 | x coordinate of the center of the window scanned |
+| y0 | y coordinate of the center of the window scanned |
+|window_step| size (in step) of the window scanned |
+|n_raw| number of frames averaged per position |
+|npt| number of samples per window side|
+|Target| name of your target|
+
+The coupling maps are saved in /home/first/Documents/FIRST-DATA/FIRST_PL/Optim_maps/
+They should look like this : 
+
+| On the bench          |  On-sky |
+:-------------------------:|:-------------------------:
+| ![](SK_processed.png)  |  ![](HIP84893_processed.png) |
+
+If the optimization is successful, the 2D gaussian fit will appear clearly on the coupling map image. If not, adjust the (x0,y0) corrdinates according to the coupling map shape (carreful, if the dark is bad, this process does not work properly).
+
+
+
diff --git a/source/_build/_sources/saving_images.md.txt b/source/_build/_sources/saving_images.md.txt
@@ -0,0 +1,14 @@
+# Save data
+
+We use the logshim tool in order to log FIRST data. To setup the saving, type in a terminal :  <br />
+`milk-streamFITSlog -d "/mnt/datazpool/PL/" -z 1000 firstpl pstart`
+
+Then, open the GUI : <br />
+`FPS_FILTSTRING_NAME="FITS" milk-fpsCTRL`
+
+The GUI looks like this:
+![](save_telemetry.png)
+
+
+To start the process : Shift+r <br />
+To stop the process : Ctrl+r <br />