Skip to content
Skills Library
Science & research · Conversion & formats

dpdata-cli

/dpdata-cli

A command-line utility for converting and manipulating over 50 atomic simulation data formats, including outputs from DFT and MD software (VASP, LAMMPS, Gaussian, QE, CP2K, ABACUS, etc.). USE WHEN you need to convert structural or trajectory files between different computational chemistry formats, or when parsing raw simulation outputs into structured training datasets (e.g., deepmd/raw, deepmd/npy, deepmd/hdf5) for DeePMD-kit.

Licence
LGPL
Last repository change
25.10.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
2
Scripts
0
HTML comments
0
URLs in SKILL.md
6
Deprecation

No signals detected. Repository changed on 25.10.2026, without references to retired models or APIs.

Licence

LGPL, otwarta.

What it does and when to use it

A command-line utility for converting and manipulating over 50 atomic simulation data formats, including outputs from DFT and MD software (VASP, LAMMPS, Gaussian, QE, CP2K, ABACUS, etc.). USE WHEN you need to convert structural or trajectory files between different computational chemistry formats, or when parsing raw simulation outputs into structured training datasets (e.g., deepmd/raw, deepmd/npy, deepmd/hdf5) for DeePMD-kit.

Original author description

A command-line utility for converting and manipulating over 50 atomic simulation data formats, including outputs from DFT and MD software (VASP, LAMMPS, Gaussian, QE, CP2K, ABACUS, etc.). USE WHEN you need to convert structural or trajectory files between different computational chemistry formats, or when parsing raw simulation outputs into structured training datasets (e.g., deepmd/raw, deepmd/npy, deepmd/hdf5) for DeePMD-kit.

How it works

  1. Quick Start
  2. Command Line Usage
  3. Common Examples
  4. Supported Formats
  5. Tips
  6. References
Original SKILL.md headings · 180 lines, 816 words
SKILL.md preview
---
name: dpdata-cli
description: >
  A command-line utility for converting and manipulating over 50 atomic simulation data formats, including outputs from DFT and MD software (VASP, LAMMPS, Gaussian, QE, CP2K, ABACUS, etc.).
  USE WHEN you need to convert structural or trajectory files between different computational chemistry formats, or when parsing raw simulation outputs into structured training datasets (e.g., deepmd/raw, deepmd/npy, deepmd/hdf5) for DeePMD-kit.
compatibility: Requires uvx (uv) for running dpdata
metadata:
  author: njzjz-bot
  version: '1.0'
  repository: https://github.com/deepmodeling/dpdata
---

# dpdata CLI

dpdata is a tool for manipulating multiple atomic simulation data formats. This skill enables format conversion between various DFT/MD software outputs via command line.

## Quick Start

Run dpdata via uvx:

```bash
uvx dpdata <from_file> [options]
```

## Command Line Usage

```text
dpdata: Manipulating multiple atomic simulation data formats
usage: dpdata [-h] [--to_file TO_FILE] [--from_format FROM_FORMAT]
              [--to_format TO_FORMAT] [--no-labeled] [--multi]
              [--type-map TYPE_MAP [TYPE_MAP ...]] [--version]
              from_file
```

### Arguments

| Argument              | Description                                           |
| --------------------- | ----------------------------------------------------- |
| `from_file`           | Read data from a file (positional)                    |
| `--to_file`, `-O`     | Dump data to a file                                   |
| `--from_format`, `-i` | Format of from_file (default: "auto")                 |
| `--to_format`, `-o`   | Format of to_file                                     |
| `--no-labeled`, `-n`  | Labels aren't provided (default: False)               |
| `--multi`, `-m`       | System contains multiple directories (default: False) |
| `--type-map`, `-t`    | Type map for atom types                               |
| `--version`           | Show dpdata version and exit                          |

## Common Examples

### Convert VASP OUTCAR to deepmd format

```bash
uvx dpdata OUTCAR -i vasp/outcar -O deepmd_data -o deepmd/raw
```

### Convert LAMMPS dump to VASP POSCAR

