Provided by: cpl-plugin-kmos-doc_2.1.0+dfsg-1_all bug

NAME

       kmo_arithmetic - Perform basic arithmetic on cubes

SYNOPSIS

       esorex kmo_arithmetic [OPTIONS] FILE.sof

DESCRIPTION

       With this recipe simple arithmetic operations, like addition, subtraction, multiplication,
       divison and raising to a power can be performed.

       Since FITS files formatted as F1I, F2I and F3I can contain data (and eventually noise)  of
       either  just  one  IFU  or  of  all 24 IFUs, kmo_arithmetic behaves diffe- rently in these
       cases.

       When the number of IFUs is the same for both operands, the first IFU of the first  operand
       is processed with the first IFU of the second operand.

       When  the  second operand has only one IFU while the first operand has more IFUs, then the
       all the IFUs of the first operand are processed individually which the IFU of  the  second
       operand.

       If an operand contains noise and the other doesn´t, the noise will not be processed.

       Noise  is only propagated if both operand contain noise extensions. If the second operator
       is a scalar noise is also propagated, of course.

       If two cubes are given  as  operands,  they  will  be  combined  according  to  the  given
       operator.If  a  cube is given as first operand and an image as second, then it operates on
       each slice of the cube; similarly if a  spectrum  is  given  as  the  second  operand,  it
       operates on each spectrum of the cube; and a number as the second operand operates on each
       pixel of the cube.

   BASIC PARAMETERS
       --operator Any of the following operations to perform: ´+´, ´-´, ´*´ or ´/´ (also ´^´ when
       the 2nd operand is a scalar

       --scalar To be provided if a frame should be processed together with a scalar

       --file_extension  Define a string to append to the product filename ARITHMETIC in order to
       get an unique filename

         Input files:

          DO                    KMOS
          category              Type   Explanation                    Required #Frames
          --------              -----  -----------                    -------- -------
          <none or any>         F3I or Data with or                      Y        1
                                F2I or without noise frame
                                F1I or
                                F2D or
                                RAW
          <none or any>         F3I or Data with or                      N       0,1
                                F2I or without noise frame
                                F1I or
                                F2D or
                                RAW

         Output files:

          DO                    KMOS
          category              Type   Explanation
          --------              -----  -----------
          ARITHMETIC            F3I or
                                F2I or
                                F1I or
                                F2D

OPTIONS

       --operator <str>
              The operator (´+´, ´-´, ´*´, ´/´ or ´^´) (str; default: ´´). The full name of  this
              option for the EsoRex configuration file is kmos.kmo_arithmetic.operator [default =
              ].

       --scalar <float>
              The scalar operand (float; default: -99999.9). The full name of this option for the
              EsoRex configuration file is kmos.kmo_arithmetic.scalar [default = -99999.9].

       --file_extension <str>
              String to add to product filename. (str; default: ´´). The full name of this option
              for the EsoRex configuration file is kmos.kmo_arithmetic.file_extension [default  =
              ].

       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 kmos pipeline can be downloaded as a PDF file using the
       following URL:

              ftp://ftp.eso.org/pub/dfs/pipelines/kmos/kmos-pipeline-manual-2.9.pdf

       An  overview  over  the  existing  ESO  pipelines  can  be   found   on   the   web   page
       https://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
       https://packages.python.org/python-cpl/index.html for further information.

       The  other  recipes  of   the   kmos   pipeline   are   kmo_copy(7),   kmo_fit_profile(7),
       kmo_fits_strip(7),   kmo_make_image(7),   kmo_noise_map(7),  kmo_rotate(7),  kmo_shift(7),
       kmo_sky_mask(7),  kmo_stats(7),   kmos_combine(7),   kmos_dark(7),   kmos_extract_spec(7),
       kmos_flat(7),     kmos_gen_reflines(7),     kmos_gen_telluric(7),    kmos_illumination(7),
       kmos_reconstruct(7), kmos_sci_red(7), kmos_sky_tweak(7),  kmos_std_star(7),  kmos_test(7),
       kmos_wave_cal(7)

VERSION

       kmo_arithmetic 2.1.0

AUTHOR

       Alex Agudo Berbel <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 CRIRES  Instrument  Pipeline  Copyright  (C)  2002,2003  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., 59 Temple Place, Suite  330,  Boston,
       MA  02111-1307  USA