---
name: "amber_selector"
section: "7"
platform: "linux"
package: "cpl-plugin-amber-doc"
version: "4.4.3+dfsg-1"
release: "Debian 12 (Bookworm)"
platforms: ["linux"]
url: "https://new.carta.tech/amber_selector"
---

# amber\_selector(7)

AMBER OI frame selector

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

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

## 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*\].

- **--AverageFrames** *\<bool\>*

  Average all frames after selection (bool; default: False). The full name of this option for the EsoRex configuration file is **amber.amber\_selector.selection\_AverageFrames** \[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.4.3.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 amber pipeline are [*amber\_BeamPos*(7)](/amber_BeamPos/7.md), [*amber\_SciCal*(7)](/amber_SciCal/7.md), [*amber\_ascii\_export*(7)](/amber_ascii_export/7.md), [*amber\_calibrate*(7)](/amber_calibrate/7.md), [*amber\_detector*(7)](/amber_detector/7.md), [*amber\_oimerge*(7)](/amber_oimerge/7.md), [*amber\_p2vm*(7)](/amber_p2vm/7.md), [*amber\_raw\_to\_fitsimage*(7)](/amber_raw_to_fitsimage/7.md), [*amber\_spectral\_calibration*(7)](/amber_spectral_calibration/7.md), [*amber\_trf*(7)](/amber_trf/7.md)

## VERSION

amber\_selector 4.4.3

## AUTHOR

Armin Gabasch \<https://support.eso.org\>

## 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\>.

## LICENSE