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

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.31.8
File	Size	Uploaded
cloudnetpy_qc-1.31.8.tar.gz	368.8 kB	Sep 3, 2026	Details

Built distribution (wheel)

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

Total release size: 740.2 kB

Release files / cloudnetpy_qc-1.31.8.tar.gz

Download URL	cloudnetpy_qc-1.31.8.tar.gz
Size	368.8 kB
Tags	Source
SHA-256 checksum How to use checksums	`7d2fa5579f82cac6341794a4ba33649f61123f2a93f907139d0503a3a8c2e64b`
BLAKE2b-256 checksum How to use checksums	`67d21421d8b88511f62c6052c7f438f8a2495af77129c30ddc47bbca27e1a501`
Upload date	Sep 3, 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/b23b40a124b8427fb427aa1357bc00cc401a7704

Workflow

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

Artifact

Subject: cloudnetpy_qc-1.31.8.tar.gz
SHA-256 checksum: 7d2fa5579f82cac6341794a4ba33649f61123f2a93f907139d0503a3a8c2e64b Verifying attestations

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

Download URL	cloudnetpy_qc-1.31.8-py3-none-any.whl
Size	371.4 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`7cc87d9e567b0142fb3f66157bb2577bc8f41d80f8d50ac606325cd36fde0577`
BLAKE2b-256 checksum How to use checksums	`f3a4f9e8f83bca953ebc268239e8deae6c1e2824a669e6087f63309b0ec6b756`
Upload date	Sep 3, 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/b23b40a124b8427fb427aa1357bc00cc401a7704

Workflow

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

Artifact

Subject: cloudnetpy_qc-1.31.8-py3-none-any.whl
SHA-256 checksum: 7cc87d9e567b0142fb3f66157bb2577bc8f41d80f8d50ac606325cd36fde0577 Verifying attestations