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.95.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.95.0
File	Size	Uploaded
cloudnetpy-1.95.0.tar.gz	16.8 MB	Aug 28, 2026	Details

Built distribution (wheel)

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

Total release size: 33.7 MB

Release files / cloudnetpy-1.95.0.tar.gz

Download URL	cloudnetpy-1.95.0.tar.gz
Size	16.8 MB
Tags	Source
SHA-256 checksum How to use checksums	`d2cd486dc209ed2abe8ba734fa9fbee2a7fd41c2cab5130497c2a1115d74ec82`
BLAKE2b-256 checksum How to use checksums	`6a01c51559b652d015f2ec77f597ac5893f205b81e364c6db54321869e1ab8b5`
Upload date	Aug 28, 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/fe326e48c2957044b38c8f3e12793d208b330dc6

Workflow

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

Artifact

Subject: cloudnetpy-1.95.0.tar.gz
SHA-256 checksum: d2cd486dc209ed2abe8ba734fa9fbee2a7fd41c2cab5130497c2a1115d74ec82 Verifying attestations

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

Download URL	cloudnetpy-1.95.0-py3-none-any.whl
Size	16.9 MB
Tags	Python 3
SHA-256 checksum How to use checksums	`74fc60365c41383003227c98379fa5e4c87aa0ea3f8c4be646c12b36a825ce02`
BLAKE2b-256 checksum How to use checksums	`799129135936d584ca84dda177e9f88abbb59e0ac8c3c1f45b5f453db1713908`
Upload date	Aug 28, 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/fe326e48c2957044b38c8f3e12793d208b330dc6

Workflow

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

Artifact

Subject: cloudnetpy-1.95.0-py3-none-any.whl
SHA-256 checksum: 74fc60365c41383003227c98379fa5e4c87aa0ea3f8c4be646c12b36a825ce02 Verifying attestations