bionic (7) naco_img_checkfocus.7.gz

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

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