Detector_drl_functions.tex

\subsection{Detector Functions}\label{sec:drl_functions_det}

%---------------------------------------------------------------------
\subsubsection{Determine Dark Frames}\label{drl:det_dark}\label{drl:metis_determine_dark}
\begin{recipedef}
Name: & \DRL{metis_determine_dark} \\
Purpose: & Determine the dark current of the detectors and create dark images\\
Used in recipes: & \REC{metis_det_dark}\\
                 & \REC{metis_det_lingain}\\
%Working remarks: & None \\
%Function Parameters: & None \\
Input: & \texttt{const hdrl\_imagelist *darks} \\
Other inputs: &  combination method (\texttt{median}, \texttt{mean}, \texttt{sigclip},\dots)\\
& parameters for combination method\\
QC outputs: & QC DARK MEAN\\
& QC DARK MEDIAN\\
& QC DARK RMS\\
%Output FITS files: & None \\
Outputs: & \texttt{metis\_image *dark} (\PROD{MASTER_DARK_det})\\
               & \texttt{cpl\_error\_code} \\
General description: & Determination of dark frames for subtraction of dark current \\
Mathematical description: & Median or mean of input images, with sigma clipping \\
Quality assessment: & Through QC parameters \\
Error conditions: & See~\cite{DRLVT}. \\
Unit tests: & See~\cite{DRLVT}. \\
\end{recipedef}

\subsubsection{Flag Deviant Pixels in Dark Frame}\label{drl:update_dark_mask}\label{drl:metis_update_dark_mask}
\begin{recipedef}
Name: & \DRL{metis_update_dark_mask} \\
Purpose: & Flag deviant (hot, cold, bad) pixels in the master dark and update the image mask\\
Used in recipes: & \REC{metis_det_dark}\\
%Working remarks: & None \\
%Function Parameters: & None \\
Input: & \texttt{metis\_image *input} \\ 
Other inputs: & Threshold(s) for deviant pixel detection \\
QC outputs: & QC DARK NHOTPIX\\
& QC DARK NCOLDPIX \\
& QC DARK NBADPIX \\
%Output FITS files: & None \\
Outputs: & \texttt{metis\_image *input} (Updated dark frame mask)\\
               & \texttt{cpl\_error\_code} \\
General description: & Flag deviant (hot/cold/bad) pixels in master dark \\
Mathematical description: & flag pixels outside the provided thresholds \\
Quality assessment: & Through QC parameters \\
Error conditions: & See~\cite{DRLVT}. \\
Unit tests: & See~\cite{DRLVT}. \\
\end{recipedef}

\subsubsection{Non-linearity Correction}\label{drl:metis_img_nonlinear_correction}
\begin{recipedef}
Name: & \DRL{metis_img_nonlinear_correction} \\
Purpose: & Correction for detector non-linearity\\
Used in recipes: & \REC{metis_lm_img_basic_reduce}\\
%Working remarks: & None \\
%Function Parameters: & None \\
Input: & \texttt{metis\_imagelist *input} \\
%Other inputs: & None \\
%QC outputs: & None\\
%Output FITS files: & None \\
Outputs: & \texttt{metis\_imagelist *output}  (Images corrected for non-linearity)\\
                & \texttt{cpl\_error\_code} \\
General description: & Correction of detector non-linearity \\
Mathematical description: & See Section~\ref{rec:metis_det_lingain} \\
Quality assessment: & Through QC parameters \\
Error conditions: & See~\cite{DRLVT}. \\
Unit tests: & See~\cite{DRLVT}. \\
\end{recipedef}

\subsubsection{Crosstalk correction}\label{drl:metis_img_crosstalk_correction}
\begin{recipedef}
Name: & \DRL{metis_img_crosstalk_correction} \\
Purpose: & Correction for detector crosstalk\\
Used in recipes: & \REC{metis_lm_img_basic_reduce}\\
%Working remarks: & None \\
%Function Parameters: & None \\
Input: & \texttt{metis\_imagelist *input} \\
%Other inputs: & None \\
%QC outputs: & None\\
%Output FITS files: & None \\
Outputs: &  \texttt{metis\_imagelist *output} (Images corrected for cross-talk)\\
                & \texttt{cpl\_error\_code} \\
General description: & Correction of detector crosstalk \\
Mathematical description: & See Section~\ref{rec:metis_lm_img_basic_reduce} \\
Quality assessment: & Through QC parameters \\
Error conditions: & See~\cite{DRLVT}. \\
Unit tests: & See~\cite{DRLVT}. \\
\end{recipedef}


\subsubsection{Apply Persistence Correction}\label{drl:metis_apply_persistence_correction}
\begin{recipedef}
Name: & \DRL{metis_apply_persistence_correction} \\
Purpose: & Apply the persistence correction to raw images\\
Used in recipes: & \REC{metis_lm_img_flat}\\
%Working remarks: & None \\
%Function Parameters: & None \\
Input: & \texttt{metis\_imagelist *input} \\
Other inputs: & \PROD{PERSISTENCE_MAP} \\
QC outputs:   & \QC{QC PERSIST COUNT} \\
%Output FITS files: & None \\
Outputs: &  \texttt{metis\_imagelist *output} (Images corrected for persistence)\\
         & \texttt{cpl\_error\_code} \\
General description: & Persistence correction of raw images \\
Mathematical description: & see Section~\ref{sec_persistence_correction} \\
Quality assessment: & Through QC parameters \\
Error conditions: & See~\cite{DRLVT}. \\
Unit tests: & See~\cite{DRLVT}. \\
\end{recipedef}