Provided by: cpl-plugin-naco-doc_4.4.3+dfsg-1build1_all bug

NAME

       naco_img_jitter - Jitter recipe

SYNOPSIS

       esorex naco_img_jitter [OPTIONS] FILE.sof

DESCRIPTION

       naco_img_jitter -- NACO imaging jitter recipe.

       The  files  listed  in  the  Set  Of  Frames (sof-file) must be tagged: NACO-raw-file.fits
       IM_JITTER_OBJ or NACO-raw-file.fits IM_JITTER_SKY or NACO-raw-file.fits POL_JITTER_OBJ  or
       NACO-raw-file.fits    POL_JITTER_SKY    or    NACO-flat-file.fits    MASTER_IMG_FLAT    or
       NACO-bpm-file.fits MASTER_IMG_FLAT_BADPIX or NACO-dark-file.fits NACO_IMG_DARK_AVG

OPTIONS

       --off <str>
              An optional ASCII specification of the offsets in case those in FITS-  headers  are
              missing  or  wrong. The file must consist of one line per object FITS-file and each
              line must consist of two numbers which represent the shift in pixels of that  image
              relative to the first image. The first line should thus comprise two zeros. Correct
              FITS- header offsets mean that the i´th X offset can be  gotten  from  Xoffset_0  -
              Xoffset_i,  where  Xoffset_i is the value of ESO SEQ CUMOFFSETX and likewise for Y.
              (str; default: None). The full name of this option  for  the  EsoRex  configuration
              file is naco.naco_img_jitter.offsets [default = None].

       --objs <str>
              objects  file  (str;  default:  None).  The full name of this option for the EsoRex
              configuration file is naco.naco_img_jitter.objects [default = None].

       --oddeven <bool>
              Apply the odd-even correction. Warning: This flag currently has  no  effect  (bool;
              default:  False). The full name of this option for the EsoRex configuration file is
              naco.naco_img_jitter.oddeven [default = False].

       --xcorr <str>
              Cross correlation search and measure sizes (str; default: ´40 40 65 65´). The  full
              name of this option for the EsoRex configuration file is naco.naco_img_jitter.xcorr
              [default = 40 40 65 65].

       --union <bool>
              Combine images using their union, as opposed to their intersection (deprecated  and
              ignored,  see --combine_method) (bool; default: True). The full name of this option
              for the EsoRex configuration file is naco.naco_img_jitter.union [default = True].

       --rej <str>
              Low and high number of rejected values (str; default: ´2 2´). The full name of this
              option  for  the EsoRex configuration file is naco.naco_img_jitter.rej [default = 2
              2].

       --combine_method <str>
              Combine images using one of: 1) Onto  the  first  image  (first);  2)  Their  union
              (union);  3)  Their  intersection  (inter). NB: Only the ´first´-method produces an
              image product with WCS coordinates. A successful ´first´-method always  produces  a
              combined  image  with  dimensions  equal  to  those  of  the  input images. For the
              ´union´-method the result image is at least as large as the input images while  for
              the  ´inter´-method  the result image is at most as large as the input images (str;
              default: ´union´). The full name of this option for the EsoRex  configuration  file
              is naco.naco_img_jitter.comb_meth [default = union].

       --sky_planes <long>
              Estimate the sky using the median of the last n planes in the previous cube and the
              first n planes in the following cube. If the cube has less than n planes  then  use
              all  planes.  Zero  means all. (Ignored for non-cube data) (long; default: 25). The
              full   name   of   this   option   for   the   EsoRex   configuration    file    is
              naco.naco_img_jitter.sky_planes [default = 25].

       --cube_mode <str>
              Collapse  cube data using one of: 1) No recentering (add); 2) Shift- and-Add (saa).
              (Ignored for non-cube data) (str; default: ´saa´). The full name of this option for
              the EsoRex configuration file is naco.naco_img_jitter.cube_mode [default = saa].

       --lucky <float>
              In  cube  mode  use  only the frames with a strehl ratio in the given top fraction.
              (Ignored for non-cube data) (float; default: 1.0). The full name of this option for
              the EsoRex configuration file is naco.naco_img_jitter.lucky_strehl [default = 1.0].

       --save_cube <bool>
              Append  the  cube of corrected object images that are shifted added together to the
              product (bool; default: False). The  full  name  of  this  option  for  the  EsoRex
              configuration file is naco.naco_img_jitter.save_cube [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 naco pipeline can be downloaded as a PDF file using the
       following URL:

              ftp://ftp.eso.org/pub/dfs/pipelines/naco/naco-pipeline-manual-1.1.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  naco  pipeline  are  naco_img_checkfocus(7),  naco_img_dark(7),
       naco_img_detlin(7),    naco_img_lampflat(7),    naco_img_slitpos(7),   naco_img_strehl(7),
       naco_img_twflat(7),   naco_img_zpoint(7),    naco_spc_combine(7),    naco_spc_lampflat(7),
       naco_spc_wavecal(7),           naco_util_img_std_cat(7),           naco_util_spc_argon(7),
       naco_util_spc_model(7)

VERSION

       naco_img_jitter 4.4.3

AUTHOR

       Lars Lundin <usd-help@eso.org>

BUG REPORTS

       Please report any problems to usd-help@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 NACO Instrument Pipeline Copyright (C) 2002, 2003, 2005, 2008
       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