Metadata-Version: 2.4
Name: dpdata
Version: 1.0.2
Summary: Manipulating data formats of DeePMD-kit, VASP, QE, PWmat, and LAMMPS, etc.
Author: DeepModeling
Author-email: Han Wang <wang_han@iapcm.ac.cn>
License-Expression: LGPL-3.0-or-later
Project-URL: Homepage, https://github.com/deepmodeling/dpdata
Project-URL: documentation, https://docs.deepmodeling.com/projects/dpdata
Project-URL: repository, https://github.com/deepmodeling/dpdata
Keywords: lammps,vasp,deepmd-kit
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: numpy>=1.14.3
Requires-Dist: monty
Requires-Dist: scipy
Requires-Dist: h5py
Requires-Dist: wcmatch
Requires-Dist: lmdb
Requires-Dist: msgpack-numpy
Provides-Extra: test
Provides-Extra: ase
Requires-Dist: ase; extra == "ase"
Provides-Extra: amber
Requires-Dist: parmed; extra == "amber"
Provides-Extra: pymatgen
Requires-Dist: pymatgen; extra == "pymatgen"
Provides-Extra: docs
Requires-Dist: sphinx; extra == "docs"
Requires-Dist: recommonmark; extra == "docs"
Requires-Dist: sphinx-book-theme; extra == "docs"
Requires-Dist: numpydoc; extra == "docs"
Requires-Dist: myst-parser; extra == "docs"
Requires-Dist: deepmodeling-sphinx>=0.3.0; extra == "docs"
Requires-Dist: sphinx-argparse<0.5.0; extra == "docs"
Requires-Dist: rdkit; extra == "docs"
Requires-Dist: jupyterlite-sphinx; extra == "docs"
Requires-Dist: jupyterlite-xeus; extra == "docs"
Provides-Extra: benchmark
Requires-Dist: pytest; extra == "benchmark"
Requires-Dist: pytest-codspeed; extra == "benchmark"
Dynamic: license-file

# dpdata

[![DOI:10.1021/acs.jcim.5c01767](https://img.shields.io/badge/DOI-10.1021%2Facs.jcim.5c01767-blue)](https://doi.org/10.1021/acs.jcim.5c01767)
[![conda-forge](https://img.shields.io/conda/dn/conda-forge/dpdata?color=red&label=conda-forge&logo=conda-forge)](https://anaconda.org/conda-forge/dpdata)
[![pip install](https://img.shields.io/pypi/dm/dpdata?label=pip%20install&logo=pypi)](https://pypi.org/project/dpdata)
[![Documentation Status](https://readthedocs.org/projects/dpdata/badge/)](https://dpdata.readthedocs.io/)

**dpdata** is a Python package for manipulating atomistic data of software in computational science.

## Credits

If you use this software, please cite the following paper:

- Jinzhe Zeng, Xingliang Peng, Yong-Bin Zhuang, Haidi Wang, Fengbo Yuan, Duo Zhang, Renxi Liu, Yingze Wang, Ping Tuo, Yuzhi Zhang, Yixiao Chen, Yifan Li, Cao Thang Nguyen, Jiameng Huang, Anyang Peng, Marián Rynik, Wei-Hong Xu, Zezhong Zhang, Xu-Yuan Zhou, Tao Chen, Jiahao Fan, Wanrun Jiang, Bowen Li, Denan Li, Haoxi Li, Wenshuo Liang, Ruihao Liao, Liping Liu, Chenxing Luo, Logan Ward, Kaiwei Wan, Junjie Wang, Pan Xiang, Chengqian Zhang, Jinchao Zhang, Rui Zhou, Jia-Xin Zhu, Linfeng Zhang, Han Wang, dpdata: A Scalable Python Toolkit for Atomistic Machine Learning Data Sets, *J. Chem. Inf. Model.*, 2025, DOI: [10.1021/acs.jcim.5c01767](https://doi.org/10.1021/acs.jcim.5c01767). [![Citations](https://citations.njzjz.win/10.1021/acs.jcim.5c01767)](https://badge.dimensions.ai/details/doi/10.1021/acs.jcim.5c01767)

## Installation

dpdata only supports Python 3.10 and above. You can [setup a conda/pip environment](https://docs.deepmodeling.com/faq/conda.html), and then use one of the following methods to install dpdata:

- Install via pip: `pip install dpdata`
- Install via conda: `conda install -c conda-forge dpdata`
- Install from source code: `git clone https://github.com/deepmodeling/dpdata && pip install ./dpdata`

To test if the installation is successful, you may execute

```bash
dpdata --version
```

## Supported packages

`dpdata` is aimmed to support different kinds of atomistic packages:

- Atomistic machine learning packages, such as [DeePMD-kit](https://github.com/deepmodeling/deepmd-kit);
- Molecular dynamics packages, such as [LAMMPS](https://github.com/lammps/lammps) and [GROMACS](https://gitlab.com/gromacs/gromacs);
- Quantum chemistry packages, such as [VASP](https://www.vasp.at/), [Gaussian](https://gaussian.com), and [ABACUS](https://github.com/deepmodeling/abacus-develop);
- Atomistic visualization packages, such as [3Dmol.js](https://3dmol.csb.pitt.edu/).
- Other atomistic tools, such as [ASE](https://gitlab.com/ase/ase).
- Common formats such as `xyz`.

All supported formats are listed [here](https://docs.deepmodeling.com/projects/dpdata/en/master/formats.html).

## Quick start

The quickest way to convert a simple file from one format to another one is to use the [command line](https://docs.deepmodeling.com/projects/dpdata/en/master/cli.html).

```sh
dpdata OUTCAR -i vasp/outcar -o deepmd/npy -O deepmd_data
```

For advanced usage with Python APIs, [read dpdata documentation](https://docs.deepmodeling.com/projects/dpdata/).

## Plugins

- [cp2kdata](https://github.com/robinzyb/cp2kdata) adds the latest CP2K support for dpdata.

For how to create your own plugin packages, [read dpdata documentation](https://docs.deepmodeling.com/projects/dpdata/).
