CloudnetPy-QC

Software for evaluating quality of ACTRIS-Cloudnet data products.

Installation

$ pip3 install cloudnetpy-qc

Usage

import json
from cloudnetpy_qc import quality
site_meta = {"latitude": 61.844, "longitude": 24.287, "altitude": 150}
report = quality.run_tests('cloudnet-file.nc', site_meta)
json_object = json.dumps(report.to_dict(), indent=2)
print(json_object)

Format of the report

timestamp: UTC timestamp of the test
qcVersion: cloudnetpy-qc version
tests: Test[]
data_coverage: float

`Test`

testId: Unique name of the test
exceptions: Exception[]

`Exception`

message: Free-form message about the exception
result: "info", "error" or "warning"

Example:

{
  "timestamp": "2022-10-13T07:00:26.906815Z",
  "qcVersion": "1.1.2",
  "tests": [
    {
      "testId": "TestUnits",
      "exceptions": []
    },
    {
      "testId": "TestInstrumentPid",
      "exceptions": [
        {
          "message": "Instrument PID is missing.",
          "result": "warning"
        }
      ]
    },
    {
      "testId": "TestTimeVector",
      "exceptions": []
    },
    {
      "testId": "TestVariableNames",
      "exceptions": []
    },
    {
      "testId": "TestCFConvention",
      "exceptions": []
    }
  ]
}

Tests

Test	Description
`FindAttributeOutliers`	Find suspicious values in global attributes.
`FindFolding`	Test for radar folding.
`FindVariableOutliers`	Find suspicious data values.
`TestBrightnessTemperature`	Test that brightness temperature data are valid.
`TestCFConvention`	Test compliance with the CF metadata conventions.
`TestComment`	Check that variables have expected comments.
`TestCompression`	Test netCDF compression.
`TestCoordinateVariables`	Test dimensions of coordinate variables are correct.
`TestCoordinates`	Check that file coordinates match site coordinates.
`TestDataCoverage`	Test that file contains enough data.
`TestDataModel`	Test netCDF data model.
`TestDataTypes`	Check that variables have expected data types.
`TestFillValue`	Test that fill value is explicitly set for variables with missing data.
`TestFloatingPointValues`	Test for special floating-point values which may indicate problems with the processing.
`TestGlobalAttributes`	Check that file contains required global attributes.
`TestIfRangeCorrected`	Test that beta is range corrected.
`TestInstrumentPid`	Test that valid instrument PID exists.
`TestLDR`	Test that LDR values are proper.
`TestLWC`	Test that LWP and integrated LWC are consistent.
`TestLidarBeta`	Test that one beta variable exists.
`TestLongNames`	Check that variables have expected long names.
`TestMWRMultiTemperature`	Test that temperature data are valid.
`TestMWRSingleLWP`	Test that LWP data are valid.
`TestMask`	Test that data are not completely masked.
`TestMedianLwp`	Test that LWP data are valid.
`TestModelData`	Test that model data are valid.
`TestRainfallConsistency`	Test that precipitation rate and amount are consistent.
`TestRangeAndHeight`	Test that range and height data are valid.
`TestStandardNames`	Check that variable have expected standard names.
`TestTimeVector`	Test that time vector is continuous.
`TestUnexpectedMask`	Test if data contain unexpected masked values.
`TestUnits`	Check that variables have expected units.
`TestVariableNames`	Check that file contains required variables.
`TestVariableNamesDefined`	Check that variables have expected names.
`TestZenithAngle`	Test lidar zenith angle.

License

MIT

Metadata

Release files for cloudnetpy-qc 1.32.2

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-qc 1.32.2
File	Size	Uploaded
cloudnetpy_qc-1.32.2.tar.gz	369.0 kB	Oct 6, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for cloudnetpy-qc 1.32.2
File	Interpreter	ABI	Platform	Reset
cloudnetpy_qc-1.32.2-py3-none-any.whl 371.6 kB Oct 6, 2026	Python 3	none	any	Details

Total release size: 740.5 kB

Release files / cloudnetpy_qc-1.32.2.tar.gz

Download URL	cloudnetpy_qc-1.32.2.tar.gz
Size	369.0 kB
Tags	Source
SHA-256 checksum How to use checksums	`51266515829751e1be7ffbf2d4edfa636f147a8e2897a2c097933a3ee63bb0a6`
BLAKE2b-256 checksum How to use checksums	`cc4859068ceb5f45fa0e3c0ee9357e7bc6ad6d7d9cb9afae0a8e16f88aa42be2`
Upload date	Oct 6, 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-qc
Publishing commit: github.com/actris-cloudnet/cloudnetpy-qc/tree/5306c6cd3e9d5cc16c45ad1c7d8441368bd0dda3

Workflow

Publishing configuration: github.com/actris-cloudnet/cloudnetpy-qc/blob/5306c6cd3e9d5cc16c45ad1c7d8441368bd0dda3/.github/workflows/publish.yml
Publishing logs: github.com/actris-cloudnet/cloudnetpy-qc/actions/runs/37469490564/attempts/1

Artifact

Subject: cloudnetpy_qc-1.32.2.tar.gz
SHA-256 checksum: 51266515829751e1be7ffbf2d4edfa636f147a8e2897a2c097933a3ee63bb0a6 Verifying attestations

Release files / cloudnetpy_qc-1.32.2-py3-none-any.whl

Download URL	cloudnetpy_qc-1.32.2-py3-none-any.whl
Size	371.6 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`1a389710cfa6de389cd105de402bf55dbda5b887d372b859713c20c3adb0c906`
BLAKE2b-256 checksum How to use checksums	`84666bf7cce1415f4c1d95d64bfdf83e6df6355f74bd484f1a376b9591d47744`
Upload date	Oct 6, 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-qc
Publishing commit: github.com/actris-cloudnet/cloudnetpy-qc/tree/5306c6cd3e9d5cc16c45ad1c7d8441368bd0dda3

Workflow

Publishing configuration: github.com/actris-cloudnet/cloudnetpy-qc/blob/5306c6cd3e9d5cc16c45ad1c7d8441368bd0dda3/.github/workflows/publish.yml
Publishing logs: github.com/actris-cloudnet/cloudnetpy-qc/actions/runs/37469490564/attempts/1

Artifact

Subject: cloudnetpy_qc-1.32.2-py3-none-any.whl
SHA-256 checksum: 1a389710cfa6de389cd105de402bf55dbda5b887d372b859713c20c3adb0c906 Verifying attestations