pyrtlib
PyRTlib is an attractive educational software to simulate observations from ground-based, airborne, and satellite microwave sensors. It provides a flexible and user-friendly tool to broadly simulate how electromagnetic radiation travels through the atmosphere as it interacts with atmospheric constituents.
Science Score: 67.0%
This score indicates how likely this project is to be science-related based on various indicators:
-
✓CITATION.cff file
Found CITATION.cff file -
✓codemeta.json file
Found codemeta.json file -
✓.zenodo.json file
Found .zenodo.json file -
✓DOI references
Found 4 DOI reference(s) in README -
✓Academic publication links
Links to: zenodo.org -
○Committers with academic emails
-
○Institutional organization owner
-
○JOSS paper metadata
-
○Scientific vocabulary similarity
Low similarity (13.2%) to scientific vocabulary
Keywords
Repository
PyRTlib is an attractive educational software to simulate observations from ground-based, airborne, and satellite microwave sensors. It provides a flexible and user-friendly tool to broadly simulate how electromagnetic radiation travels through the atmosphere as it interacts with atmospheric constituents.
Basic Info
- Host: GitHub
- Owner: SatCloP
- License: gpl-3.0
- Language: Python
- Default Branch: main
- Homepage: https://satclop.github.io/pyrtlib/
- Size: 15.2 MB
Statistics
- Stars: 15
- Watchers: 4
- Forks: 5
- Open Issues: 0
- Releases: 10
Topics
Metadata Files
README.md

A Radiative Transfer Python Library (non-scattering)
PyRTlib is a Python package, for non-scattering line-by-line microwave RT simulations. PyRTlib is a user-friendly tool for computing down and up-welling brightness temperatures and related quantities (e.g., atmospheric absorption, optical depth, opacity) in Python.

Plotting of nadir upwelling $\Delta T_b$ using the last two absorption models available in PyRTlib for six reference atmosphere climatology.

