%modified Arto's version. LK, Feb 28, 2018 
\documentclass[10pt,headinclude]{scrartcl}
\usepackage[left=2.5cm,right=2.5cm,top=3.5cm,bottom=3.5cm,headheight=1cm,headsep=1cm,a4paper]{geometry}
\setlength{\parindent}{0cm}
\usepackage{scrpage2} % replaces \usepackage{fancyhdr}
\usepackage{graphicx}
%\usepackage{eurofont} 
%\usepackage{times}%Postscript fonts
\usepackage[utf8]{inputenc} % f?r Umlaute
\usepackage[T1]{fontenc} % alternativ \usepackage{lmodern}
%\usepackage[ngerman]{babel}
\usepackage{textcomp}
\usepackage{lmodern}
\usepackage{eurosym}
\usepackage{lastpage}
\usepackage{mdframed} % for framed boxes
\usepackage[pdftex]{hyperref}
\usepackage{tabularx} % table with page width
\usepackage[table]{xcolor}

\hypersetup{
  linktocpage=true,
  colorlinks=true, %{colorlinks=false} for printing
  urlcolor=blue,
  linkcolor=blue,
  menucolor=blue,
%  pdftitle={GREGOR: Pflichtenheft Dachsteuerung},
%  pdfauthor={Th. Granzer},
 % pdfsubject={Pflichtenheft},
  pdfcreator=pdfTeX,
 % pdfproducer={Th. Granzer},
 % pdfkeywords={Dachsteuerung} {Gregor} {Pflichtenheft}
  }
   
  
%############################################### 
%----------- set variables here -------------------
\newcommand{\vers}{4}
\newcommand{\docno}{GRE-KIS-CL-0007}
\newcommand{\docdate}{1.7.2020}
\newcommand{\doctitle}{GREGOR AO Quickstart}
\newcommand{\docauthor}{T. Berkefeld} %specify author's name
\newcommand{\docrev}{L. Kleint}    %specify reviewer's name

%###############################################


\title{GREGOR: \doctitle}
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%%%   
%%%      The Pageheader.
%%%
\pagestyle{scrheadings}
\renewcommand{\headfont}{\normalfont} % not italics
\renewcommand{\footfont}{\normalfont} % not italics
%\setlength{\headheight}{25mm}
\ihead{\textbf{AIP  \\  KIS \\ MPS} } 
\ohead{\begin{tabular}{ l r@{\hskip0pt} }  Doc. No. & \docno \\  
   Version: & \vers  \\    
    Date: & \docdate \end{tabular}}
\ifoot{\doctitle}
\cfoot{Page \thepage /\pageref*{LastPage}\strut}
\ofoot{\raisebox{-3ex}{\begin{tabular}[t]{rr}
Prepared by: \docauthor \\ 
Reviewed by: \docrev
\end{tabular}}}
\setheadsepline[\textwidth]{0.4pt} % Trennlinie unter Kopfzeile
\setfootsepline[\textwidth]{0.4pt} %

%%%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%


\begin{document}

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%%%
%%%    First page
%%%
%\thispagestyle{empty}

\newcolumntype{Y}{>{\raggedleft\arraybackslash}X}
\begin{center}
\vspace{3cm} 
\large 
\begin{tabularx}{\textwidth}{p{0.6\textwidth} Y}
\textbf{Checklist: \doctitle}\qquad \qquad \qquad & \textbf{\docno} \\[1.6ex]
\end{tabularx} 
\end{center}


{\Large\centerline{Prerequisites}}
\begin{itemize}
\setlength\itemsep{0em}
\item Telescope is open and pointing to the Sun
\item M1-cover is open. Cover above AO table is open $\rightarrow$ light on AO bench
\end{itemize}
\vspace{3mm}

