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

CloudnetPy example output

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.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for cloudnetpy 1.96.0
File	Size	Uploaded
cloudnetpy-1.96.0.tar.gz	16.8 MB	Sep 10, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for cloudnetpy 1.96.0
File	Interpreter	ABI	Platform	Reset
cloudnetpy-1.96.0-py3-none-any.whl 16.9 MB Sep 10, 2026	Python 3	none	any	Details

Total release size: 33.8 MB

Release files / cloudnetpy-1.96.0.tar.gz

Download URL	cloudnetpy-1.96.0.tar.gz
Size	16.8 MB
Tags	Source
SHA-256 checksum How to use checksums	`4c40e4171f9e52d0583aa5edefec2cce30807e796ea1417f8b39294ab5faf9a5`
BLAKE2b-256 checksum How to use checksums	`1771541b536335ed6268ebdf441085dddfc25ec9eaf5534ab161e87d2c90c7df`
Upload date	Sep 10, 2026
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.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/actris-cloudnet/cloudnetpy
Publishing commit: github.com/actris-cloudnet/cloudnetpy/tree/d9290292e81ce6740c7f24b798e9c1096d68da98

Workflow

Publishing configuration: github.com/actris-cloudnet/cloudnetpy/blob/d9290292e81ce6740c7f24b798e9c1096d68da98/.github/workflows/publish.yml
Publishing logs: github.com/actris-cloudnet/cloudnetpy/actions/runs/34472438842/attempts/1

Artifact

Subject: cloudnetpy-1.96.0.tar.gz
SHA-256 checksum: 4c40e4171f9e52d0583aa5edefec2cce30807e796ea1417f8b39294ab5faf9a5 Verifying attestations

Release files / cloudnetpy-1.96.0-py3-none-any.whl

Download URL	cloudnetpy-1.96.0-py3-none-any.whl
Size	16.9 MB
Tags	Python 3
SHA-256 checksum How to use checksums	`ef958a76619a8a1ceeb9c309336d7a9575ea62f3ddbcd2fc69c6ca2dd5e8d7a9`
BLAKE2b-256 checksum How to use checksums	`f5985e7a3bc50c4fd479bee1aefa3c7906a213a811bbed6726370753fda2f1bc`
Upload date	Sep 10, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/actris-cloudnet/cloudnetpy
Publishing commit: github.com/actris-cloudnet/cloudnetpy/tree/d9290292e81ce6740c7f24b798e9c1096d68da98

Workflow

Publishing configuration: github.com/actris-cloudnet/cloudnetpy/blob/d9290292e81ce6740c7f24b798e9c1096d68da98/.github/workflows/publish.yml
Publishing logs: github.com/actris-cloudnet/cloudnetpy/actions/runs/34472438842/attempts/1

Artifact

Subject: cloudnetpy-1.96.0-py3-none-any.whl
SHA-256 checksum: ef958a76619a8a1ceeb9c309336d7a9575ea62f3ddbcd2fc69c6ca2dd5e8d7a9 Verifying attestations