This page (revision-196) was last changed on 23-Jun-2022 16:23 by Peter Young

This page was created on 08-Jul-2010 18:18 by PeterYoung

Only authorized users are allowed to rename pages.

Only authorized users are allowed to delete pages.

Page revision history

Version Date Modified Size Author Changes ... Change note
196 23-Jun-2022 16:23 16 KB Peter Young to previous
195 21-Aug-2020 20:00 14 KB Peter Young to previous | to last Updated links to Software Notes to sohoftp
194 18-Aug-2020 17:14 14 KB Peter Young to previous | to last
193 12-Aug-2020 20:25 14 KB Peter Young to previous | to last
192 03-Aug-2020 16:34 14 KB Peter Young to previous | to last Added SW Note 25
191 16-Apr-2020 15:49 14 KB Peter Young to previous | to last
190 10-Mar-2020 15:25 14 KB Peter Young to previous | to last
189 10-Mar-2020 15:20 14 KB Peter Young to previous | to last
188 17-Dec-2019 19:12 14 KB Peter Young to previous | to last
187 17-Dec-2019 19:11 14 KB Peter Young to previous | to last
186 12-Dec-2019 16:52 14 KB Peter Young to previous | to last
185 12-Dec-2019 16:49 14 KB Peter Young to previous | to last Updated calibration section
184 13-Aug-2019 22:31 13 KB Peter Young to previous | to last Added "important dates" link
183 05-Feb-2019 14:07 13 KB Ignacio Ugarte-Urra to previous | to last
182 11-Dec-2017 15:42 13 KB Ignacio Ugarte-Urra to previous | to last
181 27-Nov-2017 16:42 13 KB Peter Young to previous | to last

Page References

Incoming links Outgoing links

Version management

Difference between version and

