.TH HAWKI_UTIL_GENDIST "7" "1.8.14" "hawki_util_gendist" "hawki recipes"
.SH NAME
hawki_util_gendist \- Distortion map creation

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

.SH DESCRIPTION
hawki_util_gendist \-\- HAWK\-I distortion calibration file creation.
.PP
The 4 files (chip 1 2 3 4) listed in the Set Of Frames (sof\-file) 
must be tagged:
raw\-file_chip1.txt DIST_MAP
raw\-file_chip2.txt DIST_MAP
raw\-file_chip3.txt DIST_MAP
raw\-file_chip4.txt DIST_MAP


.SH OPTIONS
.TP
\fB\-\-dim_x\fR \fI<long>\fR
Dimension of distortion image in X (long; default: 2048). The full name of this option for the EsoRex configuration
file is \fBhawki.hawki_util_gendist.dim_x\fR [default = \fI2048\fR].
.TP
\fB\-\-dim_y\fR \fI<long>\fR
Dimension of distortion image in Y (long; default: 2048). The full name of this option for the EsoRex configuration
file is \fBhawki.hawki_util_gendist.dim_y\fR [default = \fI2048\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\-1.8.14.pdf
.PP
An overview over the existing ESO pipelines can be found on the web page
\fBhttp://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 \fBhttp://packages.python.org/python\-cpl/index.html\fR for further
information.
.PP
The other recipes of the hawki pipeline are
.IR hawki_cal_zpoint (7),
.IR hawki_step_stats (7),
.IR hawki_step_apply_dist (7),
.IR hawki_cal_flat (7),
.IR hawki_step_detect_obj (7),
.IR hawki_util_stdstars (7),
.IR hawki_step_basic_calib (7),
.IR hawki_step_photom_2mass (7),
.IR hawki_cal_dark (7),
.IR hawki_step_compute_bkg (7),
.IR hawki_cal_distortion (7),
.IR hawki_sci_jitter (7),
.IR hawki_tec_filtchk (7),
.IR hawki_step_subtract_bkg (7),
.IR hawki_step_refine_offsets (7),
.IR hawki_step_stitch (7),
.IR hawki_step_combine (7)

.SH VERSION
hawki_util_gendist 1.8.14

.SH AUTHOR
Yves Jung <usd\-help@eso.org>

.SH BUG REPORTS
Please report any problems to usd\-help@eso.org. 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) 2002,2011 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., 51 Franklin Street, Fifth Floor, Boston, 
MA 02110\-1301 USA