NAME

       amber_selector - AMBER OI frame selector

SYNOPSIS

       esorex amber_selector [OPTIONS] FILE.sof

DESCRIPTION

       This  recipe  selects frames stored in an AMBER OI product by various methods and writes a
       filtered OI product. After selecting a method one can set a selection criteria  for  every
       baseline  by  defining the variables X1, X2, and X3. If only one baseline is available, X2
       and X3 can be neglected. Moreover one can  choose  the  combining  method  of  the  single
       criteria by setting the Boolean variable ANDselection.

       If  ANDselection  is not set (--ANDselection=FALSE), a frame passes the filter if at least
       one of the selection criteria (X1 || X2 || X3) is fulfilled.

       If ANDselection is set (--ANDselection=TRUE), a  frame  passes  the  filter  only  if  ALL
       selection criteria (X1 && X2 && X3) are fulfilled.

       Please  note,  that for three baselines in both cases the visibility triplet is written to
       the product file!

       Input files:

         DO category:               Type:      Explanation:      Required:
         SCIENCE_REDUCED            Products   OI-Fits file
         or
         SCIENCE_REDUCED_FILTERED   Products   OI-Fits file
         or
         CALIB_REDUCED              Products   OI-Fits file               Y
         or
         CALIB_REDUCED_FILTERED     Products   OI-Fits file
         or
         SCIENCE_CALIBRATED         Products   OI-Fits file

       Output files:

         DO category:               Data type: Explanation:
         SCIENCE_REDUCED_FILTERED   Products:  filtered OI-fits file
         or
         CALIB_REDUCED_FILTERED     Products:  filtered OI-fits file

OPTIONS

       --selection-method <str>
              Selection methods (str; default: ´Fringe_SNR_gt_x´). The full name of  this  option
              for the EsoRex configuration file is amber.amber_selector.selection_method [default
              = Fringe_SNR_gt_x].

       --X1 <float>
              X1 Value (float; default: 2.0). The  full  name  of  this  option  for  the  EsoRex
              configuration file is amber.amber_selector.selection_x1 [default = 2.0].

       --X2 <float>
              X2  Value  (float;  default:  2.0).  The  full  name  of this option for the EsoRex
              configuration file is amber.amber_selector.selection_x2 [default = 2.0].

       --X3 <float>
              X3 Value (float; default: 2.0). The  full  name  of  this  option  for  the  EsoRex
              configuration file is amber.amber_selector.selection_x3 [default = 2.0].

       --ANDselection <bool>
              X1,  X2,  and  X3  combining  method  (bool; default: False). The full name of this
              option       for       the        EsoRex        configuration        file        is
              amber.amber_selector.selection_ANDselection [default = False].

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

              ftp://ftp.eso.org/pub/dfs/pipelines/amber/amber-pipeline-manual-4.2.2.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 amber pipeline are amber_calibrate(7), amber_raw_to_fitsimage(7),
       amber_p2vm(7),    amber_BeamPos(7),    amber_spectral_calibration(7),   amber_detector(7),
       amber_oimerge(7), amber_trf(7), amber_SciCal(7), amber_ascii_export(7)

VERSION

       amber_selector 4.2.2

AUTHOR

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