Provided by: cpl-plugin-naco-doc_4.4.1+dfsg-2_all bug

NAME

       naco_spc_combine - Combination of spectroscopic science data

SYNOPSIS

       esorex naco_spc_combine [OPTIONS] FILE.sof

DESCRIPTION

       naco_spc_combine -- NACO Combination of spectroscopic science data.

       The  files  listed  in  the  Set  Of  Frames (sof-file) must be tagged: NACO-raw-file.fits
       SPEC_NODDING or NACO-flat-file.fits MASTER_SPC_FLAT (optional).

       For nodded frames (SPEC_NODDING) there must be an identical number of  exposures  on  each
       side  of  the  center, these pairs of nodded exposures should preferably be taken with one
       immediately after the other. More precisely, the i´th A-FRAME will be paired with the i´th
       B-frame

OPTIONS

       --xtmax <long>
              Stop the spectrum extraction at this column (long; default: 1024). The full name of
              this option for the EsoRex configuration file is  naco.naco_spc_combine.extract_max
              [default = 1024].

       --xtmin <long>
              Start  the  spectrum extraction at this column (long; default: 1). The full name of
              this option for the EsoRex configuration file is  naco.naco_spc_combine.extract_min
              [default = 1].

       --save <long>
              A  positive  value  causes  additional,  intermediate  products  to be saved (long;
              default: 0). The full name of this option for  the  EsoRex  configuration  file  is
              naco.naco_spc_combine.save [default = 0].

       --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_spc_combine.plot  [default  =
              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_checkfocus(7),  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_lampflat(7),
       naco_spc_wavecal(7),           naco_util_img_std_cat(7),           naco_util_spc_argon(7),
       naco_util_spc_model(7)

VERSION

       naco_spc_combine 4.4.1

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 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