NAME

       naco_img_checkfocus - Focus check recipe

SYNOPSIS

       esorex naco_img_checkfocus [OPTIONS] FILE.sof

DESCRIPTION

       naco_img_checkfocus -- The focus checking recipe The Set Of Frames (sof-file) must specify
       at least four files and they must be tagged NACO-raw-file.fits TECH_FOCUS The first of the
       files is used as a dark frame.

OPTIONS

       --plot <long>
              The  recipe  can  produce a number of predefined plots. Zero means that none of the
              plots are produced, while increasing values (e.g. 1 or 2) increases the  number  of
              plots  produced.  If  the  plotting  fails  a  warning  is produced, and the recipe
              continues. The default behaviour of the plotting is to  use  gnuplot  (with  option
              -persist).  The  recipe  currently  produces  1D-plots  using gnuplot commands. The
              recipe user can control the actual plotting-command used by the  recipe  to  create
              the plot by setting the environment variable CPL_PLOTTER. Currently, if CPL_PLOTTER
              is  set  it  must  contain  the  string   ´gnuplot´.   Setting   it   to   ´cat   >
              my_gnuplot_$$.txt´ causes a number of ASCII-files to be created, which each produce
              a plot when given as standard input to  gnuplot  (e.g.  later  or  on  a  different
              computer).  A  finer  control of the plotting options can be obtained by writing an
              executable script, e.g. my_gnuplot.pl, that  executes  gnuplot  after  setting  the
              desired  gnuplot  options  (e.g.  set  terminal  pslatex  color)  and  then setting
              CPL_PLOTTER to my_gnuplot.pl. The predefined  plots  include  plotting  of  images.
              Images can be plotted not only with gnuplot, but also using the pnm format. This is
              controlled with the environment variable CPL_IMAGER. If  CPL_IMAGER  is  set  to  a
              string that does not contain the word gnuplot, the recipe will generate the plot in
              pnm format. E.g.  setting CPL_IMAGER to ´display - &´  will  produce  a  gray-scale
              image  using  the  image  viewer display. (long; default: 0). The full name of this
              option for the EsoRex configuration file is naco.naco_img_checkfocus.plot  [default
              = 0].

       --star_r <float>
              The star radius [arcsecond] (float; default: 2.0). The full name of this option for
              the EsoRex configuration file is naco.naco_img_checkfocus.star_r [default = 2.0].

       --bg_r1 <float>
              The internal radius of the background [arcsecond] (float; default: 2.0).  The  full
              name    of    this    option    for    the    EsoRex    configuration    file    is
              naco.naco_img_checkfocus.bg_r1 [default = 2.0].

       --bg_r2 <float>
              The external radius of the background [arcsecond] (float; default: 3.0).  The  full
              name    of    this    option    for    the    EsoRex    configuration    file    is
              naco.naco_img_checkfocus.bg_r2 [default = 3.0].

       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_dark(7),  naco_img_detlin(7),
       naco_img_jitter(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_checkfocus 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