{\Large\centerline{Telescope adjustments}}
\begin{itemize}
\setlength\itemsep{0em}
\item use 74'' oder 100'' aperture stop in F3
\item enable the F3 guider to illuminate the F3 stop evenly
\item assistant: turn on the HV-Rack (on power strip on the back of the rack)
\item start the AO software: on the flightstation double click on \textit{GREGOR AO}. The AO GUI will appear.
\item in AO-GUI: if necessary, adjust the light level for the wavefront sensor (via \textit{ND filter wheel}). After starting the AO the wavefront sensor image will 
most likely be NOT at maximum intensity, contrary to the GUI motor display.
\item in AO-GUI: Enable the M11 pupil correction (\textit{Pupil to DM Alignment...}). It takes 1-2 minutes until the beam is centered on the DM. Afterward return to the main menu (\textit{back to main}).
\item focus using M2 (z axis) until the image on a science camera has the highest contrast or use the values from the table on the wall of the observing rooms.
\item Press \textit{Rest TT-Mirror}. This puts the TT in its middle position.
\end{itemize}
\vspace{2mm}

{\Large\centerline{Start AO }}
\begin{itemize}
\setlength\itemsep{0em}
\item start the flatfield mode of the telescope
\item in AO-GUI: \textit{take flats...} on top left, then click on \textit{take flats} on bottom left. When finished, \textit {back to main menu}
\item turn off flatfield mode of the telescope
\item move target into F3
\item in AO-GUI: \textit{run AO} enters the submenu for the correction
\item Make sure the following options are selected: \textit{pore/sunspot; pupil to DM alignment}. The others should be off when locking on a target (or any F3 insert).
\item Enable \textit{TipTilt correction} first, then \textit{AO correction}. The AO should correct 160 modes and run stable (image of the DM should only vary minimally)
\item \textit{no correction} turns the AO off. The AO is now ready. The focus (M2-z) has to be refined later when locking on the Sun.
\end{itemize}
\vspace{3mm}

