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.

https://github.com/satclop/pyrtlib

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

atmospheric-modelling microwave python radiative-transfer-models
Last synced: 6 months ago · JSON representation ·

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
Statistics
  • Stars: 15
  • Watchers: 4
  • Forks: 5
  • Open Issues: 0
  • Releases: 10
Topics
atmospheric-modelling microwave python radiative-transfer-models
Created almost 5 years ago · Last pushed about 1 year ago
Metadata Files
Readme License Citation

README.md

A Radiative Transfer Python Library (non-scattering)

docker-image-ci run-python-tests build-docs-action

Project Status: WIP – Initial development is in progress, but there has not yet been a stable, usable release suitable for the public. PyPI Latest Release GitHub release (latest by date)

Last commit Last commit since

codecov Codacy Badge

license DOI

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.

spectrum

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

spectrum

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 Open In Colab

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

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

All Time
  • Total Commits: 490
  • Total Committers: 5
  • Avg Commits per committer: 98.0
  • Development Distribution Score (DDS): 0.484
Past Year
  • Commits: 260
  • Committers: 5
  • Avg Commits per committer: 52.0
  • Development Distribution Score (DDS): 0.338
Top Committers
Name Email 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

  • Versions: 10
  • Dependent Packages: 1
  • Dependent Repositories: 0
  • Downloads: 46 Last month
Rankings
Dependent packages count: 7.6%
Average: 38.4%
Dependent repos count: 69.3%
Maintainers (1)
Last synced: 7 months ago