# Getting Started

## You are here

### IMPORTANT NOTE:

This page provides information to assist users when processing data obtained with the Gemini telescopes **with Gemini IRAF**. If you are reducing ** Imaging** data from GMOS, NIRI, Flamingos-2, GSAOI, or GNIRS (keyhole), then we strongly recommend that you use the new platform, DRAGONS. Tutorials are available on the DRAGONS Documentation Portal

### Introduction

Please see the requirements page for information relating to installing the Gemini IRAF package. For those new to IRAF, general IRAF documentation is available. In addition, a presentation called An Introduction to IRAF and the Gemini IRAF package was given at the 2014 AusGO/AAO Observational Techniques Workshop in Sydney, Australia, in conjunction with an interactive Python / PyRAF demonstration in the form of an IPython notebook (to run the IPython notebook, type **ipython notebook** in the directory where the IPython notebook is located then go to your browser). For instrument specific information, please follow the links below.

To get started with PyRAF:

To get started with one of the instruments:

__FLAMINGOS-2__

- All the available tasks in the F2 package can be found by typing
**help f2**at the IRAF / PyRAF prompt before loading the F2 package - Information about the reduction of all FLAMINGOS-2 data can be found by typing
**f2info**at the IRAF / PyRAF prompt - A FLAMINGOS-2 Data Reduction Cookbook provides instructions and PyRAF scripts for reducing both imaging and longslit spectroscopic data using the Gemini IRAF package.

## Imaging Data

- Information about the reduction of FLAMINGOS-2 imaging data can be found by typing
**f2infoimaging**at the IRAF / PyRAF prompt - An example reduction script for processing FLAMINGOS-2 imaging data can be found by typing
**f2examples imaging**at the IRAF / PyRAF prompt

## Spectroscopic Data

- Line lists for wavelength calibration are available
#### Longslit Data

- Information about the reduction of FLAMINGOS-2 longslit data can be found by typing
**f2infols**at the IRAF / PyRAF prompt - An example reduction script for processing FLAMINGOS-2 longslit data can be found by typing
**f2examples longslit**at the IRAF / PyRAF prompt

#### Multi-Object Spectroscopy (MOS) Data

- Information about the reduction of FLAMINGOS-2 MOS data can be found by typing
**f2infomos**at the IRAF / PyRAF prompt - An example reduction script for processing FLAMINGOS-2 MOS data can be found by typing
**f2examples MOS**at the IRAF / PyRAF prompt

- Information about the reduction of FLAMINGOS-2 longslit data can be found by typing

__GMOS__

- All the available tasks in the GMOS package can be found by typing
**help gmos**at the IRAF / PyRAF prompt before loading the GMOS package - Information about the reduction of all GMOS data can be found by typing
**gmosinfo**at the IRAF / PyRAF prompt - A description of the format of GMOS data is available
- Example bias images are available
- Information about the reduction of GMOS imaging and spectroscopic data was presented at the South American Data Workshop in Brazil in October, 2011
- Information about the reduction of GMOS data (relating to the tutorials below) was presented (powerpoint and pdf) at the Gemini Data Workshop in Tucson, Arizona in July, 2010.
- GMOS Data Reduction Cookbook developed in conjunction with the US NGO has instructions for imaging and spectroscopy data reduction and calibration.

## Imaging Data

- Information about the reduction of GMOS imaging data can be found by typing
**gmosinfoimag**at the IRAF / PyRAF prompt - An example reduction script for processing GMOS imaging data can be found by typing
**gmosexamples imaging**at the IRAF / PyRAF prompt - Example flat field images are available
- Example fringe images are available for both GMOS-N and GMOS-S
- A GMOS imaging tutorial, along with an example reduction script in the form of an IPython notebook (to run the IPython notebook, type
**ipython notebook**in the directory where the IPython notebook is located then go to your browser) was presented at the 2014 AusGO/AAO Observational Techniques Workshop in Australia in April, 2014 - A GMOS imaging calibration tutorial and a GMOS imaging science tutorial were presented both at the South American Data Workshop in Brazil in October, 2011 and the Gemini Data Workshop in Tucson, Arizona in July, 2010.

## Spectroscopic Data

- Information about the reduction of GMOS spectroscopic data can be found by typing
**gmosinfospec**at the IRAF / PyRAF prompt - Line lists for wavelength calibration are available
- Information about the reduction of GMOS spectroscopic data was presented at the South American Data Workshop in Brazil in October, 2011
#### Longslit Data

- An example reduction script for processing GMOS longslit data and GMOS standard longslit data can be found by typing
**gmosexamples longslit**and**gmosexamples standard_longslit**at the IRAF / PyRAF prompt, respectively - A GMOS longslit tutorial was presented both at the South American Data Workshop in Brazil in October, 2011 and the Gemini Data Workshop in Tucson, Arizona in July, 2010