\newpage
{\Large\centerline{During Observations}}
\begin{itemize}
\setlength\itemsep{0em}
\item the AO now controls the number of corrected modes automatically as a function of r0 and whether granulation or sunspots are observed (enable \textit{auto setting of \#modes}). Therefore, it is no longer 
necessary to change the number of corrected modes manually. However, in order to achieve a better correction quality, the number of corrected modes can still be set manually (switch off 
\textit{auto setting of \#modes}), at the cost of a slightly reduced stability of the AO control loop. When granulation is selected, the reference image is periodically updated automatically, in case of pore/sunspot it is not updated automatically.
%\item subapertures with a bad correlation function can be switched off during closed loop: Just click into the subapertures (NOT the correlation functions) you do not want to use and press
%\textit{don't use marked subaps} at the end. The boxes around the decativated subapertures will then turn red, and the deactivated subapertures will not be used. Will be automated at the end of the year. 
\item take flats regularly (e.g. every 2 hours)
\item The following checkboxes should be set:
\begin{itemize}
\item auto setting of \#modes
\item focus offloading to M2 (adjusts the M2 focus automatically). Only use this sporadically when the focus needs to be adjusted ($> 4$ rad) and switch if off afterwards.
\item Pupil to DM alignment (aligns the pupil on the DM via M11)
\item TT-offloading to telescope (moves the telescope if the TT displacement becomes too large)
\item If the derotator is in the beam, then (ONLY then) activate the \textit{derotator in beam} checkbox! 
\end{itemize}
\item when observing
\begin{itemize}
\item sunspots / pores: they must be well centered inside the wavefront sensor before switching on the tip-tilt correction (\textit{TipTilt correction}).
\item granulation: In case of bad seeing press \textit{update reference image} until the correlation functions look acceptable.
\end{itemize}
\item when the tip tilt mirror hits its end of range, the AO switches itself off (\textit{no correction}).
\end{itemize}

{\Large\centerline{Attention}}
\begin{itemize}
\item During FindCenter (started from the conductor) the M11 pupil to DM alignment and the tip-tilt offloading have to  be switched off.
\item sometimes the DCP connection hangs (no M11 pupil guiding correction steps, no database entries): In this case exit the AO software and restart it.
\item when locking the AO on a target: deactivate the automated tip-tilt offloading and deactivate focus offloading to M2.
\item Due to the M2 hexapod failure, we would like to avoid continuous commands to M2. Please only check the M2z focusing checkbox when necessary and deactivate it when optimal focus is found.
\end{itemize}

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

\newpage
\textbf{\Large Deutsch}

{\Large\centerline{Voraussetzung}}
\begin{itemize}
\setlength\itemsep{0em}
\item Teleskop ist offen und auf die Sonne ausgerichtet
\item M1-cover ist offen, Klappe \"uber der AO-Bank ist offen $\rightarrow$ Licht auf der AO-Bank
\end{itemize}
\vspace{3mm}

{\Large\centerline{Teleskopjustage}}
\begin{itemize}
\setlength\itemsep{0em}
\item 74'' oder 100'' Feldblende in den F3 fahren
\item F3-Guider einschalten, sodass die F3-Blende zentrisch ausgeleuchtet ist
\item Assistent: HV-Rack einschalten (an der Steckerleiste hinten im Rack)
\item AO-Software starten: an der Flightstation auf \textit{GREGOR AO} doppelklicken, es erscheint das AO-GUI
\item im AO-GUI: wenn n\"otig Helligkeit f\"ur den Wellenfrontsensor richtig einstellen (via \textit{ND filter wheel} in der Mitte). Nach dem Start der AO ist die Helligkeit entgegen der GUI-Anzeige meistens NICHT maximal. 
\item im AO-GUI: M11 Nachf\"uhrung einschalten (\textit{Pupil to DM Alignment...}). Es dauert 1-2 Minuten bis der Strahl zentrisch auf dem DM sitzt. Danach mit \textit{back to main} wieder ins Hauptmen\"u wechseln.
\item den Fokus mit M2 (z-Achse) so einstellen, dass das Bild auf der Science-Kamera am wenigsten unscharf ist, oder anhand der im Beobachtungsraum aush\"angenden Tabelle.
\item \textit{Reset TT-Mirror} dr\"ucken. Dies stellt den TT in seine Mittenposition.
\end{itemize}
\vspace{2mm}

{\Large\centerline{AO starten}}
\begin{itemize}
\setlength\itemsep{0em}
\item Flatfield-Modus des Teleskopes starten
\item im AO-GUI: Flatfields aufnehmen (\textit{take flats...} links oben, dann \textit{take flats...} links unten, am Ende \textit{back to main menu})
\item Flatfield-Modus des Teleskopes wieder ausschalten
\item Target in den F3 fahren
\item im AO-GUI: {\textit run AO} startet das Untermen\"u f\"ur die Korrektur.
\item Vergewissern, dass folgende Optionen angew\"ahlt sind: \textit{pore/sunspot; pupil to DM alignment}. Die anderen sollen aus sein, wenn man auf das Target (oder sonst etwas im F3) lockt.
\item erst \textit{TipTilt correction}, dann \textit{AO correction} einschalten. Die AO sollte 160 Moden korrigieren und stabil laufen (Grafik des DMs schwankt nur ganz wenig)
\item \textit{no correction} schaltet die AO wieder aus. Die AO ist jetzt betriebsbereit. Der Fokus (M2-z) muss sp\"ater beim Locken auf die Sonne aber noch genauer eingestellt werden.
\end{itemize}
\vspace{3mm}

\newpage
{\Large\centerline{W\"ahrend der Beobachtung}}
\begin{itemize}
\setlength\itemsep{0em}
\item Die AO regelt inzwischen die Anzahl der korrigierten Moden automatisch (\textit{auto setting of \#modes} einschalten), anhand von r0 und ob Granulation oder Sonnenflecken beobachtet werden. Daher muss die Anzahl der Moden nicht mehr von Hand eingestellt werden. F\"ur optimale Korrekturqualit\"at kann das automatische Setzen der Moden ausgeschaltet werden 
(\textit{auto setting of \#modes} aus), auf Kosten einer etwas geringeren Stabilit\"at. Bei Granulation wird auch das Referenzbild automatisch periodisch aktualisiert, bei pore/sunspot nicht.
%\item Subaperturen mit einer schlechten Korrelationsfunktion k\"onnen ausgeschaltet werden w\"ahrend die Regelschleife l\"auft: die schlechten Subaperturen im Bild, nicht in den Korrelationsfunktionen, 
%anklicken und am Ende \textit{don't use marked subaps} anklicken. Die Quadrate um die ausgew\"ahlten Subaperturen werden rot, die Messungen dieser Subaperturen dann nicht verwendet, was die Korrektur stabiler macht. Dies wird im Laufe des Jahres noch automatisiert. 
\item regelm\"a\ss ig (z.B. alle 2 Stunden) Flatfields aufnehmen
\item Folgende Checkboxen sollten eingeschaltet sein:
\begin{itemize}
\item auto setting of \#modes
\item focus offloading to M2 (korrigiert den M2 Fokus selbst\"andig). Diese Funktion sollte nur sporadisch ben\"utzt werden, wenn der Fokus korrigiert werden muss ($> 4$ rad) und danach wieder ausgeschaltet werden.
\item Pupil to DM alignment (korrigiert die Pupillenposition auf dem DM via M11)
\item TT-offloading to telescope (f\"ahrt das Teleskop nach, wenn die TT Auslenkung zu gross wird)
\item Falls der Derotator im Strahlengang ist, dann (und nur dann) muss au\ss erdem auch \textit{derotator in beam} aktiviert sein.
\end{itemize}
\item bei Beobachtung von
\begin{itemize}
\item Sonnenflecken oder Poren: diese m\"ussen vor dem Einschalten der TipTilt-Korrektur (\textit{TipTilt correction}) m\"oglichst zentrisch im Wellenfrontsensor sein.
\item Granulation: Bei schlechtem Seeing u.U. mehrmals \textit{update reference image} dr\"ucken bis die Korrelationsfunktionen brauchbar sind. 
\end{itemize}
%\item Fokus (M2-z) muss regelm\"assig nachgestellt werden (s. GUI-Anzeige), wird im Laufe des Jahres noch automatisiert. 
\item Wenn der TipTilt an den Anschlag l\"auft, schaltet sich die AO ab !
\end{itemize}

{\Large\centerline{Achtung}}
\begin{itemize}
\item Bei FindCenter (Start im Conductor) m\"ussen das pupil to DM alignment und das Offloading des TipTilt ausgeschaltet sein !
\item manchmal h\"angt die DCP-Verbindung (keine M11-Korrektur, keine Datenbankeintr\"age): dann die AO-Software verlassen und neu starten
\item beim Locken auf das Target sollte das automatische TipTilt-Offloading und das focus offloading to M2 ausgeschaltet sein
\item Wegen des M2 Hexapod Problems, m\"ochten wir st\"andige Kommandos an M2 verhindern. Bitte deswegen die Checkbox f\"ur den Fokus nur ben\"utzen wenn n\"otig und dann wieder ausschalten.

\end{itemize}


\newpage


%\pagenumbering{roman}  

\ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \  \\
\textbf{Warnings/Notes}

<none>

\vspace{0.8cm}
\renewcommand{\arraystretch}{1.2}
\begin{tabularx}{\textwidth}{| p{0.8cm} | p{1.5cm} | p{2.3cm} | X | p{2cm} |}
%\begin{tabular}{| ccccc |}
\hline
\rowcolor{lightgray}\multicolumn{5}{| p{15.55cm} |}{Change Log} \\
%15.55 found manually, \textwidth is too large
\hline
{Vers.} & {Date} & {Author} & {Description of Changes} & Sect./Para.  \\
\hline 
1 &  14.4.2018  &   T. Berkefeld    & New Document & \\ 
\hline
 2   & 16.8.2018              &     T. Berkefeld            &  automatic mode correction, TT offloading, WFS intensity, warnings. & all \\
\hline
 3   & 14.8.2019              &     T. Berkefeld            &  minor additions automatic mode correction, TT offloading. ``do not use marked supaps''. Automatic shutoff of TT. & all \\ 
 \hline   
4   & 6.7.2020              &     L. Kleint           &  Major change for new AO GUI & all \\ 
 \hline   
\end{tabularx}
\renewcommand{\arraystretch}{1}


 
\end{document}




