3. Tags

Tags are metadata labels automatically assigned to MAROONX data files. They determine which recipes process the data and enable data selection for calibration matching.

MAROONX uses a fiber-configuration-based tagging system where tags are assigned based on the 5-fiber setup pattern rather than OBSTYPE keywords.

3.1. Fiber Configuration Patterns

Tags are determined by fiber setup (5 fibers). Common patterns:

Fiber 1	Fiber 2	Fiber 3	Fiber 4	Fiber 5	Tags
Flat lamp	Dark	Dark	Dark	Flat lamp	`FLAT, CAL`
Dark	Flat lamp	Flat lamp	Flat lamp	Dark	`FLAT, CAL`
Dark	Dark	Dark	Dark	Etalon	`DARK, CAL`
Sky	Target	Target	Target	Etalon	`SCI, SPECT`
Dark	ThAr	ThAr	ThAr	ThAr	`WAVECAL, SPECT, ThAr, CAL`
Dark	Etalon	Etalon	Etalon	Etalon	`WAVECAL, SPECT, ETALON, CAL`
Dark	LFC	LFC	LFC	LFC	`WAVECAL, SPECT, LFC, CAL`

Fiber types: Dark, Flat lamp, Sky, Target, Etalon, ThAr, LFC, Iodine cell

3.2. Tag to Recipe Mapping

Tags	Recipe
`MAROONX, BUNDLE`	`processBundle()`
`MAROONX, CAL, DARK`	`makeProcessedDark()`
`MAROONX, CAL, FLAT`	`makeProcessedFlat()` , `makeProcessedFlatDFFFF()`
`MAROONX, WAVECAL, ThAr`	`makeStaticWavecal()`
`MAROONX, WAVECAL`	`makeDynamicWavecal()`
`MAROONX, SCI`	`reduce()`

3.3. Using Tags for Data Selection

List tags on files:

typewalk *.fits

Select by tags:

# All wavelength calibrations
dataselect --tags WAVECAL *.fits

# Blue arm science
dataselect --tags SCI,BLUE *.fits

# Processed flats
dataselect --tags FLAT,PROCESSED *.fits

# Raw darks with 300s exposure
dataselect --tags RAW,DARK,300s *.fits

Exclude tags with --xtags:

# Regular darks, excluding coefficients and synthetic
dataselect --tags DARK --xtags DARK_COEFF,DARK_SYNTH *.fits

In Python scripts:

from recipe_system.utils import dataselect

# Select blue arm science with 300s exposure
sci_files = dataselect.select_data(
    all_files,
    tags=['BLUE', 'SCI', '300s']
)

3.4. All Tags

Instrument/Observatory

GEMINI, MAROONX

Arm Configuration (mutually exclusive)

BUNDLE : Raw GOA archive, blue and red arms as extensions

BLUE : Blue arm data (450-670 nm)

RED : Red arm data (650-920 nm)

Observation Type

SPECT : Spectroscopic data

SCI : Science observation

CAL : Calibration frame

WAVECAL : Calibration frame

Calibration Types

DARK : Dark frame calibration

FLAT : Flat field calibration

WAVECAL : Wavelength calibration

ThAr : Thorium-Argon arc lamp calibration

ETALON : Etalon calibration

LFC : Laser frequency comb calibration

BPM : Bad pixel mask

Processing Status

RAW : Unprocessed data

PROCESSED : Processed by DRAGONS

PREPARED : Basic preparation applied

Special Tags

{N}s: Exposure time tag (e.g., 300s, 600s). Used for matching darks to science frames.
DARK_COEFF: Processed dark with fitted coefficients
DARK_SYNTH: Synthetic dark from science frame
BARYCOR: Barycentric velocity correction has been applied

3.5. See Also

AstroDataMAROONX - tag implementation
DRAGONS AstroData documentation - general tag system