visir_util_repack(7) 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 in each nod cycle,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].
--planelimit <long>
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. (long; default: -1). The full name of this option for the EsoRex configuration file is visir.visir_util_repack.planelimit [default = -1].
--ncycles <long>
Number of full on-off cycles to repack per nod cycles. <= 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 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].

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.

VERSION

visir_util_repack 4.2.0

AUTHOR

Lars Lundin <[email protected]>

BUG REPORTS

Please report any problems to [email protected] Alternatively, you may send a report to the ESO User Support Department <[email protected]>.

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