Reduced Data Products

All of the existing IGRINS data has been hand reduced using the (IGRINS plp). The Reduced version of RRISA includes different names for targets than the Raw component. These are names that have been painstakingly corrected by manually searching through the IGRINS paper logs for handwritten coordinates and names, through SIMBAD for nomenclature corrections and coordinate offsets. Targets that are subcomponents of systems or extended sources keep their identifier, and if not SIMBAD searchable, do not have any additional information added in the XMatch component of RRISA. The original names for all of the targets in both the recipe files and the Raw component of RRISA remain for reference. If users find anything that appears to be a misidentification we ask that they report it by raising a GitHub issue.

Additionally, we provide all of the SIMBAD IDs for objects observed every night in an additional file. This file can effectively be used to search for the nights specific objects were observed for easier manipulation of the RRISA components.

Data Reduction

IGRINS reduced data have been processed with the IGRINS Pipeline Package (PLP) see Lee+ 2017.

The PLP optimally extracts 1D spectra, telluric corrects, and provides 2D rectified spectra for post-processing. Wavelength solutions are determined using OH emission lines, and are then refined using telluric absorption lines in the telluric standard. Telluric standards were generally A0V stars, which are Vega corrected using a model of the Vega spectrum (see the file in the PLP).

The Trappist-1 CO lines as seen by IGRINS plotted with muler.
A snippet of the Trappist-1 CO absorption lines from an IGRINS spectra reduced using IGRINS PLP and plotted using muler.

The PLP outputs several files for each reduction:

  1. spec_A0v.fits: The target spectrum telluric corrected by the Vega corrected A0V. This FITS file includes the original data used to create the reduced spectrum. Each extension is a 2048x28 array with the same header. The differences between each of the EXTNAMEs are:
    • [0]-Primary: The corrected target spectrum = (TGT_SPEC/A0V_SPEC)*VEGA_SPEC
    • [1]-Wavelength: The wavelength solution - in um (so 1.42um for instance)
    • [2]-TGT_SPEC: The extracted target spectrum (from the target spec.fits file)
    • [3]-A0V_SPEC: The extracted A0V spectrum (from the A0V spec.fits file)
    • [4]-VEGA_SPEC: A model of the Vega spectrum (see the file in the PLP or for more detailed info regarding the file see this link).
  2. sn.fits (for both target and A0): Signal-to-Noise per pixel matching to the spec.fits output.
  3. variance.fits (for both target and A0): Variance per pixel matching spec.fits output.
  4. spec.fits (for both target and A0): The source spectrum. It says the spectral unit is ADUs.
  5. spec_flattened.fits (A0): The flattened A0 spectrum.
  6. spec2d.fits (for both target and A0): the two dimension spectrum
  7. var2d.fits (for both target and A0): the two dimensional variance
  8. wave.fits (for both target and A0): The vacuum wavelength solution for a given source, in nm (so 1429nm for instance).

The wavelength solutions for PLP reduced spectra are derived in a multi-step process. Originally, IGRINS had a calibration unit installed that permitted nightly observations of ThAr arc lamps for wavelength calibration. Since IGRINS has no moving optics, it has a fixed spectral format that changes on the order on <1 pixel per night and <5 pixels over a year. The calibration unit still provides wavelength calibration for IGRINS in the laboratory. In the RRISA reduced files the wavelength solution comes from an initial guess based on the historical wavelength solution. This initial guess is then refined using sky OH emission features in a 300s SKY frame taken each night on the telescope. SKY frames from adjacent nights also provide reliable wavelength solutions. The wavelength solution is further refined by using telluric absorption features in the A0V standard at wavelengths greater than 2.1μm. The dependence of the refinement on the telluric A0V means that the wavelength solution for each target is that copied from the telluric star.

The telluric standard is divided by a Vega model to remove the deep and broad H2 absorption features in the A0V - leaving behind the telluric spectrum. This process is not perfect and can leave residual features due to differences in the line widths and radial velocities of the telluric stars relative to the Vega model. When using PLP data for science pertaining to individual line strengths, users should compare the spectrum to that of the A0V, the Vega model and the Earth transmittance spectrum. If the spectrum has significant telluric residuals, we provide Python based tools on the Tutorial page for how to help remove these features. If the spectrum has excess A0V residuals, the Vega model and A0V spectrum from the PLP can be used to perform an improved telluric correction. Additional A0V observations from the same night might also improve corrections.

Note: The output files from the IGRINS PLP are an in vacuum wavelength solution. Fit models are offset from expected line positions by 80-120 km/s the models are likely in air and not vacuum. The IAU standard conversion for air to vacuum wavelengths is given by Morton 1991. For vacuum wavelengths (VAC) in Angstroms and convert to air wavelength (AIR) via:

AIR = VAC / (1.0 + 2.735182E-4 + (131.4182 / VAC^2) + (2.76249E8 / VAC^4))

New in RRISA v1: Rtell Data Products & File Format

A comparison between the original IGRINS data product and the rtell IGRINS data product for SZ Cha.
A comparison between the SZ Cha IGRINS spectrum from the IGRINS PLP and from rtell. The IGRINS PLP spectrum is shown in black and the rtell spectrum is shown in red.

The rtell data products take the original reduced spectra output from the IGRINS PLP and improve the pixel alignment between the A0V standard star spectrum and the target spectrum using a strong telluric sky line (between 16452-16458 and 21740-21752 Angstroms in H- and K-Band respectively) featured in the spectra. We identify the center of the telluric feature in both the standard and target spectra by fitting a gaussian. The shift between the two centers is identified and the standard star spectrum is shifted in pixel space to align with the center of the target spectrum. The rtell spectrum is produced by dividing the original target spectrum by the shifted standard spectrum and multiplying by the Vega model. Unlike the IGRINS PLP data products, the divided spectrum, wavelength solution, target spectrum, shifted standard spectrum, Vega model, and SNR per resolution element are available in one FITS file as separate extensions. Additionally, when an rtell file is available for an object, we provide three additional files in RRISA:

  1. plots showing the initial sky-line gaussian guess and the final gaussian fit for the telluric line in the target spectrum
  2. plots showing the initial sky-line gaussian guess and the final gaussian fit for the telluric line in the standard spectrum (see Figure below)
  3. a text file with information about both the target and standard spectrum, the shift implemented, and the filename for the rtell spectrum
The standard star spectrum telluric line fits for an SZ Cha rtell file.
The K-Band telluric feature fits for a standard star used in an SZ Cha IGRINS rtell reduction. The right shows the 'close' initial priors fed into scipy.curve_fit, the left shows the final gaussian from scipy.curve_fit with the center pixel labeled in the legend.

The new rtell file is supported through the most recent version of muler and we provide the code that produces the rtell data products for reference in the rtell folder in the RRISA repository.

RRISA Reduced

Downloadable from our GitHub as a .csv or .xlsx. Users can also view through Google Drive or explore the RRISA_v1 folder on Box!

For a more detailed description of the Reduced RRISA header, check out the readme.md in the RRISA Reduced folder on our GitHub.