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.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-qc 1.32.0
File	Size	Uploaded
cloudnetpy_qc-1.32.0.tar.gz	368.9 kB	Sep 10, 2026	Details

Built distribution (wheel)

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

Total release size: 740.5 kB

Release files / cloudnetpy_qc-1.32.0.tar.gz

Download URL	cloudnetpy_qc-1.32.0.tar.gz
Size	368.9 kB
Tags	Source
SHA-256 checksum How to use checksums	`0c1e0121a925677e111794daf44049664b7d1e615a7ca0ab37f61e2644c1749a`
BLAKE2b-256 checksum How to use checksums	`2bd5163907571e44adb8538e4204b6a9096a69a6279226303ff855f366e5d8f5`
Upload date	Sep 10, 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/639dbc4ecbd7f0d4997b8383369d53179af99122

Workflow

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

Artifact

Subject: cloudnetpy_qc-1.32.0.tar.gz
SHA-256 checksum: 0c1e0121a925677e111794daf44049664b7d1e615a7ca0ab37f61e2644c1749a Verifying attestations

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

Download URL	cloudnetpy_qc-1.32.0-py3-none-any.whl
Size	371.6 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`af58242506343efcf5878dd55b22cfb8a7838a597bf88393e708b9186f139fed`
BLAKE2b-256 checksum How to use checksums	`f8d2d4df2a2ced26c2e439e3ba762418e10921189bff8e262a33d8f44974ff78`
Upload date	Sep 10, 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/639dbc4ecbd7f0d4997b8383369d53179af99122

Workflow

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

Artifact

Subject: cloudnetpy_qc-1.32.0-py3-none-any.whl
SHA-256 checksum: af58242506343efcf5878dd55b22cfb8a7838a597bf88393e708b9186f139fed Verifying attestations