```bash
uvx dpdata dump.lammps -i lammps/dump -O POSCAR -o vasp/poscar
```

### Convert with type map

```bash
uvx dpdata OUTCAR -i vasp/outcar -O deepmd_data -o deepmd/raw -t C H O N
```

### Convert multiple systems

```bash
uvx dpdata data_dir -i vasp/outcar -O output_dir -o deepmd/comp --multi
```

### Convert to deepmd/npy (compressed format)

```bash
uvx dpdata OUTCAR -i vasp/outcar -O deepmd_npy -o deepmd/npy
```

### Convert to deepmd/hdf5

```bash
uvx dpdata OUTCAR -i vasp/outcar -O data.h5 -o deepmd/hdf5
```

## Supported Formats

Formats may be updated. For the complete and latest list, see:

- [Formats Reference (stable)](https://docs.deepmodeling.com/projects/dpdata/en/stable/formats.html)

### DeePMD-kit Formats

| Format Name                  | Description                        |
| ---------------------------- | ---------------------------------- |
| `deepmd/raw`                 | DeePMD-kit raw text format         |
| `deepmd/comp` / `deepmd/npy` | DeePMD-kit compressed numpy format |
| `deepmd/npy/mixed`           | DeePMD-kit mixed type format       |
| `deepmd/hdf5`                | DeePMD-kit HDF5 format             |

### VASP Formats

| Format Name                                           | Description          |
| ----------------------------------------------------- | -------------------- |
| `vasp/poscar` / `vasp/contcar` / `poscar` / `contcar` | VASP structure files |
| `vasp/outcar` / `outcar`                              | VASP OUTCAR output   |
| `vasp/xml` / `xml`                                    | VASP XML output      |
| `vasp/string`                                         | VASP string format   |

### LAMMPS Formats

| Format Name            | Description      |
| ---------------------- | ---------------- |
| `lammps/lmp` / `lmp`   | LAMMPS data file |
| `lammps/dump` / `dump` | LAMMPS dump file |

### ABACUS Formats

| Format Name                                              | Description           |
| -------------------------------------------------------- | --------------------- |
| `stru` / `abacus/stru`                                   | ABACUS structure file |
| `abacus/lcao/scf` / `abacus/pw/scf` / `abacus/scf`       | ABACUS SCF output     |
| `abacus/lcao/md` / `abacus/pw/md` / `abacus/md`          | ABACUS MD output      |
| `abacus/lcao/relax` / `abacus/pw/relax` / `abacus/relax` | ABACUS relax output   |

### Quantum ESPRESSO Formats

| Format Name  | Description      |
| ------------ | ---------------- |
| `qe/cp/traj` | QE CP trajectory |
| `qe/pw/scf`  | QE PWscf output  |

### CP2K Formats

| Format Name        | Description      |
| ------------------ | ---------------- |
| `cp2k/output`      | CP2K output      |
| `cp2k/aimd_output` | CP2K AIMD output |

### Gaussian Formats

| Format Name     | Description                   |
| --------------- | ----------------------------- |
| `gaussian/log`  | Gaussian log file             |
| `gaussian/fchk` | Gaussian formatted checkpoint |
| `gaussian/md`   | Gaussian MD output            |
| `gaussian/gjf`  | Gaussian input file           |

### Other Formats

| Format Name                                                         | Description           |
| ------------------------------------------------------------------- | --------------------- |
| `xyz`                                                               | XYZ format            |
| `mace/xyz` / `nequip/xyz` / `gpumd/xyz` / `extxyz` / `quip/gap/xyz` | Extended XYZ variants |
| `ase/structure`                                                     | ASE structure format  |
| `ase/traj`                                                          | ASE trajectory        |
| `pymatgen/structure`                                                | pymatgen structure    |
| `pymatgen/molecule`                                                 | pymatgen molecule     |
| `gromacs/gro` / `gro`                                               | GROMACS gro file      |
| `siesta/output`                                                     | SIESTA output         |
| `siesta/aimd_output`                                                | SIESTA AIMD output    |
| `pwmat/output` / `pwmat/mlmd` / `pwmat/movement`                    | PWmat output          |
| `pwmat/final.config` / `pwmat/atom.config`                          | PWmat config          |
| `orca/spout`                                                        | ORCA output           |
| `psi4/out`                                                          | PSI4 output           |
| `dftbplus`                                                          | DFTB+ output          |
| `fhi_aims/output` / `fhi_aims/md`                                   | FHI-aims output       |
| `amber/md`                                                          | AMBER MD              |
| `n2p2`                                                              | n2p2 format           |
| `mol_file` / `mol`                                                  | MOL file              |
| `sdf_file` / `sdf`                                                  | SDF file              |
| `openmx/md`                                                         | OpenMX MD             |
| `sqm/out`                                                           | SQM output            |
| `sqm/in`                                                            | SQM input             |
| `list`                                                              | List format           |
| `3dmol`                                                             | 3Dmol visualization   |

## Tips

1. **Auto-detection**: Use `-i auto` (default) to let dpdata detect format automatically
1. **Type mapping**: Use `-t` to specify atom type order for deepmd formats
1. **Multi-system**: Use `--multi` for directories containing multiple systems
1. **Compressed output**: Use `deepmd/npy` or `deepmd/hdf5` for smaller file sizes

## References

- [dpdata Documentation](https://docs.deepmodeling.com/projects/dpdata/)
- [CLI Reference](https://docs.deepmodeling.com/projects/dpdata/en/stable/cli.html)
- [Formats Reference](https://docs.deepmodeling.com/projects/dpdata/en/stable/formats.html)
- [GitHub Repository](https://github.com/deepmodeling/dpdata)
Files in this package (2)
  • README.md 2 KB
  • SKILL.md 8 KB

Versions

RepositoryScoreLicence
This page · jinzhezenggroup/computational-chemistry-agent-skills100LGPL
jinzhezenggroup/computational-chemistry-agent-skills100LGPL

Database snapshot: 13.11.2026 · package version 36c061388362 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100lammps-deepmd
    A tool and knowledge base for running molecular dynamics (MD) simulations in LAMMPS with the DeePMD-kit plugin. It handles input script preparation, ensemble selection (NVE/NVT/NPT), and execution with a verified DeePMD-enabled runtime. USE WHEN you need to set up, write,…
  • 100dpdata-driver
    Use dpdata Python Driver plugins to label systems (energies/forces/virials) via System.predict(), list available drivers, and build Driver objects (ase/deepmd/gaussian/sqm/hybrid). Use when working with dpdata Python API (not CLI) and you need driver-based energy/force…
  • 100deepmd-finetune-dpa4
    Fine-tune a DPA4 model in DeePMD-kit. Use for standard or LoRA fine-tuning from a DPA4/SeZM .pt checkpoint, validation and .pt2 export.
  • 100deepmd-train
    Train DeePMD-kit models with progressive disclosure. Use when the user wants to train a DeePMD-kit potential, prepare an input.json, choose between model families such as se_e2_a/DeepPot-SE, DPA3, DPA4/SeZM, and DPA4C, run `dp train`, monitor learning curves, freeze checkpoints,…
  • 100nist-potential-search
    根据模型文件(LAMMPS 输入/data、POSCAR、CIF、extxyz)或显式元素列表,检索 NIST Interatomic Potentials Repository 中匹配体系的势函数条目,展示候选(引用/DOI/pair_style/pair_coeff/参数文件直链),经用户确认后下载参数文件并生成 sha256 清单;可选 OpenKIM 交叉检索。当用户要求"找势函数/势文件/defining pair_style 该用什么文件/查 NIST 势"或 input_build 流程中需要为 LAMMPS…
  • 85TB2J
    Guide for using TB2J command-line tools to calculate magnetic interaction parameters (J, DMI, etc.) from DFT outputs (Wannier90, Siesta, Abacus). Use this skill when the user asks about running TB2J commands, their parameters, inputs, or outputs.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.