dpdata-driver
/dpdata-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 prediction, plugin registration keys, or examples of using dpdata with ASE calculators or DeePMD models.
- Author
- jinzhezenggroup ↗
- Repository
- computational-chemistry-agent-skills ↗
- Licence
- LGPL
- Last repository change
- 25.10.2026
Assessment and security
- Files in this package
- 1
- Scripts
- 0
- HTML comments
- 0
- URLs in SKILL.md
- 0
No signals detected. Repository changed on 25.10.2026, without references to retired models or APIs.
LGPL, otwarta.
What it does and when to use it
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 prediction, plugin registration keys, or examples of using dpdata with ASE calculators or DeePMD models.
Original author description
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 prediction, plugin registration keys, or examples of using dpdata with ASE calculators or DeePMD models.
How it works
- Key idea
- List supported driver keys (runtime)
- Minimal workflow
- Example: use the ASE driver with an ASE calculator (runnable)
- Example: pass a Driver object instead of a string
- Hybrid driver
- Notes / gotchas
SKILL.md preview
---
name: dpdata-driver
description: 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 prediction, plugin registration keys, or examples of using dpdata with ASE calculators or DeePMD models.
license: LGPL-3.0-or-later
compatibility: Requires dpdata or uv for running dpdata
metadata:
author: njzjz-bot
version: '1.0'
---
# dpdata-driver
Use dpdata “driver plugins” to **label** a `dpdata.System` (predict energies/forces/virials) and obtain a `dpdata.LabeledSystem`.
## Key idea
- A **Driver** converts an unlabeled `System` into a `LabeledSystem` by computing:
- `energies` (required)
- `forces` (optional but common)
- `virials` (optional)
In dpdata, this is exposed as:
- `System.predict(*args, driver="dp", **kwargs) -> LabeledSystem`
`driver` can be:
- a **string key** (plugin name), e.g. `"ase"`, `"dp"`, `"gaussian"`
- a **Driver object**, e.g. `Driver.get_driver("ase")(...)`
## List supported driver keys (runtime)
When unsure what drivers exist in *this* dpdata version/env, query them at runtime:
```python
import dpdata
from dpdata.driver import Driver
print(sorted(Driver.get_drivers().keys()))
```
`import dpdata` ensures built-in plugins are loaded before listing registered drivers.
In the current repo state, keys include:
- `ase`
- `dp` / `deepmd` / `deepmd-kit`
- `gaussian`
- `sqm`
- `hybrid`
(Exact set depends on dpdata version and installed extras.)
## Minimal workflow
```python
import dpdata
from dpdata.system import System
sys = System("input.xyz", fmt="xyz")
ls = sys.predict(driver="ase", calculator=...) # returns dpdata.LabeledSystem
```
### Verify you got a labeled system
```python
assert "energies" in ls.data
# optional:
# assert "forces" in ls.data
# assert "virials" in ls.data
```
## Example: use the ASE driver with an ASE calculator (runnable)
This is the easiest *fully runnable* example because it doesn’t require external QM software.
Dependencies (recommended): declare script dependencies with uv inline metadata, then run with `uv run`.
```python
# /// script
# requires-python = ">=3.8"
# dependencies = [
# "dpdata",
# "numpy",
# "ase",
# ]
# ///
```
Script:
```python
from pathlib import Path
import numpy as np
from ase.calculators.lj import LennardJones
from dpdata.system import System
# write a tiny molecule
Path("tmp.xyz").write_text("""2\n\nH 0 0 0\nH 0 0 0.74\n""")
sys = System("tmp.xyz", fmt="xyz")
ls = sys.predict(driver="ase", calculator=LennardJones())
print("energies", np.array(ls.data["energies"]))
print("forces shape", np.array(ls.data["forces"]).shape)
if "virials" in ls.data:
print("virials shape", np.array(ls.data["virials"]).shape)
else:
print("virials: <not provided by this driver/calculator>")
```
## Example: pass a Driver object instead of a string
```python
from ase.calculators.lj import LennardJones
from dpdata.driver import Driver
from dpdata.system import System
sys = System("tmp.xyz", fmt="xyz")
ase_driver = Driver.get_driver("ase")(calculator=LennardJones())
ls = sys.predict(driver=ase_driver)
```
## Hybrid driver
Use `driver="hybrid"` to sum energies/forces/virials from multiple drivers.
The `HybridDriver` accepts `drivers=[ ... ]` where each item is either:
- a `Driver` instance
- a dict like `{"type": "sqm", ...}` (type is the driver key)
Example (structure only; may require external executables):
```python
from dpdata.driver import Driver
hyb = Driver.get_driver("hybrid")(
drivers=[
{"type": "sqm", "qm_theory": "DFTB3"},
{"type": "dp", "dp": "frozen_model.pb"},
]
)
# ls = sys.predict(driver=hyb)
```
## Notes / gotchas
- Many drivers require extra dependencies or external programs:
- `dp` requires `deepmd-kit` + a model file
- `gaussian` requires Gaussian and a valid executable (default `g16`)
- `sqm` requires AmberTools `sqm`
- If you just need file format conversion, use the existing **dpdata CLI** skill instead.
Versions
The database has no other skills named dpdata-driver.
Database snapshot: 13.11.2026 · package version 92b13883c4cd (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
- 100dpdata-minimizer
Minimize geometries with dpdata minimizer plugins via System.minimize(), including how minimizers relate to drivers (ASEMinimizer needs a dpdata Driver) and how to list supported minimizers (ase/sqm). Use when doing geometry optimization/minimization through dpdata Python API. - 100dpdata-cli
Convert and manipulate atomic simulation data formats using dpdata CLI. Use when converting between DFT/MD output formats or preparing DeePMD-kit training data. Supports 50+ formats including deepmd, xyz or extxyz, ABACUS, VASP, LAMMPS, CP2K, etc. - 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,… - 95ase-basics
ASE (Atomic Simulation Environment) の基礎操作を扱うスキルです。 Atoms オブジェクトの生成・編集、ase.build.molecule, ase.build.bulk, repeat, supercell, PBC (periodic boundary conditions), cell, positions, get_chemical_formula, get_distance, translate, center, 分子と結晶の違い、構造ファイルの読み書き(ase.io.read/write) に関するコード生成時に使用してください。