At line 1 changed one line
%%(color:red;)__This page is still under construction. All of the information should be accurate, but some of the links are not working yet.__%%
[{ALLOW edit EISMainUsers}]
[{ALLOW view Anonymous}]
At line 5 added one line
At line 6 changed one line
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/].
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://solarb.mssl.ucl.ac.uk:8080/SolarB/].
At line 10 added 6 lines
All software described here is written in IDL and distributed through the [Solarsoft distribution|https://www.lmsal.com/solarsoft/]. %%(color:red;)__NEW!__%% NRL have developed an EIS analysis package written in Python called [EISPAC|EISPAC].
If you are new to Hinode and EIS, please check our [guide to Hinode and EIS terminology|EISTerminology].
[A list of all EIS publications|https://pyoung.org/hinode/publications/eis_publications_summary.html].
At line 18 changed one line
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 five data access points are given below and we also list an IDL-based tool for accessing 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. Web links to the four sites are given below.
At line 22 changed one line
[MSSL Science Centre (UK)|http://msslxr.mssl.ucl.ac.uk:8080/SolarB/]\\
[MSSL Science Centre (UK)|http://solarb.mssl.ucl.ac.uk:8080/SolarB/]\\
At line 28 changed one line
[Web search tool (US)|EIS_Web_Search]
In addition, it is possible to download EIS data directly from IDL:
At line 30 changed one line
[EIS_CAT (IDL tool)|EISCAT]
[IDL command line options for downloading data|CommandLineDownload]
At line 32 changed one line
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.
%%(color:red;)__NEW!__%% The [EIS Mapper|https://eismapper.pyoung.org] site allows you to quickly see where EIS was pointed on a given day, by overplotting on a full disk EUV image.
At line 42 added 14 lines
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. Also take a look at %%(color:red;)__NEW!__%%[the list of most commonly-used EIS studies|MostCommon].
[How to find data from the EIS response studies|TriggerStudies] (e.g., flare triggers).
For information about where to store EIS data files on your computer after you've downloaded them, please check [EIS Software Note No. 18|ftp://sohoftp.nascom.nasa.gov/solarsoft/hinode/eis/doc/eis_notes/18_FILES/eis_swnote_18.pdf].
[What was EIS doing yesterday?|EISDoing] How to find out what EIS observations were being performed yesterday, last week or anytime.
[Important dates during the EIS mission|EISHistory]. This gives a timeline of significant events during the EIS mission that may affect your data analysis.
[Reference data-sets|EISRef].
At line 41 changed one line
IDL> eis_prep, filename, /quiet, /retain, /default, /save, /correct_sensitivity
IDL> eis_prep, filename, /quiet, /retain, /default, /save
At line 44 changed one line
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].
%%(color:red;)__IMPORTANT NOTE__%%: the /correct_sensitivity keyword is no longer recommended as of 8 October 2013. The recommendation for all EIS files is to use the call above, and then apply a calibration correction factor as a post-processing step. Please check the [calibration discussion page|EISCalibration] for more details.
At line 68 added 9 lines
%%(color:red;)__NOTE FOR SLOT DATA__%%: please check [calibrating slot data|SlotCalib].
An explanation of the eis_prep keywords and a description of the calibration steps performed by eis_prep are available in [EIS Software Note No. 1|ftp://sohoftp.nascom.nasa.gov/solarsoft/hinode/eis/doc/eis_notes/01_EIS_PREP/eis_swnote_01.pdf].
eis_prep can take a long time to process a data-set, but it can be speeded up by using a dynamically-loadable module (DLM). Please check out [setting up a DLM for eis_prep|DLMeisprep] for more details.
%%(color:red;)__UPDATE, 12-Dec-2019__%%: A significant change to EIS_PREP has been made, relating to the removal of residual warm pixels and cosmic rays. Please check out [EIS Software Note No. 24|https://sohoftp.nascom.nasa.gov/solarsoft/hinode/eis/doc/eis_notes/24_COSMIC_RAYS/eis_swnote_24.pdf] for more details.
At line 90 changed one line
* EIS grating tilt (Software Note 3)
* EIS spectrum tilt (Software Note 3)
At line 123 added 4 lines
There is one important instrumental effect that potentially can affect Doppler shift studies, but for which there is not a software fix at present:
* [Spatial offset between velocity and intensity features|Spatial offset of intensity and velocity features]
At line 96 changed 2 lines
[Gaussian fitting for the Hinode/EIS mission|https://hyperion.nascom.nasa.gov/svn/eis/release/doc/fitting/eis_auto_fit.pdf]\\
[Gaussian fitting examples using eis_auto_fit|https://hyperion.nascom.nasa.gov/svn/eis/release/doc/fitting/eis_auto_fit_examples.pdf]
[EIS_AUTO_FIT and SPEC_GAUSS_EIS: Gaussian fitting for the Hinode/EIS mission (EIS Software Note 16)|ftp://sohoftp.nascom.nasa.gov/solarsoft/hinode/eis/doc/eis_notes/16_AUTO_FIT/eis_swnote_16.pdf]\\
[Gaussian fitting examples using EIS_AUTO_FIT (EIS Software Note 17)|ftp://sohoftp.nascom.nasa.gov/solarsoft/hinode/eis/doc/eis_notes/17_AUTO_FIT_EXAMPLES/eis_swnote_17.pdf]
At line 106 changed one line
EIS Software Note #15 - [Deriving densities from Hinode/EIS data|https://hyperion.nascom.nasa.gov/svn/eis/release/doc/eis_notes/15_DENSITY/eis_swnote_15.pdf]
EIS Software Note #15 - [Deriving densities from Hinode/EIS data|ftp://sohoftp.nascom.nasa.gov/solarsoft/hinode/eis/doc/eis_notes/15_DENSITY/eis_swnote_15.pdf]
At line 121 changed one line
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.
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.
At line 123 changed one line
!Making movies
The data should be calibrated with eis_prep in the same way as narrow slit data. If you're working with slot rasters, then you can assemble the data into a single 2D image within a 'windata' structure with
At line 125 changed one line
!Temperature diagnostics
{{{
IDL> eis_readslot,file,wd,win=195.12,/estimate
}}}
At line 127 changed one line
!Density diagnostics
(see also the [slot tutorial|TutorialSlot]).
At line 166 added 10 lines
To create an IDL map from slot rasters, do:
{{{
IDL> map=eis_slot_map(file)
}}}
where you'll be asked to choose a wavelength window.
At line 180 added one line
* [Obtaining SDO cutout images for EIS rasters|AIAEIS]
At line 136 changed one line
* [Co-aligning EIS and XRT images|EISXRTcoaling]
* [The EIS plate scale|EISPlateScale]
At line 186 added 4 lines
!!Coordination with other observatories
[Parker Solar Probe|EISPSP]
At line 140 changed one line
A series of Software Notes have been written that give details about various technical aspects related to the EIS mission.
A series of Software Notes have been written that give details about various technical aspects related to the EIS mission. Some of these documents are published are Zenodo and so have a citable DOI. Please use this if you reference the documents in a paper.
At line 142 changed 15 lines
[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|https://hyperion.nascom.nasa.gov/svn/eis/release/doc/eis_notes/05_WAVELENGTH_CORRECTION/eis_swnote_05.pdf] - 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|https://hyperion.nascom.nasa.gov/svn/eis/release/doc/eis_notes/07_LINE_WIDTH/eis_swnote_07.pdf] - 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\\
[Software Note No. 15|https://hyperion.nascom.nasa.gov/svn/eis/release/doc/eis_notes/15_DENSITY/eis_swnote_15.pdf] - Deriving densities from Hinode/EIS data\\
[Software Note No. 1|https://doi.org/10.5281/zenodo.6339609] - Calibrating EIS data: the EIS_PREP routine (Peter Young) %%(color:blue;)[[Zenodo]%%\\
[Software Note No. 2|https://sohoftp.nascom.nasa.gov/solarsoft/hinode/eis/doc/eis_notes/02_RADIOMETRIC_CALIBRATION/eis_swnote_02.pdf] - Radiometric calibration (John Mariska)\\
[Software Note No. 3|https://sohoftp.nascom.nasa.gov/solarsoft/hinode/eis/doc/eis_notes/03_GRATING_DETECTOR_TILT/eis_swnote_03.pdf] - Spatial Y-offsets between different wavelengths (spectrum
tilt and CCD offset) (Peter Young)\\
[Software Note No. 4|https://sohoftp.nascom.nasa.gov/solarsoft/hinode/eis/doc/eis_notes/04_SLIT_TILT/eis_swnote_04.pdf] - Slit tilts (Peter Young)\\
[Software Note No. 5|https://sohoftp.nascom.nasa.gov/solarsoft/hinode/eis/doc/eis_notes/05_WAVELENGTH_CORRECTION/eis_swnote_05.pdf] - Orbital variation of EIS wavelength scale (Sugura Kamio, Terje Fredvik, Peter Young)\\
[Software Note No. 6|https://sohoftp.nascom.nasa.gov/solarsoft/hinode/eis/doc/eis_notes/06_HOT_WARM_PIXELS/eis_swnote_06.pdf] - Hot and Warm pixels (Louisa Kennedy, Peter Young)\\
[Software Note No. 7|https://sohoftp.nascom.nasa.gov/solarsoft/hinode/eis/doc/eis_notes/07_LINE_WIDTH/eis_swnote_07.pdf] - Instrumental line widths for the narrow slits of EIS (Peter Young)\\
[Software Note No. 8|https://sohoftp.nascom.nasa.gov/solarsoft/hinode/eis/doc/eis_notes/08_COMA/eis_swnote_08.pdf] - EIS Point Spread function (Ignacio Ugarte-Urra)\\
[Software Note No. 9|https://sohoftp.nascom.nasa.gov/solarsoft/hinode/eis/doc/eis_notes/09_POINTING/eis_swnote_09.pdf] - EIS Pointing (John Mariska)\\
[Software Note No. 10|https://sohoftp.nascom.nasa.gov/solarsoft/hinode/eis/doc/eis_notes/10_DARK_CURRENT/eis_swnote_10.pdf] - Dark Current (Paul Bryans)\\
[Software Note No. 11|https://sohoftp.nascom.nasa.gov/solarsoft/hinode/eis/doc/eis_notes/11_JPEG_COMPRESSION/eis_swnote_11.pdf] - JPEG Compression (Harry Warren) \\
[Software Note No. 12|https://sohoftp.nascom.nasa.gov/solarsoft/hinode/eis/doc/eis_notes/12_STRAY_LIGHT/eis_swnote_12.pdf] - Stray Light (Ignacio Ugarte)\\
[Software Note No. 13|https://sohoftp.nascom.nasa.gov/solarsoft/hinode/eis/doc/eis_notes/13_INTERPOLATION/eis_swnote_13.pdf] - Interpolation of missing EIS data (Peter Young)\\
[Software Note No. 14|https://sohoftp.nascom.nasa.gov/solarsoft/hinode/eis/doc/eis_notes/14_BP_TRIGGER/eis_swnote_14.pdf] - The EIS Bright Point Trigger (Peter Young, Khalid Al-Janabi)\\
[Software Note No. 15|https://sohoftp.nascom.nasa.gov/solarsoft/hinode/eis/doc/eis_notes/15_DENSITY/eis_swnote_15.pdf] - Deriving densities, column depths and filling factors from Hinode/EIS data (Peter Young)\\
[Software Note No. 16|https://doi.org/10.5281/zenodo.6339584] - EIS_AUTO_FIT and SPEC_GAUSS_EIS: Gaussian fitting routines for the Hinode/EIS mission (Peter Young) %%(color:blue;)[[Zenodo]%%\\
[Software Note No. 17|https://sohoftp.nascom.nasa.gov/solarsoft/hinode/eis/doc/eis_notes/17_AUTO_FIT_EXAMPLES/eis_swnote_17.pdf] - Gaussian fitting examples using the EIS_AUTO_FIT routine (Peter Young)\\
[Software Note No. 18|https://sohoftp.nascom.nasa.gov/solarsoft/hinode/eis/doc/eis_notes/18_FILES/eis_swnote_18.pdf] - EIS data files and directory structure (Peter Young)\\
[Software Note No. 19|https://sohoftp.nascom.nasa.gov/solarsoft/hinode/eis/doc/eis_notes/19_DATABASE/eis_swnote_19.pdf] - How to access and use the EIS databases (Peter Young)\\
[Software Note No. 20|https://sohoftp.nascom.nasa.gov/solarsoft/hinode/eis/doc/eis_notes/20_EIS_AIA_COALIGN/eis_swnote_20.pdf] - EIS/AIA coalignment (John Mariska)\\
[Software Note No. 21|https://sohoftp.nascom.nasa.gov/solarsoft/hinode/eis/doc/eis_notes/21_WINDATA/eis_swnote_21.pdf] - The WINDATA routines for EIS data analysis (Peter Young)\\
[Software Note No. 22|https://sohoftp.nascom.nasa.gov/solarsoft/hinode/eis/doc/eis_notes/22_QUICKLOOK_AND_TIMELINE_DB/eis_swnote_22.pdf] - EIS Quicklook Data Processing and Timeline Database Retrieval (John Mariska)\\
Software Note No. 23 - In preparation\\
[Software Note No. 24|https://sohoftp.nascom.nasa.gov/solarsoft/hinode/eis/doc/eis_notes/24_COSMIC_RAYS/eis_swnote_24.pdf] - EIS_PREP: removing residual warm pixels and cosmic rays (Peter Young)\\
[Software Note No. 25|https://sohoftp.nascom.nasa.gov/solarsoft/hinode/eis/doc/eis_notes/25_IDL_SEARCH/eis_swnote_25.pdf] - How to search for and download EIS files from IDL (Peter Young)\\
These documents are also available in the EIS Solarsoft distribution, in $SSW/hinode/eis/doc/eis_notes.