Provided by: cpl-plugin-kmos-doc_1.3.17+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: -1.7976931348623157e+308). The full name of  this  option  for
              the EsoRex configuration file is kmos.kmo_arithmetic.scalar [default = -1.79769313486e+308].

       --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
       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  kmos  pipeline  are  kmo_copy(7),  kmo_fit_profile(7),   kmo_fits_check(7),
       kmo_fits_strip(7),    kmo_illumination_flat(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_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 1.3.17

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

kmo_arithmetic                                       1.3.17                                    KMO_ARITHMETIC(7)