NAME

       visir_util_repack - Conversion of raw CUBE2 or BURST images to on- and off-cubes

SYNOPSIS

       esorex visir_util_repack [OPTIONS] FILE.sof

DESCRIPTION

       The files listed in the Set Of Frames (sof-file) must be tagged: VISIR-CUBE2-raw-file.fits
       CUBE2 or VISIR-BURST-raw-file.fits BURST VISIR-BURST-bpm-file.fits STATIC_MASK  For  BURST
       data  it  will  remove  planes  where  the  chopper  switched from on <-> off based on the
       timestamps in the header.

       The product(s) will have a FITS card ´HIERARCH ESO PRO CATG´  with  a  value  of  one  of:
       IMG_REPACKED_A_ON  (NodPos:  A,  ChopPos: on) IMG_REPACKED_A_OFF (NodPos: A, ChopPos: off)
       IMG_REPACKED_B_ON (NodPos: B, ChopPos: on) IMG_REPACKED_B_OFF (NodPos:  B,  ChopPos:  off)
       For  CUBE2,  the  recipe  will  produce  a  static bad-pixel map, it will have a FITS card
       ´HIERARCH ESO PRO CATG´ with a value of: STATIC_MASK

OPTIONS

       --planestart <long>
              Plane number to start repacking from, earlier planes are skipped.  (long;  default:
              0).   The   full  name  of  this  option  for  the  EsoRex  configuration  file  is
              visir.visir_util_repack.planestart [default = 0].

       --ncycles <long>
              Number of full on-off cycles to repack. <= 0 for all. (long; default: -1). The full
              name    of    this    option    for    the    EsoRex    configuration    file    is
              visir.visir_util_repack.ncycles [default = -1].

       --trimlow <long>
              Burst data only. Number of additional planes to cut from  before  each  plane  with
              chopper  movement.  (long; default: 0). The full name of this option for the EsoRex
              configuration file is visir.visir_util_repack.trimlow [default = 0].

       --trimhigh <long>
              Burst data only. Number of additional planes to cut  from  after  each  plane  with
              chopper  movement.   A  value of -1 does not skip the plane of the movement. (long;
              default: 0). The full name of this option for  the  EsoRex  configuration  file  is
              visir.visir_util_repack.trimhigh [default = 0].

       --bkgcorrect <str>
              Output  background  corrected  planes  by  subtracting  chop (on/off) and nod (A/B)
              planes  Options:  none: no correction  chop: on - off chopnod: (Aon - Aoff) -  (Bon
              -  Boff)  (str;  default:  ´none´).  The  full  name  of this option for the EsoRex
              configuration file is visir.visir_util_repack.bkgcorrect [default = none].

       --normalize <bool>
              Normalize planes by DIT (bool; default: True). The full name of this option for the
              EsoRex configuration file is visir.visir_util_repack.normalize [default = True].

       --compress <bool>
              Apply  lossless  compression  on  outputfiles.  Can  only be done for integer  type
              results. (bool; default: False). The full  name  of  this  option  for  the  EsoRex
              configuration file is visir.visir_util_repack.compress [default = False].

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

              ftp://ftp.eso.org/pub/dfs/pipelines/visir/visir-pipeline-manual-1.4.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  visir  pipeline  are   visir_img_dark(7),   visir_img_ff(7),
       visir_img_reduce(7),  visir_img_trans(7), visir_old_img_combine(7), visir_old_img_phot(7),
       visir_old_spc_obs(7),           visir_old_spc_obs_ech(7),           visir_old_spc_phot(7),
       visir_old_spc_phot_ech(7),        visir_old_spc_wcal(7),        visir_old_spc_wcal_ech(7),
       visir_old_util_destripe(7),        visir_spc_reduce(7),         visir_util_apply_calib(7),
       visir_util_clip(7),        visir_util_convert_weight(7),       visir_util_detect_shift(7),
       visir_util_img_std_cat(7), visir_util_join(7), visir_util_qc(7),  visir_util_run_swarp(7),
       visir_util_spc_std_cat(7), visir_util_spc_txt2fits(7), visir_util_undistort(7)

VERSION

       visir_util_repack 4.1.0

AUTHOR

       Lars Lundin <llundin@eso.org>

BUG REPORTS

       Please report any problems to llundin@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 VISIR Instrument Pipeline Copyright (C)  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 St, Fifth Floor,  Boston,
       MA  02111-1307  USA