apero_mk_tellu_spirou

Contents

• 1. Description

• 2. Schematic

• 3. Usage

• 4. Optional Arguments

• 5. Special Arguments

• 6. Output directory

• 7. Output files

• 8. Debug plots

• 9. Summary plots

1. Description

SHORTNAME: MKTELL

Residual transmission of hot stars (mktellu)

The residual transmission recipe takes a single hot star observation (an extracted, flat-fielded 2D spectrum). The first step is a pre-cleaning correction which essentially removes the bulk of the telluric absorption, producing a corrected 2D spectrum as well as an absorption spectrum, sky model, and an estimate of the water and dry components of the absorption (Artigau in prep). The pre-cleaning uses a stellar template, if available, to better measure the water and dry components. The corrected 2D spectrum is then normalized by the 95$^{th}$ percentile of the blaze per order and the residual transmission map is created by using a low-pass filter (per order) on the hot star (and dividing by a template if present).

We make sure the pre-cleaning was successful (i.e., the water component exponent is between 0.1 and 15 and the dry component exponent is between 0.8 and 3.0) and check that the SNR for each order is above a $100$; subsequently, the hot star residual transmission maps are added to the telluric database.

2. Schematic

No schematic set

3. Usage

apero_mk_tellu_spirou.py {obs_dir}[STRING] [FILE:EXT_E2DS,EXT_E2DS_FF] {options}

{obs_dir}[STRING] // [STRING] The directory to find the data files in. Most of the time this is organised by nightly observation directory
[FILE:EXT_E2DS,EXT_E2DS_FF] // [STRING/STRINGS] A list of fits files to use separated by spaces. Currently  allowed types: E2DS, E2DSFF

4. Optional Arguments

--database[True/False] // [BOOLEAN] Whether to add outputs to calibration database
--blazefile[FILE:FF_BLAZE] // [STRING] Define a custom file to use for blaze correction. If unset uses closest file from calibDB. Checks for an absolute path and then checks 'directory' (CALIBDB=BADPIX)
--plot[0>INT>4] // [INTEGER] Plot level. 0 = off, 1 = interactively, 2 = save to file
--wavefile[FILE:WAVESOL_REF,WAVE_NIGHT,WAVESOL_DEFAULT] // [STRING] Define a custom file to use for the wave solution. If unset uses closest file from header or calibDB (depending on setup). Checks for an absolute path and then checks 'directory'
--use_template[True/False] // Whether to use the template provided from the telluric database
--template[FILE:TELLU_TEMP] // Filename of the custom template to use (instead of from telluric database)
--finiteres[True/False] // Whether to do the finite resolution correction (Always false if no template)
--no_in_qc // Disable checking the quality control of input files

5. Special Arguments

--xhelp[STRING] // Extended help menu (with all advanced arguments)
--debug[STRING] // Activates debug mode (Advanced mode [INTEGER] value must be an integer greater than 0, setting the debug level)
--listing[STRING] // Lists the night name directories in the input directory if used without a 'directory' argument or lists the files in the given 'directory' (if defined). Only lists up to 15 files/directories
--listingall[STRING] // Lists ALL the night name directories in the input directory if used without a 'directory' argument or lists the files in the given 'directory' (if defined)
--version[STRING] // Displays the current version of this recipe.
--info[STRING] // Displays the short version of the help menu
--program[STRING] // [STRING] The name of the program to display and use (mostly for logging purpose) log becomes date | {THIS STRING} | Message
--recipe_kind[STRING] // [STRING] The recipe kind for this recipe run (normally only used in apero_processing.py)
--parallel[STRING] // [BOOL] If True this is a run in parellel - disable some features (normally only used in apero_processing.py)
--shortname[STRING] // [STRING] Set a shortname for a recipe to distinguish it from other runs - this is mainly for use with apero processing but will appear in the log database
--idebug[STRING] // [BOOLEAN] If True always returns to ipython (or python) at end (via ipdb or pdb)
--ref[STRING] // If set then recipe is a reference recipe (e.g. reference recipes write to calibration database as reference calibrations)
--crunfile[STRING] // Set a run file to override default arguments
--quiet[STRING] // Run recipe without start up text
--nosave // Do not save any outputs (debug/information run). Note some recipes require other recipesto be run. Only use --nosave after previous recipe runs have been run successfully at least once.
--force_indir[STRING] // [STRING] Force the default input directory (Normally set by recipe)
--force_outdir[STRING] // [STRING] Force the default output directory (Normally set by recipe)

6. Output directory

DRS_DATA_REDUC // Default: "red" directory

7. Output files

Outputs

name	description	HDR[DRSOUTID]	file type	suffix	fibers	dbname	dbkey	input file
TELLU_CONV	Telluric convolution file	–	.npy	_tellu_conv	AB, A, B	telluric	TELLU_CONV	WAVESOL_REF, WAVE_NIGHT, WAVESOL_DEFAULT
TELLU_TRANS	Telluric transmission file	TELLU_TRANS	.fits	_tellu_trans	AB, A, B	telluric	TELLU_TRANS	EXT_E2DS_FF
TELLU_SCLEAN	Sky-cleaning file	TELLU_SCLEAN	.fits	_tellu_sclean.fits	–	–	–	EXT_E2DS_FF
TELLU_PCLEAN	Telluric pre-cleaning file	TELLU_PCLEAN	.fits	_tellu_pclean	AB, A, B	telluric	TELLU_PCLEAN	EXT_E2DS_FF

8. Debug plots

TELLU_SKY_CORR_PLOT
MKTELLU_WAVE_FLUX1
MKTELLU_WAVE_FLUX2
TELLUP_WAVE_TRANS
TELLUP_ABSO_SPEC
TELLUP_CLEAN_OH
FTELLU_RECON_SPLINE2
TELLU_FINITE_RES_CORR

9. Summary plots

SUM_MKTELLU_WAVE_FLUX
SUM_TELLUP_WAVE_TRANS
SUM_TELLUP_ABSO_SPEC