.TH HAWKI_LINEARITY_ANALYSE "7" "2.4.8" "hawki_linearity_analyse" "hawki recipes"
.SH NAME
hawki_linearity_analyse \- HAWKI linearity recipe

.SH SYNOPSIS
esorex
.B hawki_linearity_analyse
[OPTIONS] FILE.sof

.SH DESCRIPTION
hawki_linearity_analyse \-\- HAWKI detector linearity recipe.
.PP

Check the linearity of the HAWKI detectors on a pixel by pixel basis
The program accepts the following files in the SOF:

    Tag                   Description
    
    DARK_DETCHECK         A list of dark images 
    FLAT_LAMP_DETCHECK    A list of dome flat images
All of the above are required. The should be a dark frame for each DIT/NDITcombination used for the dome flats



.SH OPTIONS
.TP
\fB\-\-order\fR \fI<int>\fR
Polynomial order to fit (int; default: 3). The full name of this option for the EsoRex configuration
file is \fBhawki.hawki_linearity_analyse.order\fR [default = \fI3\fR].
.TP
\fB\-\-fitzero\fR \fI<bool>\fR
Fit zeroth order term? (bool; default: False). The full name of this option for the EsoRex configuration
file is \fBhawki.hawki_linearity_analyse.fitzero\fR [default = \fIFalse\fR].
.TP
\fB\-\-rchithr\fR \fI<float>\fR
Maximum allowable value of reduced chisq? (float; default: 5.0). The full name of this option for the EsoRex configuration
file is \fBhawki.hawki_linearity_analyse.rchithr\fR [default = \fI5.0\fR].
.TP
\fB\-\-satlim\fR \fI<float>\fR
Saturation limit? (float; default: 65535.0). The full name of this option for the EsoRex configuration
file is \fBhawki.hawki_linearity_analyse.satlim\fR [default = \fI65535.0\fR].
.TP
\fB\-\-reflev\fR \fI<float>\fR
Reference flux level for NL check (float; default: 10000.0). The full name of this option for the EsoRex configuration
file is \fBhawki.hawki_linearity_analyse.reflev\fR [default = \fI10000.0\fR].

.PP
Note that it is possible to create a configuration file containing these
options, along with suitable default values. Please refer to the details
provided by the 'esorex \-\-help' command.

.SH SEE ALSO
The full documentation for the hawki pipeline can be downloaded as 
a PDF file using the following URL:
.IP
.B ftp://ftp.eso.org/pub/dfs/pipelines/hawki/hawki\-pipeline\-manual\-2.4.8.pdf
.PP
An overview over the existing ESO pipelines can be found on the web page
\fBhttps://www.eso.org/sci/software/pipelines/\fR.
.PP
Basic documentation about the EsoRex program can be found at the esorex (1) 
man page.
.PP
It is possible to call the pipelines from python using the python\-cpl package.
See \fBhttps://packages.python.org/python\-cpl/index.html\fR for further
information.
.PP
The other recipes of the hawki pipeline are
.IR hawki_cal_dark (7),
.IR hawki_cal_distortion (7),
.IR hawki_cal_flat (7),
.IR hawki_cal_zpoint (7),
.IR hawki_dark_combine (7),
.IR hawki_detector_noise (7),
.IR hawki_sci_jitter (7),
.IR hawki_science_postprocess (7),
.IR hawki_science_process (7),
.IR hawki_standard_process (7),
.IR hawki_step_apply_dist (7),
.IR hawki_step_basic_calib (7),
.IR hawki_step_combine (7),
.IR hawki_step_compute_bkg (7),
.IR hawki_step_detect_obj (7),
.IR hawki_step_photom_2mass (7),
.IR hawki_step_refine_offsets (7),
.IR hawki_step_stats (7),
.IR hawki_step_stitch (7),
.IR hawki_step_subtract_bkg (7),
.IR hawki_tec_filtchk (7),
.IR hawki_twilight_flat_combine (7),
.IR hawki_util_gendist (7),
.IR hawki_util_stdstars (7)

.SH VERSION
hawki_linearity_analyse 2.4.8

.SH AUTHOR
Jim Lewis <jrl@ast.cam.ac.uk>

.SH BUG REPORTS
Please report any problems to jrl@ast.cam.ac.uk. Alternatively, you may send a report to the ESO User Support Department <usd\-help@eso.org>.

.SH LICENSE
This file is part of the HAWKI Instrument Pipeline
Copyright (C) 2015 European Southern Observatory

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, 
MA  02111\-1307  USA