From 548cc56e7b65184d1e10a26711837e18f189c136 Mon Sep 17 00:00:00 2001
From: Blaise Thompson <blaise@untzag.com>
Date: Fri, 30 Mar 2018 20:31:53 -0500
Subject: 2018-03-30 20:31

---
 acquisition/chapter.tex | 70 ++++++++++++++++++++++++++++++++++++++++---------
 1 file changed, 58 insertions(+), 12 deletions(-)

(limited to 'acquisition/chapter.tex')

diff --git a/acquisition/chapter.tex b/acquisition/chapter.tex
index 6805150..fe3c4da 100644
--- a/acquisition/chapter.tex
+++ b/acquisition/chapter.tex
@@ -82,12 +82,15 @@ Users cannot type values outside of hardware limits into the controls.  %
 
 The large right-hand section is tabbed...
 
+\begin{landscape}
 \begin{figure}
+	\includegraphics[scale=0.5]{"acquisition/screenshots/005"}
   \caption{
-    TODO (PyCMDS screenshot, including limits in tool tip)
+    TODO (PyCMDS screenshot)
   }
   \label{aqn:fig:pycmds_screenshot}
 \end{figure}
+\end{landscape}
 
 To perform an acquisition, a user goes to the SOMATIC tab and enters an item into the QUEUE...
 
@@ -96,12 +99,15 @@ Progress bar...
 Cannot hit SET...
 QUEUE states...
 
+\begin{landscape}
 \begin{figure}
+  \includegraphics[width=9in]{"acquisition/screenshots/000"}
   \caption{
-    TODO (PyCMDS screenshot while acquiring a 2D delay scan)
+    TODO (PyCMDS screenshot while acquiring data)
   }
   \label{aqn:fig:pycmds_screenshot_during_scan}
 \end{figure}
+\end{landscape}
 
 \section{Structure}  % ============================================================================
 
@@ -428,12 +434,15 @@ The delay GUI, by default, offers
   \item \python{on_set_zero}
 \end{ditemize}
 
+\begin{landscape}
 \begin{figure}
+ 	\includegraphics[width=9in]{"acquisition/screenshots/006"}
   \caption[Representative delay stage advanced menu.]{
     CAPTION TODO
   }
   \label{aqn:fig:delay_advanced}
 \end{figure}
+\end{landscape}
 
 \subsection{Spectrometers}  % ---------------------------------------------------------------------
 
@@ -449,12 +458,15 @@ Driver:
 
 GUI:
 
+\begin{landscape}
 \begin{figure}
-  \caption[Representative delay stage advanced menu.]{
+  \includegraphics[width=9in]{"acquisition/screenshots/007"}
+  \caption[Representative spectrometer advanced menu.]{
     CAPTION TODO
   }
   \label{aqn:fig:spectrometer_advanced}
 \end{figure}
+\end{landscape}
 
 \subsection{OPAs}  % ------------------------------------------------------------------------------
 
@@ -472,12 +484,15 @@ United
 
 Interpolation
 
+\begin{landscape}
 \begin{figure}
-  \caption[Representative delay stage advanced menu.]{
+ 	\includegraphics[width=9in]{"acquisition/screenshots/008"}
+  \caption[Representative OPA advanced menu.]{
     CAPTION TODO
   }
   \label{aqn:fig:opa_advanced}
 \end{figure}
+\end{landscape}
 
 \subsection{Filters}  % ---------------------------------------------------------------------------
 
@@ -507,8 +522,9 @@ Old boxcar: 300 ns window, ~10 micosecond delay. Onset of saturation ~2 V.
 % TODO: poweramp tune test  (see darien slack)
 
 \begin{figure}
+  \includegraphics[scale=0.5]{"acquisition/tune_test"}
   \caption[Array detector serving as an axis.]{
-    CAPTION TODO
+    CAPTION TODO (2017-11-06 OPA2)
   }
   \label{aqn:fig:array_as_axis}
 \end{figure}
@@ -550,19 +566,49 @@ This is where the fun stuff happens---the acquisitions!
 
 \subsection{Acquisition modules}  % ---------------------------------------------------------------
 
-% TODO: the aqn file (show one!)
+Acquisition modules are defined interfaces which know how to assemble a scan.  %
+
+\autoref{aqn:fig:aqn_file} shows an aqn file for an acquisition using SCAN.  %
+
+\begin{figure}
+  \includebash{"acquisition/example.aqn"}
+  \caption[Example aqn file.]{
+    CAPTION TODO
+  }
+  \label{aqn:fig:aqn_file}
+\end{figure}
+
+\subsubsection{SCAN}
+
+SCAN is by far the most important acquisition module in PyCMDS---it handles acquisitions for almost
+all of the CMDS experiments that PyCMDS has ever accomplished.  %
+SCAN is capable of acquisitions of arbitrary dimensionality.  %
+Users simply append as many axes as they want.  %
+Acquistions are done with the trailing (highest index) axis as the innermost loop.  %
+Arbitrary expressions (PyCMDS calls them ``constants'') are also possible, as can be seen in
+\autoref{aqn:fig:aqn_file}.  %
+
+\subsubsection{TUNE TEST}
+
+The TUNE TEST module does a simple thing: it sets a chosen OPA to each of the points in it's tuning
+curve and does a monochromator scan of set width about that setpoint.  %
+In this way the tune (output color) agreement between the curve and the OPA can be determined.  %
+As a convinience, a new point curve with remapped colors is automatically created.  %
+% TODO: link to place in tuning chapter...
+
+\subsubsection{MOTORTUNE}
 
-% TODO: list of modules, descriptions thereof
+Arbitrary tuning acquisitions.
 
-\subsubsection{Scan}
+\subsubsection{AUTOTUNE}
 
-\subsubsection{AutoTune}
+Automatically do appropriate scans and process as in chapter...
 
-\subsubsection{MotorTune}
+\subsubsection{POYNTING TUNE}
 
-\subsubsection{PoyntingTune}
+Dedicated to poynting (get content from Kyle S)...
 
-\subsection{Queue manager}  % ---------------------------------------------------------------------
+z\subsection{Queue manager}  % ---------------------------------------------------------------------
 
 \subsection{The central loop of PyCMDS}  % --------------------------------------------------------
 
-- 
cgit v1.2.3

