!!!A guide to accessing and analyzing EIS data

This guide describes how to access, calibrate and derive scientific results from the EIS instrument on Hinode. For a description of EIS and its observing modes please consult the instrument paper, [Culhane et al. (2007)|http://adsabs.harvard.edu/abs/2007SoPh..243...19C], and the [MSSL Science Centre webpage|http://msslxr.mssl.ucl.ac.uk:8080/SolarB/].

!!Tutorials

The sections below describe individual steps in going from finding data to deriving scientific results. For new users tutorials are provided that show how to process example data-sets and derive results. 

[Tutorial for narrow slit data|TutorialSlit] (1", 2" slits)

[Tutorial for slot data|TutorialSlot] (40", 266" slits)

!!Searching and downloading EIS data

Each country contributing to the Hinode mission provides access to the data through web portals. Each one offers different capabilities and so it is recommended that you try each to familiarize yourself with the methods for searching for data. The four data access points are given below and we also list an IDL-based tool for accessing data.

[Hinode Science Data Centre (Europe)|http://elnath.uio.no/search/API] \\

[MSSL Science Centre (UK)|http://msslxr.mssl.ucl.ac.uk:8080/SolarB/]\\

[Hinode Data Centre, DARTS (Japan)|http://darts.isas.jaxa.jp/hinode]\\

[Virtual Solar Observatory (US)|http://virtualsolar.org]

[EIS_CAT (IDL tool)|EISCAT]

The large quantity of EIS data coupled with the large number of free parameters (raster size, wavelength windows, slit choice) means that it can be quite difficult to find the perfect data-set if you don't already know which study you want. Check out [Tips for finding the perfect data-set|TipsPerfect] to get some hints on searching for data.

!!Calibrating EIS data

Calibration of EIS data is performed with a single IDL routine, EIS_PREP, which converts a level-0 FITS file (raw data) to a level-1 FITS file (calibrated data). Note that the data archives listed above do not distribute level-1 files, so the user needs to perform the calibration. It is highly recommended that the user perform calibration before browsing the data as detector artifacts called warm pixels make browsing the raw data difficult.

The standard call for eis_prep is:

{{
IDL> eis_prep, filename, /quiet, /retain, /default, /save
}}

an explanation of these keywords and a description of the calibration steps performed by eis_prep are available in [EIS Software Note No. 1|https://hyperion.nascom.nasa.gov/svn/eis/release/doc/eis_notes/01_EIS_PREP/eis_swnote_01.pdf].

!!Taking a quick-look at your data

For browsing a data-set there are several 'quicklook' tools available that can be accessed by first calling a single IDL widget called XFILES:

IDL> xfiles

The widget allows you to choose an EIS file by manually typing in the path to the EIS file. Make sure to change 'eis_l0_*' to 'eis_l1_*' in the 'Set search filter' box to look for level-1 files rather than level-0 files. After confirming your selection a new widget called XCONTROL pops up which allows the user to access the five quicklook tools:

[Control|QuicklookControl] - find basic info on your data, run eis_prep, access QL tools.

[Detector|QuicklookDetector] - displays detector images.

[Browser|QuicklookBrowser] - allows user to browse the 3D data cubes (wavelength-X-Y) obtained from narrow slit observations.

[Spectroheliogram|QuicklookSpectroHeliogram] - for a specified line shows a solar-Y vs. wavelength plot for each exposure.

[Whisker|QuicklookWhisker] - for a specified line shows a solar-X vs. wavelength plot for each exposure.

[Intensity map|QuicklookIntensity] - for a specified line shows an intensity image.

!!EIS objects and structures

A complete data-set is read into IDL as an object as follows:

IDL> data=obj_new('eis_data',filename)

where 'filename' is the name of the level-1 file (a level-0 file can be read in the same way). The contents of the object can be read and manipulated through a large number of methods and an overview of some of the most useful methods are given below.

[EIS object methods|EISmethods]

The routine [EIS_GETWINDATA|EISGetWindata] is also available if you want to extract a single EIS data window into an IDL structure. Some routines (e.g., EIS_AUTO_FIT) require as input the structures produced by EIS_GETWINDATA.


!!Narrow slit data (1", 2" slits)

The 1" and 2" slits return emission line spectra and a basic task for such data-sets is to fit Gaussians to the emission lines to return intensity, centroid and width information. Gaussian fitting routines available to EIS users are described below. Interpretation of centroids and widths is hampered by certain instrumental effects and these are dealt with in the sections below.

!Gaussian fitting routines

!Intensity maps

!Velocity maps

!Line width maps

!Line ratio maps and density diagnostics

!!Slot data (40", 266" slits)

The EIS slots produce images rather than spectra, and the most common application will be to produce movies from the slot rasters in a range of emission lines. Diagnostics are possible with the slots, however, by taking ratios of images and temperature and density diagnostics are described below.

!Making movies

!Temperature diagnostics

!Density diagnostics

!!Pointing and co-alignment

Most EIS users will be analyzing data-sets from multiple instruments and so it is necessary to determine where an EIS raster is positioned relative to the other instruments. Usually the pointing information within an EIS file will not be good enough to accurately co-align data-sets and so cross-correlation will be necessary.

!How to get the most accurate EIS coordinates

!EIS and IDL maps

The set of [IDL map software|http://beauty.nascom.nasa.gov/~zarro/idl/maps/maps.html] of D. Zarro is a popular means for handling solar image data. The situation is more complicated for EIS than imaging instruments as an image can be an intensity, velocity or line width map. EIS maps are generated from EIS data objects as follows (in the case of a velocity map from Fe XII 195.12):

IDL> obj=obj_new('eis_data', filename)\\
IDL> m=obj_new('eis_moment',obj,iwin=195.12)\\
IDL> mmap=m->mk_eis_map(195.12,/vel)

The output mmap is in the standard format accepted by the map software.

To generate an intensity map use keyword /int and for a line width map use /wid. When the 'eis_moment' object is created (step 2) a widget will pop up allowing you to define the spectral region containing the emission line. Moments are used to generate the velocity and line widths which ensures quick results. You can use Gaussian fitting by giving the additional keyword fit='gauss' in step 2 for the eis_moment call.

!Cross-correlation with SOT and XRT

!Cross-correlation with EIT and TRACE

!!EIS Software Notes

A series of Software Notes have been written that give details about various technical aspects related to the EIS mission.

[Software Note No. 1|https://hyperion.nascom.nasa.gov/svn/eis/release/doc/eis_notes/01_EIS_PREP/eis_swnote_01.pdf] - eis_prep\\
[Software Note No. 2|https://hyperion.nascom.nasa.gov/svn/eis/release/doc/eis_notes/02_RADIOMETRIC_CALIBRATION/eis_swnote_02.pdf] - Radiometric calibration\\
Software Note No. 3 - Grating/Detector tilt\\
[Software Note No. 4|https://hyperion.nascom.nasa.gov/svn/eis/release/doc/eis_notes/04_SLIT_TILT/eis_swnote_04.pdf] - Slit tilts\\
Software Note No. 5 - Orbital variation of EIS wavelength scale\\
[Software Note No. 6|https://hyperion.nascom.nasa.gov/svn/eis/release/doc/eis_notes/06_HOT_WARM_PIXELS/eis_swnote_06.pdf] - Hot and Warm pixels\\
Software Note No. 7 - Variation of line width with slit position\\
Software Note No. 8 - EIS Point Spread function (coma)\\
[Software Note No. 9|https://hyperion.nascom.nasa.gov/svn/eis/release/doc/eis_notes/09_POINTING/eis_swnote_09.pdf] - EIS Pointing\\
[Software Note No. 10|https://hyperion.nascom.nasa.gov/svn/eis/release/doc/eis_notes/10_DARK_CURRENT/eis_swnote_10.pdf] - Dark Current\\
[Software Note No. 11|https://hyperion.nascom.nasa.gov/svn/eis/release/doc/eis_notes/11_JPEG_COMPRESSION/eis_swnote_11.pdf] - JPEG Compression\\
[Software Note No. 12|https://hyperion.nascom.nasa.gov/svn/eis/release/doc/eis_notes/12_STRAY_LIGHT/eis_swnote_12.pdf] - Stray Light \\
[Software Note No. 13|https://hyperion.nascom.nasa.gov/svn/eis/release/doc/eis_notes/13_INTERPOLATION/eis_swnote_13.pdf] - Interpolation of missing EIS data\\
[Software Note No. 14|https://hyperion.nascom.nasa.gov/svn/eis/release/doc/eis_notes/14_BP_TRIGGER/eis_swnote_14.pdf] - The EIS Bright Point Trigger\\