CloudnetPy
CloudnetPy is Python software designed for producing vertical profiles of cloud properties from ground-based remote sensing measurements. The Cloudnet processing combines data from cloud radar, optical lidar, microwave radiometer, and numerical weather prediction models. Measurements and model data are brought into a common grid and classified as ice, liquid, aerosol, insects, and so on. Subsequently, geophysical products such as ice water content can be retrieved in further processing steps. See Illingworth et al. (2007) for more details about the concept.
CloudnetPy is a rewritten version of the original Cloudnet MATLAB code. It features several revised methods, extensive documentation, and more.
- CloudnetPy documentation: https://actris-cloudnet.github.io/cloudnetpy/
- Cloudnet data portal: https://cloudnet.fmi.fi
Installation
Option 1: From PyPI
python3 -m pip install cloudnetpy
Option 2: From the source
git clone https://github.com/actris-cloudnet/cloudnetpy
cd cloudnetpy/
python3 -m venv venv
source venv/bin/activate
python3 -m pip install --upgrade pip
python3 -m pip install .
Verification
Verify the installation by running cloudnetpy --help.
Command-line usage
CloudnetPy ships with a cloudnetpy console script that fetches data from the
Cloudnet data portal, runs the requested processing
steps, and writes netCDF files (and optionally plots) to disk:
cloudnetpy --site munich --date 2023-07-29 --products radar --show
cloudnetpy --site kenttarova --date 2025-07-29 --products classification --show
cloudnetpy -s kenttarova -d 2025-05-28 -p l3-cf -m harmonie-fmi-6-11 --show
See the command-line usage documentation for instrument selection, different products, plotting, ARM sites, and all options.
Citing
If you wish to acknowledge CloudnetPy in your publication, please cite:
Tukiainen et al., (2020). CloudnetPy: A Python package for processing cloud remote sensing data. Journal of Open Source Software, 5(53), 2123, https://doi.org/10.21105/joss.02123
Contributing
We encourage you to contribute to CloudnetPy! Please check out the contribution guidelines about how to proceed.
Development
Follow the installation instructions from the source above but install with the development dependencies and pre-commit hooks:
python3 -m pip install -e .[dev,test]
pre-commit install
Run unit tests:
python3 -m pytest
python3 -m pytest tests/unit/test_hatpro.py
Run end-to-end tests:
python3 tests/e2e_test.py
for f in cloudnetpy/model_evaluation/tests/e2e/*/main.py; do $f; done
Force pre-commit checks (ruff, mypy, etc.) for all files:
pre-commit run --all
License
MIT
Release files for cloudnetpy 1.96.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| cloudnetpy-1.96.2.tar.gz | 16.8 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| cloudnetpy-1.96.2-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 33.8 MB
Release files / cloudnetpy-1.96.2.tar.gz
| Download URL | cloudnetpy-1.96.2.tar.gz |
|---|---|
| Size | 16.8 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
f4190f473d1f7d59ba1f7144c378d9e83f1c705a97c2c04979eb8a912059050b
|
|
BLAKE2b-256 checksum How to use checksums |
bdad3da649526580023294563d180f67341637e43578a0f00ce7bd86d417150b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 17, 2026.
Transparency logRelease files / cloudnetpy-1.96.2-py3-none-any.whl
| Download URL | cloudnetpy-1.96.2-py3-none-any.whl |
|---|---|
| Size | 16.9 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
11fa4bb4ef21be257ff81a2b24a8ed4152edcc93ada75eccb8ebf6a299b0ef02
|
|
BLAKE2b-256 checksum How to use checksums |
4ed800c331bc5782d925e5ddd75567a7d8f9734f304e06fe24821c8eb69e8fea
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 17, 2026.
Transparency log