Installation
Use pip package to install quicly the pyrtlib library. See installation instructions for more info on how instaling pyrtlib.
sh
$ pip install pyrtlib
Example
For examples of how to use pyrtlib see the examples gallery. Code can be downloaded both as python script or notebook file.
Performing calculation of upwelling brightness temperature.
python
from pyrtlib.tb_spectrum import TbCloudRTE
from pyrtlib.climatology import AtmosphericProfiles as atmp
from pyrtlib.utils import mr2rh, ppmv2gkg
Atmospheric profile definition:
python
z, p, _, t, md = atmp.gl_atm(atmp.MIDLATITUDE_SUMMER)
Units conversion:
python
gkg = ppmv2gkg(md[:, atmp.H2O], atmp.H2O)
Relative humidity of $H_2O$ (water vapor)
python
rh = mr2rh(p, t, gkg)[0] / 100
Deifinition of angles and frequencies:
python
ang = np.array([90.])
frq = np.arange(20, 1001, 1)
Initialize parameters for main execution:
python
rte = TbCloudRTE(z, p, t, rh, frq, ang)
Set absorption model:
python
rte.init_absmdl('R22SD')
Execute model by computing upwelling radiances:
python
df = rte.execute()
df.tbtotal
0 293.119811
1 292.538088
2 291.736672
3 291.913658
4 292.493971
...
976 230.179993
977 231.435965
978 232.592915
979 233.666322
980 234.667522
Name: tbtotal, Length: 981, dtype: float64
My first run with PyRTlib
You can get started with PyRTlib by installing and executing the first radiative transfer calculation from the following Colab Notebook
Cite as
Larosa, S., Cimini, D., Gallucci, D., Nilo, S. T., and Romano, F.: PyRTlib: an educational Python-based library for non-scattering atmospheric microwave radiative transfer computations, Geosci. Model Dev., 17, 2053–2076, https://doi.org/10.5194/gmd-17-2053-2024, 2024.
Larosa, S., Cimini, D., Gallucci, D., Nilo, S. T., & Romano, F. (2024). PyRTlib: a python package for non-scattering line-by-line microwave Radiative Transfer simulations. (Computer software). https://doi.org/10.5281/zenodo.8219145
Contributors
Owner
- Name: Satellite for Cloud and Precipitation
- Login: SatCloP
- Kind: organization
- Location: Italy
- Website: http://www.satclop.imaa.cnr.it/
- Repositories: 1
- Profile: https://github.com/SatCloP
National Research Council of Italy, Institute of Methodologies for Environmental Analysis (CNR-IMAA), Tito Scalo (Potenza), 85050, Italy
Citation (CITATION.cff)
# This CITATION.cff file was generated with cffinit.
# Visit https://bit.ly/cffinit to generate yours today!
cff-version: 1.2.0
title: >-
PyRTlib: a python package for non-scattering line-by-line
microwave radiative transfer simulations.
message: 'If you use this software, please cite it as below.
Larosa, S., Cimini, D., Gallucci, D., Nilo, S. T., and Romano, F.: PyRTlib: an educational Python-based library for non-scattering atmospheric microwave radiative transfer computations, Geosci. Model Dev., 17, 2053–2076, https://doi.org/10.5194/gmd-17-2053-2024, 2024.
Larosa, S., Cimini, D., Gallucci, D., Nilo, S. T., & Romano, F. (2024). PyRTlib: a python package for non-scattering line-by-line microwave Radiative Transfer simulations.. Zenodo. https://doi.org/10.5281/zenodo.8219145'
type: software
authors:
- family-names: Larosa
given-names: Salvatore
orcid: 'https://orcid.org/0000-0003-2588-6082'
- family-names: Cimini
given-names: Domenico
orcid: 'https://orcid.org/0000-0002-5962-223X'
- family-names: Gallucci
given-names: Donatello
orcid: 'https://orcid.org/0000-0002-6814-193X'
- family-names: Nilo
given-names: Saverio Teodosio
orcid: 'https://orcid.org/0000-0003-2630-8727'
- family-names: Romano
given-names: Filomena
orcid: 'https://orcid.org/0000-0002-0544-073X'
repository-code: 'https://github.com/SatCloP/pyrtlib'
url: 'https://satclop.github.io/pyrtlib/'
repository: 'https://pypi.org/project/pyrtlib/'
abstract: >-
PyRTlib is an attractive educational software to simulate
observations from ground-based, airborne, and satellite
microwave sensors. It provides a flexible and
user-friendly tool to broadly simulate how
electromagnetic radiation travels through the atmosphere
as it interacts with atmospheric constituents.
keywords:
- atmospheric-modelling
- microwave
- radiative-transfer-models
- python
license: GPL-3.0
version: 1.1.1
date-released: '2025-02-01'
doi: 10.5281/zenodo.8219145
GitHub Events
Total
- Release event: 1
- Watch event: 5
- Push event: 5
- Fork event: 2
- Create event: 1
Last Year
- Release event: 1
- Watch event: 5
- Push event: 5
- Fork event: 2
- Create event: 1
Committers
Last synced: about 2 years ago
Top Committers
| Name | Commits | |
|---|---|---|
| Salvatore Larosa | l****l@g****m | 253 |
| whitetuft | s****a@i****t | 214 |
| slarosa | s****s@g****m | 17 |
| Salvatore Larosa | s****a@g****m | 3 |
| nicocimini | n****i@a****t | 3 |
Committer Domains (Top 20 + Academic)
Issues and Pull Requests
Last synced: 8 months ago
All Time
- Total issues: 1
- Total pull requests: 25
- Average time to close issues: about 19 hours
- Average time to close pull requests: 1 day
- Total issue authors: 1
- Total pull request authors: 3
- Average comments per issue: 1.0
- Average comments per pull request: 0.8
- Merged pull requests: 24
- Bot issues: 0
- Bot pull requests: 0
Past Year
- Issues: 0
- Pull requests: 5
- Average time to close issues: N/A
- Average time to close pull requests: about 6 hours
- Issue authors: 0
- Pull request authors: 2
- Average comments per issue: 0
- Average comments per pull request: 1.2
- Merged pull requests: 4
- Bot issues: 0
- Bot pull requests: 0
Top Authors
Issue Authors
- ghislainp (1)
Pull Request Authors
- slarosa (28)
- Loretta-Pearl-Poku (2)
- MDS-007-52 (2)
Top Labels
Issue Labels
Pull Request Labels
Packages
- Total packages: 1
-
Total downloads:
- pypi 46 last-month
- Total dependent packages: 1
- Total dependent repositories: 0
- Total versions: 10
- Total maintainers: 1
pypi.org: pyrtlib
pyrtlib - Radiative Transfer library
- Documentation: https://satclop.github.io/pyrtlib
- License: GPLv3
-
Latest release: 1.1.1
published about 1 year ago