.TH AMBER_SELECTOR "7" "4.4.3" "amber_selector" "amber recipes"
.SH NAME
amber_selector \- AMBER OI frame selector

.SH SYNOPSIS
esorex
.B amber_selector
[OPTIONS] FILE.sof

.SH 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.
.PP

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

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

If AverageFrames is set (\-\-AverageFrames=TRUE), the final product 
will contain the average of the frames

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    



.SH OPTIONS
.TP
\fB\-\-selection\-method\fR \fI<str>\fR
Selection methods (str; default: \'Fringe_SNR_gt_x\'). The full name of this option for the EsoRex configuration
file is \fBamber.amber_selector.selection_method\fR [default = \fIFringe_SNR_gt_x\fR].
.TP
\fB\-\-X1\fR \fI<float>\fR
X1 Value (float; default: 2.0). The full name of this option for the EsoRex configuration
file is \fBamber.amber_selector.selection_x1\fR [default = \fI2.0\fR].
.TP
\fB\-\-X2\fR \fI<float>\fR
X2 Value (float; default: 2.0). The full name of this option for the EsoRex configuration
file is \fBamber.amber_selector.selection_x2\fR [default = \fI2.0\fR].
.TP
\fB\-\-X3\fR \fI<float>\fR
X3 Value (float; default: 2.0). The full name of this option for the EsoRex configuration
file is \fBamber.amber_selector.selection_x3\fR [default = \fI2.0\fR].
.TP
\fB\-\-ANDselection\fR \fI<bool>\fR
X1, X2, and X3 combining method (bool; default: False). The full name of this option for the EsoRex configuration
file is \fBamber.amber_selector.selection_ANDselection\fR [default = \fIFalse\fR].
.TP
\fB\-\-AverageFrames\fR \fI<bool>\fR
Average all frames after selection (bool; default: False). The full name of this option for the EsoRex configuration
file is \fBamber.amber_selector.selection_AverageFrames\fR [default = \fIFalse\fR].

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

.SH SEE ALSO
The full documentation for the amber pipeline can be downloaded as 
a PDF file using the following URL:
.IP
.B ftp://ftp.eso.org/pub/dfs/pipelines/amber/amber\-pipeline\-manual\-4.4.3.pdf
.PP
An overview over the existing ESO pipelines can be found on the web page
\fBhttps://www.eso.org/sci/software/pipelines/\fR.
.PP
Basic documentation about the EsoRex program can be found at the esorex (1) 
man page.
.PP
It is possible to call the pipelines from python using the python\-cpl package.
See \fBhttps://packages.python.org/python\-cpl/index.html\fR for further
information.
.PP
The other recipes of the amber pipeline are
.IR amber_BeamPos (7),
.IR amber_SciCal (7),
.IR amber_ascii_export (7),
.IR amber_calibrate (7),
.IR amber_detector (7),
.IR amber_oimerge (7),
.IR amber_p2vm (7),
.IR amber_raw_to_fitsimage (7),
.IR amber_spectral_calibration (7),
.IR amber_trf (7)

.SH VERSION
amber_selector 4.4.3

.SH AUTHOR
Armin Gabasch <https://support.eso.org>

.SH BUG REPORTS
Please report any problems to https://support.eso.org. Alternatively, you may send a report to the ESO User Support Department <usd\-help@eso.org>.

.SH LICENSE