NAME

       hawki_step_subtract_bkg - Background subtraction utility

SYNOPSIS

       esorex hawki_step_subtract_bkg [OPTIONS] FILE.sof

DESCRIPTION

       hawki_step_subtract_bkg -- hawki background subtraction utility.

       This recipe will subtract the given background to the science images.

       The   background   can   be   obtained   from   the   sky   or  object  images  using  the
       hawki_util_compute_bkg utility.

       There are two modes of operation: One single background image that it is subtracted to all
       object images.

       As many background images as objects. A one to one relationship is applied.

       The  files  listed in the Set Of Frames (sof-file) must be tagged: obj_basic_cal-file.fits
       BASIC_CALIBRATED or background-file.fits BKG_IM

OPTIONS

       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_distortion(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_tec_filtchk(7),  hawki_util_gendist(7),
       hawki_util_stdstars(7)

VERSION

       hawki_step_subtract_bkg 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