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
  • AGN models:
  • These should be placed and expanded in the AGNdata directory in ITERA
  • HII region/Starburst models:
  • These should be placed and expanded in the SBdata directory in ITERA
  • 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.
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.

This page was last modified on 11 October 2009.