NAME

       kmo_fits_strip  -  Strip noise, rotator and/or empty extensions from a processed KMOS fits
       frame

SYNOPSIS

       esorex kmo_fits_strip [OPTIONS] FILE.sof

DESCRIPTION

       With this recipe KMOS fits frames can be stripped in following way:

       --noise All noise extensions will be removed. Only the data extensions remain.

       --angle Applies only to calibration products from kmo_flat and kmo_wave_cal.

       All extensions matching provided angle are kept, the others are removed.

       Supply a single integer value.

       --empty All empty extensions will be removed.

       --extension Supply a comma-separated string with integer values indicating the  extensions
       to  keep.  The other extensions are removed (any data or noise information is disregarded,
       the values are interpreted absolutely)

       The parameters --noise, --angle and --empty can be combined.

       When --extension is specified, all other parameters are ignored.

       When no parameter is provided, no output will be generated.

         Input files:

          DO                    KMOS
          category              Type   Explanation                    Required #Frames
          --------              -----  -----------                    -------- -------
          <none or any>         F2D or frame to strip                     Y       1
                                F3I or
                                F2I or
                                F1I or

         Output files:

          DO                    KMOS
          category              Type   Explanation
          --------              -----  -----------
          STRIP                 F2D or Stripped frame
                                F3I or
                                F2I or
                                F1I

OPTIONS

       --empty <bool>
              TRUE: if empty extensions  shall  be  removed,  FALSE:  otherwise  (bool;  default:
              False).  The  full  name  of  this  option  for  the  EsoRex  configuration file is
              kmos.kmo_fits_strip.empty [default = False].

       --noise <bool>
              TRUE: if noise extensions  shall  be  removed,  FALSE:  otherwise  (bool;  default:
              False).  The  full  name  of  this  option  for  the  EsoRex  configuration file is
              kmos.kmo_fits_strip.noise [default = False].

       --angle <long>
              All extensions not matching provided angle are stripped. (long; default:  -1).  The
              full    name    of   this   option   for   the   EsoRex   configuration   file   is
              kmos.kmo_fits_strip.angle [default = -1].

       --extension <str>
              Comma-separated string with integers. All  extensions  matching  these  values  are
              stripped.  (str;  default:  None).  The  full  name  of  this option for the EsoRex
              configuration file is kmos.kmo_fits_strip.extension [default = None].

       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 kmos pipeline can be downloaded as a  PDF  file  using  the
       following URL:

              ftp://ftp.eso.org/pub/dfs/pipelines/kmos/kmos-pipeline-manual-2.9.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 kmos pipeline are kmo_dev_setup(7), kmo_copy(7), kmo_flat(7),
       kmo_fits_check(7),      kmo_sci_red(7),      kmo_illumination(7),       kmo_fits_stack(7),
       kmo_noise_map(7),     kmo_rotate(7),     kmo_extract_spec(7),    kmo_multi_reconstruct(7),
       kmo_stats(7),    kmo_shift(7),    kmo_wave_cal(7),     kmo_dark(7),     kmo_arithmetic(7),
       kmo_std_star(7),      kmo_combine(7),     kmo_illumination_flat(7),     kmo_make_image(7),
       kmo_sky_tweak(7), kmo_fit_profile(7), kmo_sky_mask(7), kmo_reconstruct(7)

VERSION

       kmo_fits_strip 1.2.8

AUTHOR

       Alex Agudo Berbel <kmos-spark@mpe.mpg.de>

BUG REPORTS

       Please report any problems to kmos-spark@mpe.mpg.de. Alternatively, you may send a  report
       to the ESO User Support Department <usd-help@eso.org>.

LICENSE

       This  file  is  part  of  the  KMOS  Instrument  Pipeline Copyright (C) 2002,2003 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, 51 Franklin Street, Suite 500, Boston, MA
       02110-1335  USA