AtomNeb IDL Library
AtomNeb-idl is a library written in Interactive Data Language (IDL)/GNU Data Language (GDL) for reading atomic data from AtomNeb, which is a database containing atomic data stored in the Flexible Image Transport System (FITS) file format for collisionally excited lines and recombination lines typically observed in spectra of ionized gaseous nebulae. The AtomNeb database were generated for use in proEQUIB, pyEQUIB, and other nebular spectral analysis tools.
Collisionally Excited Lines
AtomNeb for collisionally excited lines contains sets of atomic datasets, which include energy levels (Ej), collision strengths (Ωij), and transition probabilities (Aij) of the most ions commonly observed in ionized nebulae.
The atomic datasets for collisionally excited lines are as follows:
- Collection from the National Institute of Standards and Technology (NIST) Atomic Spectra Database, the CHIANTI atomic database, and some improved atomic data from Cloudy v13.04 and pyNeb v1.0. This collection was compiled according to the atomic data used in pyNeb v1.0.
- Chianti52 from the CHIANTI atomic database version 5.2. This dataset was compiled according to the atomic data used in MOCASSIN.
- Chianti60 from the CHIANTI atomic database version 6.0. This dataset was compiled according to the atomic data used in MOCASSIN.
- Chianti70 from the CHIANTI atomic database version 7.0. This dataset was compiled according to the atomic data used in MOCASSIN.
Each dataset contains the following atomic data FITS files:
AtomElj.fits for Energy Levels (Ej),
AtomOmij.fits for Collision Strengths (Ωij), and
AtomAij.fits for Transition Probabilities (Aij).
AtomNeb for recombination lines contains sets of effective recombination coefficients (αeff) of recombination lines of H I, He I, He II, C I, C II, C III, C VI, N II, N III, N IV, N V, N VI, N VII, O II, O III, O IV, O V, O VI, O VIII, and Ne II ions typically observed in ionized nebulae, as well as Branching ratios (Br) of O II and N II lines.
The atomic datasets for recombination lines are as follows:
- RC Collection, effective recombination coefficients for C II (Davey et al. 2000), N II (Escalante and Victor 1990), O II (Storey 1994; Liu et al. 1995), and Ne II ions (Kisielius et al. 1998), including Branching ratios (Br) for O II and N II ions. This collection was compiled according to the atomic data used in MOCASSIN.
- SH95 Collection, hydrogenic ions for Z=1 to 8, namely H I, He II, Li III, Be IV, B V, C VI, N VII, and O VIII ions from Storey and Hummer (1995).
- PPB91 Collection, effective recombination coefficients for H, He, C, N, O, Ne ions from Pequignot, Petitjean and Boisson (1991).
- PFSD12 He I data, effective He I recombination coefficients from Porter et al (2012) and (2013).
- FSL13 N II data, effective N II recombination coefficients (corrigendum) from Fang, Storey and Liu (2011) and (2013).
- SSB17 O II data, effective O II recombination coefficients of 8889 recombination lines for Cases A, B, and C, and 2433 optical (3500-9000Å) recombination lines for Case B from Storey, Sochi and Bastin (2017).
Dependent IDL Packages
This package requires the following packages:
To get this package with all the dependent packages, you can simply use
gitcommand as follows:
git clone --recursive https://github.com/atomneb/AtomNeb-idl
If you plan to use the recent O II recombination coefficients (Storey, Sochi and Bastin 2017), you need to unpack them:
cd AtomNeb-idl/atomic-data-rc/ tar -xvf *.fits.tar.gz
Installation in IDL
- To install the AtomNeb database and its API library in the Interactive Data Language (IDL), you need to add the path of this package directory to your IDL path. or more information about the path management in IDL, read the tips for customizing IDL program path provided by Harris Geospatial Solutions or the IDL library installation note by David Fanning in the Coyote IDL Library.
- This package requires IDL version 7.1 or later.
Installation in GDL
You can install the GNU Data Language (GDL) if you do not have it on your machine:
To install the AtomNeb database and its API library in GDL, you need to add the path of this package directory to your
.gdl_startupfile in your home directory:
!PATH=!PATH + ':/home/AtomNeb-idl/pro/' !PATH=!PATH + ':/home/AtomNeb-idl/externals/astron/pro/'
You may also need to set
GDL_STARTUPif you have not done in
setenv GDL_STARTUP ~/.gdl_startup
This package requires GDL version 0.9.8 or later.
- Danehkar, A. (2019). AtomNeb: IDL Library for Atomic Data of Ionized Nebulae. J. Open Source Softw., 4, 898. doi:10.21105/joss.00898