Skip to content
/ EQUIB Public

EQUIB - Fortran Program for Equilibrium Atomic Populations and Line Emissivities

License

Notifications You must be signed in to change notification settings

equib/EQUIB

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

19 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

EQUIB

Build Status Binder GitHub license Zenodo ASCL

Program EQUIB (FORTRAN 90)

The Fortran program EQUIB solves the statistical equilibrium equation for each ion and yields atomic level populations and line emissivities for given physical conditions, namely electron temperature and electron density, appropriate to the zones in an ionized nebula where the ions are expected to exist.

Installation

How to compile:

make

How to clean:

make clean

Usage

How to perform plasma diagnostics:

./diagnostic_equib arg1 arg2 arg3 arg4 arg5 arg6

arg1: the ion name e.g. 's_ii'.

arg2: the upper level from lines levels e.g. '1,2,1,3/' or '1,2/'.

arg3: the lower level from lines levels e.g. '1,5/' or '1,3/'.

arg4: the diagnostics line flux ratio of density- or temperature-sensitive lines e.g. '10.753'.

arg5: the diagnostics type: 'T' for temperature and 'D' for density.

arg6: the value of another fixed physical condition (density or temperature). It is density if arg5 = 'T', and temperature if arg5 = 'D'.

For example, to determine the electron temperature:

./diagnostic_equib 's_ii' '1,2,1,3/' '1,5/' '10.753' 'T' '2550.0'

For example, to determine the electron density:

./diagnostic_equib 's_ii' '1,2/' '1,3/' '1.506' 'D' '7000.0'

How to perform abundance analysis:

./abundance_equib arg1 arg2 arg3 arg4 arg5

arg1: the ion name e.g. 'o_iii'.

arg2: the atomic level from lines levels e.g. '3,4/'.

arg3: the electron temperature.

arg4: the electron density.

arg5: the observed line flux relative to Hb, on a scale where I(Hb)=100.0

For example, to determine the O2+ abundance from [O III] line flux I([O III])=1200, where Te=10000 K, and Ne=5000 cm-3:

./abundance_equib 'o_iii' '3,4/' '10000.0' '5000.0' '1200.0'

References

Publications used EQUIB

The Program EQUIB has been widely used in around 50 peer-reviewed publications since 1984:

Acknowledgement

If you employ the Program EQUIB in your work, please acknowledge the usage by citing the following references:

  • I. D. Howarth, S. Adams, R. E. S. Clegg, D. P. Ruffle, X.-W. Liu, C. J. Pritchet, & B. Ercolano, Astrophysics Source Code Library, ascl:1603.005, 2016

  • I.D. Howarth & S. Adams, Program EQUIB, University College London, 1981