ITERA
IDL Tool for Emission-line Ratio Analysis
ITERA, the IDL Tool for Emission-line Ratio Analysis, is an IDL widget tool which allows you to plot ratios of any strong atomic and ionized emission lines as determined by standard photoionization and shock models. These "line ratio diagrams" can then be used to determine diagnostics for nebulae excitation mechanisms (such as discussed in the Baldwin, Phillips, & Terlevich (1981) and Veillleux & Osterbrock (1987) papers) or nebulae parameters such as density, temperature, metallicity, etc. ITERA can also be used to determine line sensitivities to such parameters, compare observations with the models, or even estimate unobserved line fluxes. Details of the code and examples should be published later this year (Groves & Allen, in prep).
Below you will find the ITERA code, as well as the library of published MAPPINGSIII models to be used with the ITERA code, and directions for installation. The code is still currently in Beta mode, so if you have any difficulties, questions, improvements or find any bugs, please contact me (brent_at_strw.leidenuniv.nl). As the code is still Beta form, or for regular uses, I suggest email me anyway, with the subject "ITERA User" and I will add you the the ITERA user group, for emails when new libraries are added, or the code is updated. For those without IDL or access to IDL, a full runtime appplication (~80MB) is available upon request.
ITERA Code & Models
- itera.tgz This is the main ITERA program and associated sub routines (as of 01/12/2009)
- itera.sav This is the ITERA save file for use with IDL Virtual Machine. To run this, first install the itera program (and associated libraries) install the itera.sav file in the ITERA directory, and then run the IDL virtual machine (idl -vm) opening the .sav file.
- All Model Libraries: allmodels.tgz (78.2 MB) This file contains all the model libraries listed below (hence its size). To install, simply expand in the ITERA home directory.
- Shock Models: These should be placed and expanded in the shockdata directory in ITERA
- shock_only.tgz (23.9 MB) The 150-1000 km/s shock only model data from Allen et al. (2008)
- precursor.tgz (18.2 MB) The corresponding photoionized precursor for the shock models from Allen et al. (2008)
- shock_precursor.tgz (24.2 MB) The full shock + precursor models from Allen et al. (2008)
- AGN models: These should be placed and expanded in the AGNdata directory in ITERA
- Dusty_AGN.tgz The Dusty, radiation-pressure dominated AGN NLR Models of Groves et al. (2004)
- dustfree_AGN.tgz The classical dust free isochoric AGN NLR models of Groves et al. (2004)
- HII region/Starburst models: These should be placed and expanded in the SBdata directory in ITERA
- Kewley2001.tgz The Kewley et al. (2000) Starburst Model Data, including both the PEGASE 2.0 and Starburst99 stellar ionized models.
- Rparam.tgz The Dopita et al. (2006) R parameter evolving Starburst Model Data
- Levesque09_STD.tgz The star-forming galaxy photoionization models of Levesque et al. (2009) using starburst99 stellar ionizing spectra with standard mass loss rates.
- Levesque09_HIGH.tgz The star-forming galaxy photoionization models of Levesque et al. (2009) using starburst99 stellar ionizing spectra with high mass loss rates.
- User generated models: Any models generated and converted into the proper hdf format by the user should be placed in the Usermodel directory in ITERA. Below are the tools for converting the outputs from photoionization codes to the necessary ITERA format.Just expand these in the ITERA directory.
- convert_mappings.tgz The tools for converting MAPPINGSIII spectral files. convert_cloudy.tgz The tools for converting Cloudy (v08.00) output (*.out) files.
Installation Instructions
To install ITERA, simply download and untar & unzip the main code. To use the code either start IDL from the "ITERA" directory or make sure that the itera directory is in the IDL path. Once IDL is started simply type itera and the program will start. For those without IDL, a version of ITERA that works wth the free IDL virtual manager is currently being complied. Note that functionality of ITERA is severely limited without the inclusion of the associated published MAPPINGS models or user run models.
To install the associated models, these must be downloaded and moved
to the associated directories in the ITERA directory before being
expanded. This means that Shock models
(ie shockdata.tgz) should be expanded in the
"shockdata" directory, AGN models in the "AGNdata" directory and
Starburst models in the "SBdata" directory. once expanded in these
directories, simply run ITERA (as described above) and the
downloaded models shold be available for examination.