A non-equilibrium Radiative Solver for HITRAN-like database species
Project description
RADIS
A nonequilibrium infrared emission and absorption line-by-line code & a post-processing library to compare experimental and calculated spectra.
User guide, install procedure and examples are available on the RADIS Website:
Getting Started
Install
Assuming you have Python installed with the Anaconda distribution just use:
pip install radis
That's it! You can now run your first example below. If you encounter any issue, or to upgrade the package later, please refer to the detailed installation procedure .
Quick Start
Calculate a CO equilibrium spectrum from the HITRAN database, using the calc_spectrum function. Output is a Spectrum object: :
from radis import calc_spectrum
s = calc_spectrum(1900, 2300, # cm-1
molecule='CO',
isotope='1,2,3',
pressure=1.01325, # bar
Tgas=700, # K
mole_fraction=0.1,
path_length=1, # cm
)
s.apply_slit(0.5, 'nm') # simulate an experimental slit
s.plot('radiance')
Calculate a CO nonequilibrium spectrum from the HITRAN database (on your first call, this will calculate and cache the CO(X) rovibrational energies): :
s2 = calc_spectrum(1900, 2300, # cm-1
molecule='CO',
isotope='1,2,3',
pressure=1.01325, # bar
Tvib=700, # K
Trot=300, # K
mole_fraction=0.1,
path_length=1, # cm
)
s2.apply_slit(0.5, 'nm')
s2.plot('radiance', nfig='same') # compare with previous
The Quick Start examples automatically download the line databases from
HITRAN-2016,
which is valid for temperatures below 700 K. For high temperature
cases, you may need to use other line databases such as
HITEMP-2010
(typically T < 2000 K) or
CDSD-4000
(T < 5000 K). These databases must be described in a ~/.radis
Configuration
file.
More complex examples will require to use the SpectrumFactory class, which is the core of RADIS line-by-line calculations. calc_spectrum is a wrapper to SpectrumFactory for the simple cases.
Experimental spectra can be loaded using the experimental_spectrum function and compared with the plot_diff function. For instance:
from numpy import loadtxt
from radis import experimental_spectrum, plot_diff
w, I = loadtxt('my_file.txt').T # assuming 2 columns
sexp = experimental_spectrum(w, I, Iunit='mW/cm2/sr/nm')
plot_diff(sexp, s) # comparing with previously spectrum 's' calculated previously
Typical output of plot_diff:
Refer to the Examples section for more examples, and to the Spectrum page for more post-processing functions.
In the browser (no installation needed!)
Alternatively, you can also run RADIS directly in the browser with the RADIS Interactive Examples project. For instance, run the Quick Start example on the link below:
Or start a bare RADIS online session:
Developer Guide
Architecture
RADIS internals are described in the Developer Guide :
License
The code is available on this repository under GNU LESSER GENERAL PUBLIC LICENSE (v3)
Support
If encountering any problem, first refer to the list of known Issues on GitHub. We appreciate your feedback and suggestions!
For any question, please join the discussion channel on Gitter:
References
Links
RADIS:
-
Documentation: http://radis.readthedocs.io/
-
Source Code: https://github.com/radis/radis
-
Article: https://linkinghub.elsevier.com/retrieve/pii/S0022407318305867
And also:
-
Test Status: https://travis-ci.org/radis/radis
-
Test Coverage: https://codecov.io/gh/radis/radis
-
PyPi Repository: https://pypi.org/project/radis/
-
Interactive Examples: https://github.com/radis/radis-examples
Other Spectroscopic tools
Similar packages or softwares you could be interested in (please reference your own if not there!) :
- specutil: a Python package for spectral analysis in astronomy
- pyspeckit: a python spectroscopic toolkit
- rampy: a Python package for spectral data processing (IR, Raman, XAS...)
- scikit-spectra: Python pandas-based toolkit for explorative spectroscopy, in particular UVVis spectroscopic data.
- WrightTools: a Python package for multidimensional spectroscopy
- spectools: Python tools of the BeACoN group
- SpectroscoPyx: a Python package for spectroscopy
- Spectragryph: software for FTIR / organic spectroscopy
And in general the list of GitHub spectroscopy related packages
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for radis-0.9.19-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 367d0106640a3ce6d2b64b37b0f06b75dc11f39512f495f2c664cdbba4b03359 |
|
MD5 | 088ed333c5ef796f13ba910aced11d25 |
|
BLAKE2b-256 | b0b4263fbb27f5f96e0840af1e326aa8ad30515cf91f6084fb6a0866df19465c |