{"id":13764561,"url":"https://github.com/radis/radis","last_synced_at":"2026-03-07T23:02:48.435Z","repository":{"id":38819459,"uuid":"118933991","full_name":"radis/radis","owner":"radis","description":"🌱 A fast line-by-line code for high-resolution infrared molecular spectra","archived":false,"fork":false,"pushed_at":"2025-04-28T06:39:00.000Z","size":39385,"stargazers_count":237,"open_issues_count":83,"forks_count":145,"subscribers_count":11,"default_branch":"develop","last_synced_at":"2025-05-09T20:51:26.521Z","etag":null,"topics":["astrophysics","closember","combustion","exoplanets","hitemp","hitran","infrared","plasma","plasma-physics","radiation","spectra","spectroscopy"],"latest_commit_sha":null,"homepage":"http://radis.github.io/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"lgpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/radis.png","metadata":{"files":{"readme":"README.rst","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2018-01-25T15:54:18.000Z","updated_at":"2025-05-05T10:04:51.000Z","dependencies_parsed_at":"2024-02-16T12:43:00.784Z","dependency_job_id":"248385c8-9381-4a92-8beb-f37a665dcc8f","html_url":"https://github.com/radis/radis","commit_stats":{"total_commits":3003,"total_committers":64,"mean_commits":46.921875,"dds":0.745920745920746,"last_synced_commit":"28a9243ea91d3ec8d4ef234bd0f64c37b49ef56b"},"previous_names":[],"tags_count":42,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/radis%2Fradis","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/radis%2Fradis/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/radis%2Fradis/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/radis%2Fradis/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/radis","download_url":"https://codeload.github.com/radis/radis/tar.gz/refs/heads/develop","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253377280,"owners_count":21898939,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["astrophysics","closember","combustion","exoplanets","hitemp","hitran","infrared","plasma","plasma-physics","radiation","spectra","spectroscopy"],"created_at":"2024-08-03T16:00:22.890Z","updated_at":"2026-03-07T23:02:48.422Z","avatar_url":"https://github.com/radis.png","language":"Python","funding_links":[],"categories":["Infrared Spectroscopy","Atmosphere","Electromagnetism"],"sub_categories":["Radiative Transfer","Sound"],"readme":"| |badge_pypi|  |badge_pypistats| |badge_article1| |badge_article2| |badge_docs| |badge_binder|\n| |badge_slack| |badge_contributors| |badge_travis| |badge_coverage| |badge_asv| |badge_license|\n\n*****************************************\n`RADIS \u003chttps://radis.readthedocs.io/\u003e`__\n*****************************************\n\nRADIS is a fast line-by-line code for high resolution infrared molecular spectra (emission / absorption,\nequilibrium / non-LTE) based on HITRAN/HITEMP/ExoMol.\nAtomic spectra from the NIST and Kurucz databases are also available.\n\nRADIS includes post-processing tools to compare experimental spectra and spectra calculated\nwith RADIS or other spectral codes.\n\nFull user documentation (advanced install and examples) are available on the `RADIS Website \u003chttp://radis.readthedocs.io/\u003e`__.\n\n===============\nGetting Started\n===============\n\nInstall\n-------\n\nAssuming you have Python installed with the `Anaconda \u003chttps://www.anaconda.com/download/\u003e`_ distribution you can use ``pip``::\n\n    pip install radis\n\nor ``mamba`` or ``conda`` via the conda-forge channel::\n\n    conda install radis -c conda-forge\n\n**That's it!** You can now run your first example below.\nIf you encounter any issue, or to upgrade the package later, please refer to the\n`detailed installation procedure \u003chttps://radis.readthedocs.io/en/latest/dev/developer.html#label-install\u003e`__ .\n\nQuick Start\n-----------\n\nCalculate a CO equilibrium spectrum from the HITRAN database ::\n\n    from radis import calc_spectrum\n    s = calc_spectrum(1900, 2300,         # cm-1\n                      molecule='CO',\n                      isotope='1,2,3',\n                      pressure=1.01325,   # bar\n                      Tgas=700,           # K\n                      mole_fraction=0.1,\n                      path_length=1,      # cm\n                      databank='hitran'   # or 'hitemp'\n                      )\n    s.apply_slit(0.5, 'nm')       # simulate an experimental slit\n    s.plot('radiance')\n\n.. figure:: https://radis.readthedocs.io/en/latest/_images/co_spectrum_700K.png\n    :scale: 60 %\n\n\nAdvanced use\n------------\n\nThe Quick Start examples automatically download the line databases from `HITRAN-2016 \u003chttps://radis.readthedocs.io/en/latest/references/references.html#hitran-2016\u003e`__, which is valid for temperatures below 700 K.\nFor *high temperature* cases, you may need to use other line databases such as `HITEMP-2010 \u003chttps://radis.readthedocs.io/en/latest/references/references.html#hitemp-2010\u003e`__ (typically T \u003c 2000 K) or `CDSD-4000 \u003chttps://radis.readthedocs.io/en/latest/references/references.html#cdsd-4000\u003e`__ (T \u003c 5000 K). HITEMP can also be downloaded\nautomatically, or can be downloaded manually and described in a ``~/radis.json``\n`Configuration file \u003chttps://radis.readthedocs.io/en/latest/lbl/lbl.html#label-lbl-config-file\u003e`__.\n\nMore complex `examples \u003chttps://radis.readthedocs.io/en/latest/examples.html#label-examples\u003e`__ will require to use the `SpectrumFactory \u003chttps://radis.readthedocs.io/en/latest/source/radis.lbl.factory.html#radis.lbl.factory.SpectrumFactory\u003e`__\nclass, which is the core of RADIS line-by-line calculations.\n`calc_spectrum \u003chttps://radis.readthedocs.io/en/latest/source/radis.lbl.calc.html#radis.lbl.calc.calc_spectrum\u003e`__ is a wrapper to `SpectrumFactory \u003chttps://radis.readthedocs.io/en/latest/source/radis.lbl.factory.html#radis.lbl.factory.SpectrumFactory\u003e`__\nfor the simple cases.\n\nCompare with experiments\n------------------------\n\nExperimental spectra can be loaded using the `experimental_spectrum \u003chttps://radis.readthedocs.io/en/latest/source/radis.spectrum.models.html#radis.spectrum.models.experimental_spectrum\u003e`__ function\nand compared with the `plot_diff \u003chttps://radis.readthedocs.io/en/latest/source/radis.spectrum.compare.html#radis.spectrum.compare.plot_diff\u003e`__ function. For instance::\n\n    from numpy import loadtxt\n    from radis import experimental_spectrum, plot_diff\n    w, I = loadtxt('my_file.txt').T    # assuming 2 columns\n    sexp = experimental_spectrum(w, I, Iunit='mW/cm2/sr/nm')\n    plot_diff(sexp, s)    # comparing with spectrum 's' calculated previously\n\nTypical output of `plot_diff \u003chttps://radis.readthedocs.io/en/latest/source/radis.spectrum.compare.html#radis.spectrum.compare.plot_diff\u003e`__:\n\n.. image:: docs/spectrum/cdsd4000_vs_hitemp_3409K.svg\n    :scale: 60 %\n    :target: https://radis.readthedocs.io/en/latest/spectrum/spectrum.html#compare-two-spectra\n    :alt: https://radis.readthedocs.io/en/latest/_images/cdsd4000_vs_hitemp_3409K.svg\n\nRefer to the `Examples \u003chttps://radis.readthedocs.io/en/latest/examples/examples.html\u003e`__ section for more examples, and to the\n`Spectrum page \u003chttps://radis.readthedocs.io/en/latest/spectrum/spectrum.html\u003e`__ for more post-processing functions.\n\n\nGPU Acceleration\n----------------\n\nRADIS supports GPU acceleration for super-fast computation of spectra. Refer to `GPU Spectrum Calculation on RADIS \u003chttps://radis.readthedocs.io/en/latest/lbl/lbl.html#calculating-spectrum-using-gpu\u003e`__ for more details on GPU acceleration.::\n\n=======================================\nTry online (no installation needed!)\n=======================================\n\n🌱 Radis-app\n---------\n\nA simple `web-app \u003chttps://radis.app/\u003e`__ for RADIS under development - `GitHub \u003chttps://github.com/suzil/radis-app\u003e`__\n\n.. image:: https://user-images.githubusercontent.com/16088743/103406077-b2457100-4b59-11eb-82c0-e4de027a91c4.png\n    :target: https://radis.app/\n    :alt: https://radis.app/\n\n\n🔬 RADIS-lab\n---------\n\nAn `online environment \u003chttps://github.com/radis/radis-lab\u003e`__ for advanced spectrum processing and comparison with experimental data:\n\n- no need to install anything\n- use pre-configured line databases (HITEMP)\n- upload your data files, download your results !\n\n\n.. image:: https://user-images.githubusercontent.com/16088743/103448773-7d8f0200-4c9e-11eb-8bf1-ce3385519b77.png\n    :target: https://radis.github.io/radis-lab/\n    :alt: https://radis.github.io/radis-lab/\n\nSee more `on GitHub \u003chttps://github.com/radis/radis-lab\u003e`__\n\n\n---------------------------------------------------------------------\n\n====\nCite\n====\n\nArticles are available at |badge_article1| |badge_article2|\n\nFor reproducibility, do not forget to cite the line database used, and the spectroscopic constants\nif running nonequilibrium  calculations. See `How to cite? \u003chttps://radis.readthedocs.io/en/latest/references/references.html#cite\u003e`__\n\n---------------------------------------------------------------------\n\n===============\nDeveloper Guide\n===============\n\nContribute\n----------\n\nWant to contribute to RADIS? Join the Slack community and we'll help you through the process.\nWant to get started immediately? Nice. Have a look at the the `Developer Guide \u003chttps://radis.readthedocs.io/en/latest/dev/developer.html\u003e`__.\n\n|badge_contributors| |badge_slack|\n\n.. You need to know more about Spectroscopy ? We're working on Tutorials to\n.. make spectroscopy available to everyone. For the moment, join the\n.. `Slack channel \u003chttps://radis-radiation.slack.com/archives/C01N7R9728M\u003e`__ .\n\n\nRADIS internals are also described in the `full documentation \u003chttps://radis.readthedocs.io/en/latest/index.html\u003e`__\n\n.. .. image:: https://radis.readthedocs.io/en/latest/_images/RADIS_flow_chart.svg\n..      :target:   https://radis.readthedocs.io/en/latest/dev/architecture.html#label-dev-architecture\n..      :alt: https://radis.readthedocs.io/en/latest/_images/RADIS_flow_chart.svg\n\n\n.. ### Matlab\n\n.. Matlab users can seamlessly access Python modules\n\n.. Here's what's you'll need:\n\n.. 1. [Setup Python \u0026harr; Matlab interface](https://www.scivision.dev/matlab-python-user-module-import/).\n.. 2. Install RADIS in Python as at the top of this Readme.\n.. 3. From Matlab, verify everything is working by:\n\n..         ```\n..         py.radis.calc_spectrum()\n..         ```\n\n\nLicense\n-------\n\nThe code is available on this repository under\n`GNU LESSER GENERAL PUBLIC LICENSE (v3) \u003c./LICENSE\u003e`_   |badge_license|\n\n\n.. Support\n.. -------\n\n.. If encountering any problem, first refer to the list of known\n.. `Issues \u003chttps://github.com/radis/radis/issues?utf8=%E2%9C%93\u0026q=is%3Aissue\u003e`__ on GitHub.\n.. We appreciate your feedback and suggestions!\n\n.. For any question, please join the discussion channel on Gitter |badge_gitter|, Slack |badge_slack|\n.. or the `Q\u0026A Forum \u003chttps://groups.google.com/forum/#!forum/radis-radiation\u003e`__\n\n\n.. Finally, you can also suggest or vote for new features below:\n\n.. .. image:: https://feathub.com/radis/radis?format=svg\n..    :target: https://feathub.com/radis/radis\n\n\n\n---------------------------------------------------------------------\n\n==========\nReferences\n==========\n\nLinks\n-----\n\n- Documentation: |badge_docs|\n\n- Help: |badge_gitter| |badge_slack|  `Q\u0026A forum \u003chttps://groups.google.com/forum/#!forum/radis-radiation\u003e`__\n\n- Articles: |badge_article1| |badge_article2|\n\n- Source Code: |badge_stars| |badge_contributors| |badge_license|\n\n- Test Status: |badge_travis| |badge_coverage| |badge_asv|\n\n- PyPi Repository: |badge_pypi|  |badge_pypistats|\n\n- Interactive Examples: `radis_examples \u003chttps://github.com/radis/radis-examples\u003e`__ |badge_examples| |badge_binder|\n\n- `Fitroom \u003chttps://github.com/radis/fitroom\u003e`__ (for advanced multidimensional fitting).\n\n\n\nOther Spectroscopic tools\n-------------------------\n\nSee `awesome-spectra \u003chttps://github.com/erwanp/awesome-spectra\u003e`__   |badge_awesome_spectra|\n\n--------\n\n.. image:: https://github.com/radis/radis/blob/master/docs/radis_ico.png\n    :target: https://radis.readthedocs.io/\n    :scale: 50 %\n    :alt: RADIS logo\n\n\n\n\n\n.. |CO2| replace:: CO\\ :sub:`2`\n\n.. |badge_docs| image:: https://readthedocs.org/projects/radis/badge/\n                :target: https://readthedocs.org/projects/radis/\n                :alt: Documentation Status\n\n.. |badge_article1| image:: https://zenodo.org/badge/doi/10.1016/j.jqsrt.2018.09.027.svg\n                   :target: https://linkinghub.elsevier.com/retrieve/pii/S0022407318305867\n                   :alt: Article\n\n.. |badge_article2| image:: https://zenodo.org/badge/doi/10.1016/j.jqsrt.2020.107476.svg\n                   :target: https://linkinghub.elsevier.com/retrieve/pii/S0022407320310049\n                   :alt: Spectral Synthesis Algorithm\n\n.. |badge_stars| image:: https://img.shields.io/github/stars/radis/radis.svg?style=social\u0026label=Star\n                :target: https://github.com/radis/radis/stargazers\n                :alt: GitHub\n\n.. |badge_contributors| image:: https://img.shields.io/github/contributors/radis/radis.svg\n                        :target: https://github.com/radis/radis/graphs/contributors\n                        :alt: Contributors\n\n.. |badge_license| image:: https://img.shields.io/badge/License-LGPL3-blue.svg\n                   :target: ./License.md\n                   :alt: License\n\n.. |badge_travis| image:: https://app.travis-ci.com/radis/radis.svg?branch=develop\n                  :target: https://app.travis-ci.com/github/radis/radis\n                  :alt: Tests\n\n.. |badge_coverage| image:: https://codecov.io/gh/radis/radis/branch/develop/graph/badge.svg\n                    :target: https://codecov.io/gh/radis/radis\n                    :alt: Coverage\n\n.. |badge_asv| image:: http://img.shields.io/badge/benchmarked%20by-asv-blue.svg?style=flat\n                  :target: https://github.com/radis/radis-benchmark\n                  :alt: Benchmarks\n\n.. |badge_pypi| image:: https://img.shields.io/pypi/v/radis.svg\n                :target: https://pypi.python.org/pypi/radis\n                :alt: PyPI\n\n.. |badge_pypistats| image:: https://img.shields.io/pypi/dw/radis.svg\n                     :target: https://pypistats.org/packages/radis\n                     :alt: Downloads\n\n.. |badge_examples| image:: https://img.shields.io/github/stars/radis/radis-examples.svg?style=social\u0026label=Star\n                :target: https://github.com/radis/radis-examples\n                :alt: Examples\n\n.. |badge_awesome_spectra| image:: https://img.shields.io/github/stars/erwanp/awesome-spectra.svg?style=social\u0026label=Star\n                           :target: https://github.com/erwanp/awesome-spectra\n                           :alt: Examples\n\n.. |badge_binder| image:: https://mybinder.org/badge.svg\n                  :target: https://radis.github.io/radis-lab/\n                  :alt: https://radis.github.io/radis-lab/\n\n.. |badge_gitter| image:: https://badges.gitter.im/Join%20Chat.svg\n                  :target: https://gitter.im/radis-radiation/community\n                  :alt: Gitter\n\n.. |badge_slack| image:: https://img.shields.io/badge/slack-join-green.svg?logo=slack\n                  :target: https://radis.github.io/slack-invite/\n                  :alt: Slack\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fradis%2Fradis","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fradis%2Fradis","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fradis%2Fradis/lists"}