Provided by: cpl-plugin-hawki-doc_1.8.18+dfsg-5_all bug


       hawki_cal_distortion - Distortion autocalibration


       esorex hawki_cal_distortion [OPTIONS] FILE.sof


       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


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


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


       An  overview  over  the  existing  ESO  pipelines  can  be   found   on   the   web   page

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


       hawki_cal_distortion 1.8.18


       Cesar Enrique Garcia Dabo <>


       Please  report  any  problems to Alternatively, you may send a report to
       the ESO User Support Department <>.


       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