NAME

       hawki_cal_distortion - Distortion autocalibration

SYNOPSIS

       esorex hawki_cal_distortion [OPTIONS] FILE.sof

DESCRIPTION

       hawki_cal_distortion -- HAWK-I distortion and astrometry autocalibration.

       The  input  files  must  be  tagged:  distortion_field.fits DISTOR_OBS sky_distortion.fits
       DISTOR_SKY   flat-file.fits   FLAT_IM   (optional)   dark-file.fits   DARK_IM   (optional)
       bpm-file.fits BPM (optional)

       The   recipe   creates   as   an  output:  hawki_cal_distortion_distx.fits  (DISTORTION_X)
       hawki_cal_distortion_disty.fits (DISTORTION_Y)

       The  recipe  performs  the  following  steps:  -Basic  calibration  of  astrometry  fields
       -Autocalibration of distortion, using method in A&A 454,1029 (2006)

       Return  code: esorex exits with an error code of 0 if the recipe completes successfully or
       1 otherwise

OPTIONS

       --sigma_det <float>
              detection level (float; default: 6.0). The full name of this option for the  EsoRex
              configuration file is hawki.hawki_cal_distortion.sigma_det [default = 6.0].

       --grid_points <long>
              number  of  points  in  distortion  grid  (long; default: 9). The full name of this
              option for the EsoRex configuration file is  hawki.hawki_cal_distortion.grid_points
              [default = 9].

       --borders <long>
              number  of  pixels to trim at the borders (long; default: 6). The full name of this
              option for the  EsoRex  configuration  file  is  hawki.hawki_cal_distortion.borders
              [default = 6].

       --subtract_linear <bool>
              Subtract a linear term to the solution (bool; default: True). The full name of this
              option       for       the        EsoRex        configuration        file        is
              hawki.hawki_cal_distortion.subtract_linear [default = True].

       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.

SEE ALSO

       The  full  documentation  for the hawki pipeline can be downloaded as a PDF file using the
       following URL:

              ftp://ftp.eso.org/pub/dfs/pipelines/hawki/hawki-pipeline-manual-1.8.18.pdf

       An  overview  over  the  existing  ESO  pipelines  can  be   found   on   the   web   page
       http://www.eso.org/sci/software/pipelines/.

       Basic documentation about the EsoRex program can be found at the esorex (1) man page.

       It  is  possible  to  call  the  pipelines  from python using the python-cpl package.  See
       http://packages.python.org/python-cpl/index.html for further information.

       The  other  recipes  of  the  hawki  pipeline  are  hawki_cal_dark(7),  hawki_cal_flat(7),
       hawki_cal_zpoint(7),             hawki_sci_jitter(7),            hawki_step_apply_dist(7),
       hawki_step_basic_calib(7),        hawki_step_combine(7),        hawki_step_compute_bkg(7),
       hawki_step_detect_obj(7),     hawki_step_photom_2mass(7),    hawki_step_refine_offsets(7),
       hawki_step_stats(7),           hawki_step_stitch(7),           hawki_step_subtract_bkg(7),
       hawki_tec_filtchk(7), hawki_util_gendist(7), hawki_util_stdstars(7)

VERSION

       hawki_cal_distortion 1.8.18

AUTHOR

       Cesar Enrique Garcia Dabo <usd-help@eso.org>

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>.

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