Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

Validator and examples for openPMD format

Project Description

# openPMD Validator Scripts

[![Build Status 1.1.X](](
![Supported Python Versions](

This repository contains scripts to validate existing files that (claim to)
implement the [openPMD Standard](
in version `1.1.*`.

Additional scripts to create random/empty files with the valid markup of the
standard are also provided.

## Rationale

These tools are intended for developers that want to implementent the standard.
They were written to allow an easy *implement-test-correct* workflow without
the hazzle to check every word of the written standard twice.

Nevertheless, these scripts can not validate 100% of the standard and uncovered
sections shall be cross-checked manually with the words of the written

For more information on requirements for implementations, please refer to the
of the openPMD standard. The repository
also lists a large collection of open source projects that already implement
the openPMD standard.

## Install

[![pypi version](](
[![Spack Package](](
[![Conda Package](](

Choose *one* of the install methods below to get started:

### PyPI

# optional: append --user
pip install openPMD-validator==

### Spack

spack install py-openpmd-validator@ ^py-h5py~mpi
spack load --dependencies py-openpmd-validator@ ^py-h5py~mpi

### Conda

conda install -c ax3l openpmd_validator==

### From Source

tar -xf
cd openPMD-validator-

# optional: append --user
python install

## Usage

### CLI

We provide the command-line tools for individual files:

# optional: create dummy example files

# validate
openPMD_check_h5 -i example.h5
# optional: append --EDPIC for the Partice-in-Cell Extension

### Module

Additionally, the validator tools can be used as *Python module* in your projects, e.g. to verify a file before opening it for reading.

from openpmd_validator import createExamples_h5

# create "example.h5"

from openpmd_validator import check_h5

result_array = check_h5.check_file("example.h5", verbose=False)

print("Result: %d Errors and %d Warnings."
%( result_array[0], result_array[1]))

## Development

The development of these scripts is carried out *per-branch*.
Each branch corresponds to a certain version of the standard and might
be updated in case tests did contain bugs or we found a way to cover more
sections of the standard.

Release History

This version
History Node

History Node

History Node

Download Files

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

Filename, Size & Hash SHA256 Hash Help File Type Python Version Upload Date
(18.5 kB) Copy SHA256 Hash SHA256
Wheel py2 Feb 6, 2018
(18.5 kB) Copy SHA256 Hash SHA256
Wheel py3 Feb 6, 2018
(14.8 kB) Copy SHA256 Hash SHA256
Source None Feb 6, 2018

Supported By

Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Google Google Cloud Servers