---
name: "hawki_cal_distortion"
section: "7"
platform: "linux"
package: "cpl-plugin-hawki-doc"
version: "2.4.11+dfsg-1"
release: "Debian 12 (Bookworm)"
platforms: ["linux"]
url: "https://new.carta.tech/hawki_cal_distortion"
---

# hawki\_cal\_distortion(7)

(OBSOLETE) Distortion autocalibration

## NAME

hawki\_cal\_distortion - (OBSOLETE) Distortion autocalibration

## SYNOPSIS

esorex **hawki\_cal\_distortion** \[OPTIONS\] FILE.sof

## DESCRIPTION

(OBSOLETE) 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** *\<int\>*

  number of points in distortion grid (int; default: 9). The full name of this option for the EsoRex configuration file is **hawki.hawki\_cal\_distortion.grid\_points** \[default = *9*\].

- **--borders** *\<int\>*

  number of pixels to trim at the borders (int; 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-2.4.11.pdf**

An overview over the existing ESO pipelines can be found on the web page **https://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 **https://packages.python.org/python-cpl/index.html** for further information.

The other recipes of the hawki pipeline are [*hawki\_cal\_dark*(7)](/hawki_cal_dark/7.md), [*hawki\_cal\_flat*(7)](/hawki_cal_flat/7.md), [*hawki\_cal\_zpoint*(7)](/hawki_cal_zpoint/7.md), [*hawki\_dark\_combine*(7)](/hawki_dark_combine/7.md), [*hawki\_detector\_noise*(7)](/hawki_detector_noise/7.md), [*hawki\_linearity\_analyse*(7)](/hawki_linearity_analyse/7.md), [*hawki\_sci\_jitter*(7)](/hawki_sci_jitter/7.md), [*hawki\_science\_postprocess*(7)](/hawki_science_postprocess/7.md), [*hawki\_science\_process*(7)](/hawki_science_process/7.md), [*hawki\_standard\_process*(7)](/hawki_standard_process/7.md), [*hawki\_step\_apply\_dist*(7)](/hawki_step_apply_dist/7.md), [*hawki\_step\_basic\_calib*(7)](/hawki_step_basic_calib/7.md), [*hawki\_step\_combine*(7)](/hawki_step_combine/7.md), [*hawki\_step\_compute\_bkg*(7)](/hawki_step_compute_bkg/7.md), [*hawki\_step\_detect\_obj*(7)](/hawki_step_detect_obj/7.md), [*hawki\_step\_photom\_2mass*(7)](/hawki_step_photom_2mass/7.md), [*hawki\_step\_refine\_offsets*(7)](/hawki_step_refine_offsets/7.md), [*hawki\_step\_stats*(7)](/hawki_step_stats/7.md), [*hawki\_step\_stitch*(7)](/hawki_step_stitch/7.md), [*hawki\_step\_subtract\_bkg*(7)](/hawki_step_subtract_bkg/7.md), [*hawki\_tec\_filtchk*(7)](/hawki_tec_filtchk/7.md), [*hawki\_twilight\_flat\_combine*(7)](/hawki_twilight_flat_combine/7.md), [*hawki\_util\_gendist*(7)](/hawki_util_gendist/7.md), [*hawki\_util\_stdstars*(7)](/hawki_util_stdstars/7.md)

## VERSION

hawki\_cal\_distortion 2.4.11

## AUTHOR

ESO Pipeline Group \<https://support.eso.org\>

## BUG REPORTS

Please report any problems to https://support.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