#### Multi-Object Spectroscopy (MOS) Data

- An example reduction script for processing GMOS MOS data can be found by typing
**gmosexamples MOS**at the IRAF / PyRAF prompt - A GMOS MOS tutorial was presented both at the South American Data Workshop in Brazil in October, 2011 and the Gemini Data Workshop in Tucson, Arizona in July, 2010

#### Nod and shuffle (NS) Data

- An example reduction script for processing GMOS NS longslit data can be found by typing
**gmosexamples NS_longslit**at the IRAF / PyRAF prompt - An example reduction script for processing GMOS NS MOS data can be found by typing
**gmosexamples NS_MOS**at the IRAF / PyRAF prompt - Example nod and shuffle longslit images are available
- Information about the reduction of GMOS Nod and shuffle data was presented (powerpoint and pdf) at the Gemini Data Workshop in Tucson, Arizona in July, 2010

- An example reduction script for processing GMOS longslit data and GMOS standard longslit data can be found by typing

## IFU Data

- GMOS IFU-1 Data Reduction Tutorial - Gemini IRAF (Workshop at the Gemini Science and Evolution meeting 2018)
- Information about the reduction of GMOS IFU data can be found by typing
**gmosinfoifu**at the IRAF / PyRAF prompt - An example reduction script for processing GMOS single slit IFU data, GMOS two slit IFU data and GMOS standard IFU data can be found by typing
**gmosexamples IFU_1slit**,**gmosexamples IFU_2slit**and**gmosexamples standard_IFU**at the IRAF / PyRAF prompt, respectively - A GMOS IFU tutorial was presented both at the South American Data Workshop in Brazil in October, 2011 and the Gemini Data Workshop in Tucson, Arizona in July, 2010
- Information about the reduction of GMOS IFU data was presented (powerpoint and pdf) at the Gemini Data Workshop in Tucson, Arizona in July, 2010
- A video of the presentation on some of the likely complications when reducing GMOS IFU data is available

__GNIRS__

- All the available tasks in the GNIRS package can be found by typing
**help gnirs**at the IRAF / PyRAF prompt before loading the GNIRS package - Information about the reduction of all GNIRS data can be found by typing
**gnirsinfo**at the IRAF / PyRAF prompt - The electronic pattern noise can be removed

## Spectroscopic Data

- Line lists for wavelength calibration are available
- Information about the reduction of GNIRS spectroscopic data was presented at the South American Data Workshop in Brazil in October, 2011
#### Longslit Data

- Information about the reduction of GNIRS longslit data can be found by typing
**gnirsinfols**at the IRAF / PyRAF prompt - An example reduction script for processing GNIRS longslit data can be found by typing
**gnirsexamples longslit**at the IRAF / PyRAF prompt - A GNIRS longslit tutorial was presented at the South American Data Workshop in Brazil in October, 2011

#### Cross Dispersed (XD) Data

- Information about the reduction of GNIRS XD data can be found by typing
**gnirsinfoxd**at the IRAF / PyRAF prompt - An example reduction script for processing GNIRS XD data can be found by typing
**gnirsexamples XD**at the IRAF / PyRAF prompt - A cookbook for reducing XD spectra is available
- A GNIRS XD tutorial was presented at the South American Data Workshop in Brazil in October, 2011

- Information about the reduction of GNIRS longslit data can be found by typing

## IFU Data

- Information about the reduction of GNIRS IFU data can be found by typing
**gnirsinfoifu**at the IRAF / PyRAF prompt - An example reduction script for processing GNIRS IFU data can be found by typing
**gnirsexamples IFU**at the IRAF / PyRAF prompt

__GPI__

The GPI instrument builders and incidentally the campaign team has developed a powerful data reduction tool in IDL. At least for the duration of the GPI campaign, the software is maintained and developed by the campaign team.

The software and the documentation can be obtained at:

http://docs.planetimager.org/pipeline

The GPI campaign team is providing a "source package" which contains all the source code and requires the user to have an IDL license to run the software. **However**, they also provide a "runtime package" both for Linux and Mac OS X that has compiled code and includes the IDL runtime library that can be run for free without a license. If you do not have an IDL license, use that second type of package.

All the tools are GUI-based. You do not need to know IDL.

A series of papers detailing GPI data and its analysis can be found in the GPI documents section

__GSAOI__

## Imaging Data

- All the available tasks in the GSAOI package can be found by typing
**help gsaoi**at the IRAF / PyRAF prompt before loading the GSAOI package - Information about the reduction of all GSAOI data can be found by typing
**gsaoiinfo**at the IRAF / PyRAF prompt **Disco-Stu**, the Distortion Correction and Stacking Utility for GSAOI. This standalone package, written in python, will align and stack images that have already been processed by the Gemini IRAF gareduce task.- An example reduction script for processing GSAOI imaging data can be found by typing
**gsaoiexamples**at the IRAF / PyRAF prompt - A tutorial on GSAOI data reduction including distortion correction was presented at a 2014 workshop in Brazil "Scientific Opportunities arising from the new instruments at Gemini and SOAR"

