xenial (7) visir_util_repack.7.gz

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