---
id: pymatgen-io-validation
version: "0.1.3"
license: BSD-3-Clause-LBNL
license_treatment: permissive
maintenance: active
---

# pymatgen-io-validation — A comprehensive I/O validator for electronic structure calculations

License: permissive · Maintenance: active · Downloads: 669.9K/mo

## What it is and what it does

pymatgen-io-validation is an extension to pymatgen that enforces Materials Project (MP) compliance rules for VASP density-functional theory calculations. It reads raw VASP calculation files from a directory and checks whether the input parameters and calculation setup match MP standards—ensuring that external calculations can be meaningfully compared to and potentially integrated with the MP database.

The package validates dozens of VASP parameters (ENCUT, EDIFF, ISMEAR, KPOINTS, functional choice, and many others) against both absolute requirements and relative thresholds defined by the relevant MP input set. It also detects known bugs that arise from specific parameter combinations (e.g., setting both GGA and METAGGA simultaneously). For each validation run, you get a boolean pass/fail result, a list of specific reasons for failure, and warnings about potential issues that don't block acceptance but merit attention.

Use it for:

- Check whether a VASP calculation from an external group meets MP standards before attempting to ingest its data into the MP database.
- Audit a batch of legacy VASP calculations to identify which ones are compatible with MP and which need re-running with corrected parameters.
- Catch common VASP configuration mistakes (e.g., wrong functional, insufficient k-point density) early in a high-throughput workflow.
- Verify that a calculation respects MP's strict rules on auxiliary parameters (ADDGRID, LASPH, LCALCEPS, etc.) that affect reproducibility.
- Generate validation reports documenting why a calculation failed or what warnings apply, for documentation or troubleshooting.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Validates VASP electronic structure calculation inputs and outputs against Materials Project standards, checking for parameter compliance, known bugs, and calculation discrepancies.

Yes. The package is actively maintained, has no security vulnerabilities, low install friction, and solves a real problem for anyone running VASP calculations that need to be MP-compatible. If you work with VASP and the Materials Project, or need to validate calculation compliance against a strict standard, this is a direct fit. If you run VASP but don't care about MP compatibility, it's not necessary.

## Install

pip install pymatgen-io-validation
uv add pymatgen-io-validation
poetry add pymatgen-io-validation

## Installing pymatgen-io-validation

Before you install: Low friction install with a small, stable dependency tree (pymatgen-core, numpy, requests, pydantic, pydantic-settings). Active maintenance: latest release 9 days old, last commit 2026-08-14, no known vulnerabilities.

License in practice: BSD-3-Clause-LBNL is a permissive license; you can use, modify, and distribute this package freely with minimal restrictions, provided you retain the license notice.

Quickstart:

from pymatgen.io.validation import VaspValidator
validation_doc = VaspValidator.from_directory('/path/to/vasp/calc')
print(validation_doc.valid, validation_doc.reasons, validation_doc.warnings)

Requires Python >=3.11 and a valid VASP calculation directory with standard output files.

Verify before relying:

- Whether the package validates all VASP output file types or only a subset (OUTCAR, vasprun.xml, etc.)
- Performance characteristics when validating large batches of calculations
- Whether validation rules are versioned or tied to specific Materials Project database releases

## Package facts

- License: BSD-3-Clause-LBNL (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 669.9K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

vasp calculation validation, dft input parameter checking, materials project compliance, vasp output verification, calculation quality assurance, dft workflow validation, vasp parameter compliance, vasp-validation, materials-science, dft-workflow

[View on SkillFed](https://skillfed.io/packages/pymatgen-io-validation) · [View on PyPI](https://pypi.org/project/pymatgen-io-validation/)