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 <int>
              Plane number to start repacking from in each nod cycle,earlier planes are  skipped.
              (int;  default:  0). The full name of this option for the EsoRex configuration file
              is visir.visir_util_repack.planestart [default = 0].

       --planelimit <int>
              Limit number of processed inputplanes. It will repack until at least this number of
              input images have been processed or the full dataset has been repacked. Always full
              chop cycles need to be repacked so the  number  is  adjusted  upward  to  the  next
              multiple of images per chop cycle.  <= 0 for no limit. (int; default: -1). The full
              name    of    this    option    for    the    EsoRex    configuration    file    is
              visir.visir_util_repack.planelimit [default = -1].

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

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

       --trimhigh <int>
              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.  (int;
              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 output files. 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].

       --lincorrect <bool>
              Apply linearity correction. Should only be enabled on high flux  observations,  may
              degrade results otherwise. (bool; default: False). The full name of this option for
              the EsoRex configuration  file  is  visir.visir_util_repack.lincorrect  [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
       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  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.4.2

AUTHOR

       Lars Lundin <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 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