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

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.4
File	Size	Uploaded
cloudnetpy-1.95.4.tar.gz	16.8 MB	Sep 4, 2026	Details

Built distribution (wheel)

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

Total release size: 33.7 MB

Release files / cloudnetpy-1.95.4.tar.gz

Download URL	cloudnetpy-1.95.4.tar.gz
Size	16.8 MB
Tags	Source
SHA-256 checksum How to use checksums	`a9c8b079dffa8c2a57b6599d7ba11ec32bdfd4051f42139d67f463b638029348`
BLAKE2b-256 checksum How to use checksums	`011580a272c7ddaddc5eb3edd49121de2cad19fea61f41c55d3916aafcc9679d`
Upload date	Sep 4, 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/629df7f188a04219373f51c4a891165e97f62388

Workflow

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

Artifact

Subject: cloudnetpy-1.95.4.tar.gz
SHA-256 checksum: a9c8b079dffa8c2a57b6599d7ba11ec32bdfd4051f42139d67f463b638029348 Verifying attestations

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

Download URL	cloudnetpy-1.95.4-py3-none-any.whl
Size	16.9 MB
Tags	Python 3
SHA-256 checksum How to use checksums	`0a003165b241a3c8e38871f18d6c232ee09170636266f971ecea48c5c2e7327c`
BLAKE2b-256 checksum How to use checksums	`0a4f78750a3f0c17a32338a82e0b9791483bd8c0f8d278a0d5ff99c6380b5d52`
Upload date	Sep 4, 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/629df7f188a04219373f51c4a891165e97f62388

Workflow

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

Artifact

Subject: cloudnetpy-1.95.4-py3-none-any.whl
SHA-256 checksum: 0a003165b241a3c8e38871f18d6c232ee09170636266f971ecea48c5c2e7327c Verifying attestations