__MIDIR__

- All the available tasks in the MIDIR package can be found by typing
**help midir**at the IRAF / PyRAF prompt before loading the MIDIR package - Information about the reduction of all Michelle and T-ReCS data can be found by typing
**midirinfo**at the IRAF / PyRAF prompt - A description of the characteristics of Michelle and T-ReCS data is available
- Data reduction utilities in IDL and IRAF are available

## Imaging Data

- An example reduction script for processing Michelle imaging data can be found by typing
**midirexamples michelle_imaging**at the IRAF / PyRAF prompt - An example reduction script for processing T-ReCS imaging data can be found by typing
**midirexamples trecs_imaging**at the IRAF / PyRAF prompt - A cookbook for reducing mid-IR imaging data is available
#### Polarimetry Data

- An example reduction script for processing Michelle polarimetry data can be found by typing
**midirexamples polarimetry**at the IRAF / PyRAF prompt

- An example reduction script for processing Michelle polarimetry data can be found by typing

## Spectroscopic Data

- Information related to the telluric, flux and wavelength calibration of MIDIR data is available
#### Longslit Data

- An example reduction script for processing Michelle longslit data can be found by typing
**midirexamples michelle_longslit**at the IRAF / PyRAF prompt - An example reduction script for processing MIDIR longslit data can be found by typing
**midirexamples midir_longslit**at the IRAF / PyRAF prompt - A cookbook for reducing mid-IR spectroscopy data is available
- A cookbook for reducing Michelle Q band data is available

- An example reduction script for processing Michelle longslit data can be found by typing

__NIFS__

## IFU Data

- All the available tasks in the NIFS package can be found by typing
**help nifs**at the IRAF / PyRAF prompt before loading the NIFS package - Information about the reduction of all NIFS data can be found by typing
**nifsinfo**at the IRAF / PyRAF prompt - An example reduction script for processing NIFS IFU calibration data, NIFS IFU science data and NIFS IFU telluric data can be found by typing
**nifsexamples calibration**,**nifsexamples science**and**nifsexamples telluric**at the IRAF / PyRAF prompt, respectively - Information about the reduction of NIFS IFU data was presented (pdf and tutorial data) at the South American Data Workshop in Brazil in October, 2011
- Information about the reduction of NIFS IFU data was presented (powerpoint, pdf and tutorial data) at the Gemini Data Workshop in Tucson, Arizona in July, 2010

__NIRI__

- All the available tasks in the NIRI package can be found by typing
**help niri**at the IRAF / PyRAF prompt before loading the NIRI package - Information about the reduction of all NIRI data can be found by typing
**niriinfo**at the IRAF / PyRAF prompt - Information about raw NIRI data is available
- A description of the characteristics of NIRI data is available
- The electronic pattern noise can be removed
- Information about the reduction of NIRI data (relating to the tutorials below) was presented (powerpoint and pdf) at the Gemini Data Workshop in Tucson, Arizona in July, 2010

## Imaging Data

- An example reduction script for processing NIRI imaging data can be found by typing
**niriexamples imaging**at the IRAF / PyRAF prompt - Information about the reduction of NIRI imaging data was presented at the South American Data Workshop in Brazil in October, 2011
- A NIRI imaging tutorial was presented at the Gemini Data Workshop in Tucson, Arizona in July, 2010

## Spectroscopic Data

- Line lists for wavelength calibration are available
#### Longslit Data

- An example reduction script for processing NIRI longslit data can be found by typing
**niriexamples longslit**at the IRAF / PyRAF prompt - A NIRI longslit tutorial was presented at the Gemini Data Workshop in Tucson, Arizona in July, 2010

- An example reduction script for processing NIRI longslit data can be found by typing

__OSCIR__

- All the available tasks in the OSCIR package can be found by typing
**help oscir**at the IRAF / PyRAF prompt before loading the OSCIR package - Information about the reduction of all OSCIR data can be found by typing
**oscirinfo**at the IRAF / PyRAF prompt

__QUIRC__

- All the available tasks in the QUIRC package can be found by typing
**help quirc**at the IRAF / PyRAF prompt before loading the QUIRC package - Information about the reduction of all QUIRC data can be found by typing
**quircinfo**at the IRAF / PyRAF prompt

__FLAMINGOS__

- All the available tasks in the FLAMINGOS package can be found by typing
**help flamingos**at the IRAF / PyRAF prompt before loading the FLAMINGOS package - Information about the reduction of all FLAMINGOS data can be found by typing
**flamingosinfo**at the IRAF / PyRAF prompt