Gemini Data Formats and Example Data

Data formats produced by Gemini facility instruments

Data from Gemini facility instruments are stored as Multi-Extension FITS (MEF) files. The data from a single "OBSERVE" command from the Observing Tool creates one MEF file. Each MEF file consists of one Primary Header Unit (PHU) and one or more extensions that contain pixel data (see the figure below). The extensions in MEF files are indexed from [0] which is the PHU. The extension numbers ([0], [1], etc.) are shown to the left on each of the panels.

The data formats for each instrument are explained in more detail on the instrument specific data format pages.

NIRI data formats and examples, see released NIRI System Verification data
GMOS data formats and examples

Data formats produced by current visitor instruments at Gemini

The current visitor instruments produce simple FITS files. These files consist of header information immediately followed by the pixel data, see figure below. Example data are available as the released Demo Science (DS) and System Verification (SV) data for the visitor instruments.

Hokupa'a/QUIRC DS and SV data
OSCIR SV data

How to handle MEF files with IRAF

The Gemini IRAF package is written to handle the MEF files produced by the facility instruments.

Most IRAF tasks can handle MEF files if the extension number is specified. However, some IRAF tasks that attempt to derive the output file names from the name of the input image may get confused by the extension number and/or add the extension number to the output file names. In such cases it is recommended to specify the output file names rather than let IRAF choose these based on the name of the input image.

Examples of simple IRAF commands to access, display and manipulate MEF files. All examples assume that the IRAF imtype is set to "fits". This is done with the command

set imtype="fits"

The user may either include this command in the "login.cl" file, or issue it on the IRAF command line. If the command is issued on the command line, it needs to be followed by the command

flpr

in order to take effect.

The examples assume that the MEF file example1 has one pixel extension, and that the MEF file example2 has three pixel extensions, as shown on the figure above.

1. To list the PHU of the MEF file example1
   
   
   imhead example1[0] long+
   
   
2. To list the header information of extension [1] of the MEF file example1
   
   
   imhead example1[1] long+
   
   
3. To display extension [1] of the MEF file example1
   
   
   display example1[1] 1
   
   
4. To copy extension [1] of the MEF file example1 to a simple FITS file
   
   
   imcopy example1[1] newimage
   
   
5. To add extension [1] of the MEF file example1 and extension [2] of the MEF file example2 and saving the output to simple FITS file. This requires that the dimensions of the two extensions match.
   
   
   imarith example1[1] + example2[2] newimage
   
   
6. To multiply each of the extensions in the MEF file example2 with extension [1] of the MEF file example1, overwriting the current extensions in the MEF file example2. This requires that the dimensions of the extensions match.
   
   
   imarith example2[1] * example1[1] example1[1,overwrite]
   imarith example2[2] * example1[1] example2[2,overwrite]
   imarith example2[3] * example1[1] example3[3,overwrite]
   
   
   

Last update November 28, 2001; Inger Jorgensen