CloudnetPy

CloudnetPy CI PyPI version DOI status

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 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, 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

Project links

Data verified by PyPI on Aug 3, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (1.94.6)

Owner

PyPI data
Data sourced directly from PyPI's database.

Credits

Author: Simo Tukiainen

GitHub Statistics

Data verified by PyPI on Aug 3, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License

MIT License (MIT License)

Requires

Python >=3.10

Provides Extra

test dev extras

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

cloudnetpy-1.94.0.tar.gz (16.8 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

cloudnetpy-1.94.0-py3-none-any.whl (16.9 MB view details)

Uploaded Python 3

File details

Details for the file cloudnetpy-1.94.0.tar.gz.

File metadata

  • Download URL: cloudnetpy-1.94.0.tar.gz
  • Upload date:
  • Size: 16.8 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for cloudnetpy-1.94.0.tar.gz
Algorithm Hash digest
SHA256 cd5a24d85b4bcbe7ca7693fafbcfc2e1c8a1e9100342ca47c5cd448f89415d6d
MD5 abafcd24ddb0849f5b4670e630972b1c
BLAKE2b-256 31822bcb3fddc0c7818ff82aa2e453830687e6f9945a18a174325c91c943db62

See more details on using hashes here.

Provenance

The following attestation bundles were made for cloudnetpy-1.94.0.tar.gz:

Publisher: publish.yml on actris-cloudnet/cloudnetpy

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file cloudnetpy-1.94.0-py3-none-any.whl.

File metadata

  • Download URL: cloudnetpy-1.94.0-py3-none-any.whl
  • Upload date:
  • Size: 16.9 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for cloudnetpy-1.94.0-py3-none-any.whl
Algorithm Hash digest
SHA256 0ac5efe546db2229477fc18f9551c024cda4c5772d3aab7fd691a6b3cda1e3b2
MD5 7d7e9863e472cf2d0984cbb8fb7f0514
BLAKE2b-256 528172a072b65bf76dbdeecd72300a795d637b2a300d58d3874dcedf29ec098e

See more details on using hashes here.

Provenance

The following attestation bundles were made for cloudnetpy-1.94.0-py3-none-any.whl:

Publisher: publish.yml on actris-cloudnet/cloudnetpy

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

1.94.6

1.94.5

1.94.4

1.94.3

1.94.2

1.94.1

This release

1.94.0

1.93.6

1.93.5

1.93.4

1.93.3

1.93.2

1.93.1

1.93.0

1.92.6

1.92.5

1.92.4

1.92.3

1.92.2

1.92.1

1.92.0

1.91.2

1.91.1

1.91.0

1.90.6

1.90.5

1.90.4

1.90.3

1.90.2

1.90.1

1.90.0

1.89.2

1.89.1

1.89.0

1.88.3

1.88.2

1.88.1

1.88.0

1.87.7

1.87.6

1.87.5

1.87.4

1.87.3

1.87.2

1.87.1

1.87.0

1.86.23

1.86.22

1.86.21

1.86.20

1.86.19

1.86.18

1.86.17

1.86.16

1.86.15

1.86.14

1.86.13

1.86.12

1.86.11

1.86.10

1.86.9

1.86.8

1.86.7

1.86.6

1.86.5

1.86.4

1.86.3

1.86.2

1.86.1

1.86.0

1.85.5

1.85.4

1.85.3

1.85.2

1.85.1

1.85.0

1.84.1

1.84.0

1.83.1

1.83.0

1.82.3

1.82.2

1.82.1

1.82.0

1.81.2

1.81.1

1.81.0

1.80.8

1.80.7

1.80.6

1.80.5

1.80.4

1.80.3

1.80.2

1.80.1

1.80.0

1.79.1

1.79.0

1.78.4

1.78.3

1.78.2

1.78.1

1.78.0

1.77.2

1.77.1

1.77.0

1.76.1

1.76.0

1.75.1

1.75.0

1.74.4

1.74.3

1.74.2

1.74.1

1.74.0

1.73.2

1.73.1

1.73.0

1.72.3

1.72.2

1.72.1

1.72.0

1.71.6

1.71.5

1.71.4

1.71.3

1.71.2

1.71.1

1.71.0

1.70.2

1.70.1

1.70.0

1.69.10

1.69.9

1.69.8

1.69.7

1.69.6

1.69.5

1.69.4

1.69.3

1.69.2

1.69.1

1.69.0

1.68.1

1.68.0

1.67.8

1.67.7

1.67.6

1.67.5

1.67.4

1.67.3

1.67.2

1.67.1

1.67.0

1.66.19

1.66.18

1.66.17

1.66.16

1.66.15

1.66.14

1.66.13

1.66.12

1.66.11

1.66.10

1.66.9

1.66.8

1.66.7

1.66.6

1.66.5

1.66.4

1.66.3

1.66.2

1.66.1

1.66.0

1.65.8

1.65.7

1.65.6

1.65.5

1.65.4

1.65.3

1.65.2

1.65.1

1.65.0

1.64.5

1.64.4

1.64.3

1.64.2

1.64.1

1.64.0

1.63.0

1.62.1

1.62.0

1.61.17

1.61.16

1.61.15

1.61.14

1.61.13

1.61.12

1.61.11

1.61.10

1.61.9

1.61.8

1.61.7

1.61.6

1.61.5

1.61.4

1.61.3

1.61.2

1.61.1

1.61.0

1.60.4

1.60.3

1.60.2

1.60.1

1.60.0

1.59.5

1.59.4

1.59.3

1.59.2

1.59.1

1.59.0

1.58.8

1.58.7

1.58.6

1.58.5

1.58.4

1.58.3

1.58.2

1.58.1

1.58.0

1.57.0

1.56.14

1.56.13

1.56.12

1.56.11

1.56.10

1.56.9

1.56.8

1.56.7

1.56.6

1.56.5

1.56.4

1.56.3

1.56.2

1.56.1

1.56.0

1.55.23

1.55.22

1.55.21

1.55.20

1.55.19

1.55.18

1.55.17

1.55.16

1.55.15

1.55.14

1.55.13

1.55.12

1.55.11

1.55.10

1.55.9

1.55.8

1.55.7

1.55.6

1.55.5

1.55.4

1.55.3

1.55.2

1.55.1

1.55.0

1.54.1

1.54.0

1.53.2

1.53.1

1.53.0

1.52.3

1.52.2

1.52.1

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page