This project has been archived by its maintainers, and is no longer receiving any updates.
ppfive
A PP and Fields file reader that mimics relevant parts of the pyfive high-level API,
with support for lazy metadata loading and parallel data loading when necessary.
This is NOT an alternative to pyfive, it is a package which makes pp and fields files look like and taste ("quack like") chunked HDF5 files written by a NetCDF library.
API Contract (ppfive vs pyfive)
ppfive is designed to be pyfive-compatible as far as likely users of pyfive
would need such compatability. That is, it produces a chunk index (for kerchunk)
if you really want that, and it supports all the information needed by CF/CFDM
workflows to make pp-data as CF-compliant as possible.
For the canonical pyfive interface, see the pyfive docs:
What maps directly to pyfive
ppfive.Fileis registered as apyfive.Filevirtual type (whenpyfiveis installed).ppfive.Variableis registered as apyfive.Datasetvirtual type.- File/root-level members expected by pyfive-style callers are present:
attrs,groups,variables,dimensions,name,path,parent
- Mapping-style access works:
f["var"], iteration over variables,items(),len(f)
- Dataset-like variable members needed by downstream consumers are present:
shape,dtype,ndim,size,attrs,chunks/chunk_shape,file,parent- slicing/indexing via
__getitem__(for examplef["var"][:]) read_direct,astype(...),iter_chunks(...)
Like pyfive, ppfive is Read-only:
- `File(..., mode="r")` is supported; write/update modes are not.
Important differences from pyfive
- No nested groups in PP/Fields model:
f["group/var"]is not supported.groupsexists for compatibility but is empty for current PP/Fields inputs.
get_lazy_view(...)fallback behavior:pyfive-style API entry exists, but returns the normal variable view with an info log.
- Some Dataset properties are intentionally placeholders (
None) because they are not meaningful for PP/Fields records:compression,compression_opts,shuffle,fletcher32,maxshape,fillvalue,dims,scaleoffset.
- Compatibility metadata is synthesized for CF/cfdm bridging:
- dimension-scale datasets and
DIMENSION_LISTare created where needed. - rotated-grid helper variables (for example
latitude,longitude,rotated_latitude_longitude) may be exposed when implied by UM headers.
- dimension-scale datasets and
- ppfive-specific extension API:
File.set_parallelism(thread_count=..., cat_range_allowed=...)is provided by ppfive and is not part ofpyfive.
Practical expectation
If your code treats ppfive.File and ppfive.Variable as pyfive-like read objects,
common analysis workflows should work, including chunk-level access (pp records
are treated as chunks).
Authorship
Key authors of this package are:
- David Hassell (@davidhassell)
- Alan Iwi (@alaniwi)
- Bryan Lawrence (@bnlawrence)
1 maintainer
Metadata
1 maintainer
Release files for ppfive 0.2.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| ppfive-0.2.0.tar.gz | 19.9 MB | With provenance | Details for ppfive-0.2.0.tar.gz |
Built distributions (wheels)
Total release size: 21.3 MB
Release files / ppfive-0.2.0.tar.gz
| Download URL | ppfive-0.2.0.tar.gz |
|---|---|
| Size | 19.9 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
67548aa82a33c66228e251522af2696b761f4e158b1a84ad74e12dcd8acc70a7
|
|
BLAKE2b-256 checksum How to use checksums |
066c5c9f2b20aafc98b3a1ce9d9a73705dffb2bc92a2f42b1425079f1546dbef
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 3, 2026.
Transparency logRelease files / ppfive-0.2.0-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
| Download URL | ppfive-0.2.0-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl |
|---|---|
| Size | 188.3 kB |
| Tags | CPython 3.14 Linux glibc 2.17+ x86-64 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
ad52ddc81dde1f4ebcc3f7f2ce066251803975e3588dc8a095271af958f438c6
|
|
BLAKE2b-256 checksum How to use checksums |
071c2c3900f28b22573edda2d52b24de3c240f4f18352f2cd687f7e6698407f9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 3, 2026.
Transparency logRelease files / ppfive-0.2.0-cp314-cp314-macosx_11_0_arm64.whl
| Download URL | ppfive-0.2.0-cp314-cp314-macosx_11_0_arm64.whl |
|---|---|
| Size | 159.6 kB |
| Tags | CPython 3.14 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
99e90c24b441da5639033b72dfac06c943676941a3ba54c09b1cdb5b92e2ad57
|
|
BLAKE2b-256 checksum How to use checksums |
4746027e24b7c7194a5f27467d2eb75d7189821ed85a7ac230afe5c77645cdc1
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 3, 2026.
Transparency logRelease files / ppfive-0.2.0-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
| Download URL | ppfive-0.2.0-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl |
|---|---|
| Size | 188.1 kB |
| Tags | CPython 3.13 Linux glibc 2.17+ x86-64 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
c30a6871c3d5296d0c4bd463bd8e5720aad173f48b7924816b20b44ba5b94504
|
|
BLAKE2b-256 checksum How to use checksums |
6031cbae114c1be3f3671fe5027c50c6a2d86af813aec94a5c614d86f477e492
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 3, 2026.
Transparency logRelease files / ppfive-0.2.0-cp313-cp313-macosx_11_0_arm64.whl
| Download URL | ppfive-0.2.0-cp313-cp313-macosx_11_0_arm64.whl |
|---|---|
| Size | 159.6 kB |
| Tags | CPython 3.13 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
39a2f6c38c40a1d33a05f6ce90e523f1b5b4abbceabb1f2c9064a504a41fb32a
|
|
BLAKE2b-256 checksum How to use checksums |
d38c8c5aa3c34a61b25386b55d69e4e779aca6f91c92fbf3a9afb157ac8880dd
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 3, 2026.
Transparency logRelease files / ppfive-0.2.0-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
| Download URL | ppfive-0.2.0-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl |
|---|---|
| Size | 188.0 kB |
| Tags | CPython 3.12 Linux glibc 2.17+ x86-64 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
23a5313cacd80aa26e7ca5df738d3d11c991300f091a58afe7adbc9712a63097
|
|
BLAKE2b-256 checksum How to use checksums |
549d2baa305d18db9be4d32ec5368b016a77b2d616b64ab63570db35408b7dc9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 3, 2026.
Transparency logRelease files / ppfive-0.2.0-cp312-cp312-macosx_11_0_arm64.whl
| Download URL | ppfive-0.2.0-cp312-cp312-macosx_11_0_arm64.whl |
|---|---|
| Size | 159.6 kB |
| Tags | CPython 3.12 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
c7b9a31a3d588e278ea83be092f64353e00290c6e886c929c23357253e1d1f41
|
|
BLAKE2b-256 checksum How to use checksums |
cc07716e44c87e0f69fc431ab5b2b4dc586844119cba1c3a2c10e5cb683354f1
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 3, 2026.
Transparency logRelease files / ppfive-0.2.0-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
| Download URL | ppfive-0.2.0-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl |
|---|---|
| Size | 188.3 kB |
| Tags | CPython 3.11 Linux glibc 2.17+ x86-64 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
b6dcb822a858c79be8ce0b2f35f5699189108bb39dbcaa6621b8379479a51c12
|
|
BLAKE2b-256 checksum How to use checksums |
8ee3e3e2788fbecce69f11afe5a3087d0c8bf47111e2a4796f6c92fd35a99a4c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 3, 2026.
Transparency logRelease files / ppfive-0.2.0-cp311-cp311-macosx_11_0_arm64.whl
| Download URL | ppfive-0.2.0-cp311-cp311-macosx_11_0_arm64.whl |
|---|---|
| Size | 159.5 kB |
| Tags | CPython 3.11 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
af318140a59cb6c76fad49af1b0e52685f4e8e559cbac01b005a9c051ac71969
|
|
BLAKE2b-256 checksum How to use checksums |
cf1d1d16ffbbe1516d30086f5654f4f4a58c78c5511eb2a19c5735a2ca485594
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 3, 2026.
Transparency logSecurity for ppfive 0.2.0
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.
Full provenance
All 9 files in this release have been uploaded with provenance metadata.
Attestation for ppfive-0.2.0.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 3, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
