Skip to content
Skills Library
Science & research · Analysis

atomistic-workflows

/atomistic-workflows

Sets up and reports atomistic calculations so they are reproducible and converged, covering ASE Atoms, calculators, optimizers and MD drivers, pymatgen structures, symmetry analysis and the Materials Project API, LAMMPS and GROMACS input basics for molecular dynamics, convergence tests for k-points, plane-wave cutoffs and timesteps, the unit system each code uses, energy-minimization stopping criteria, and archiving of exact input files. Use for DFT, classical or machine-learned potential simulations of molecules, crystals, surfaces and liquids; use molecular-dynamics for biomolecular trajecto

Repository
openscience ↗
Licence
Apache-2.0
Last repository change
25.10.2026

Assessment and security

90/ 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.
Content25 / 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
1
Scripts
0
HTML comments
0
URLs in SKILL.md
8
Deprecation

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

Licence

Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.

What it does and when to use it

Sets up and reports atomistic calculations so they are reproducible and converged, covering ASE Atoms, calculators, optimizers and MD drivers, pymatgen structures, symmetry analysis and the Materials Project API, LAMMPS and GROMACS input basics for molecular dynamics, convergence tests for k-points, plane-wave cutoffs and timesteps, the unit system each code uses, energy-minimization stopping criteria, and archiving of exact input files. Use for DFT, classical or machine-learned potential simulations of molecules, crystals, surfaces and liquids; use molecular-dynamics for biomolecular trajecto

Original author description

Sets up and reports atomistic calculations so they are reproducible and converged, covering ASE Atoms, calculators, optimizers and MD drivers, pymatgen structures, symmetry analysis and the Materials Project API, LAMMPS and GROMACS input basics for molecular dynamics, convergence tests for k-points, plane-wave cutoffs and timesteps, the unit system each code uses, energy-minimization stopping criteria, and archiving of exact input files. Use for DFT, classical or machine-learned potential simulations of molecules, crystals, surfaces and liquids; use molecular-dynamics for biomolecular trajecto

How it works

  1. ASE
  2. pymatgen
  3. Convergence
  4. LAMMPS and GROMACS
  5. Units per code
  6. Reproducible inputs
  7. Sources
Original SKILL.md headings · 109 lines, 905 words
SKILL.md preview
---
name: atomistic-workflows
description: Sets up and reports atomistic calculations so they are reproducible and converged, covering ASE Atoms, calculators, optimizers and MD drivers, pymatgen structures, symmetry analysis and the Materials Project API, LAMMPS and GROMACS input basics for molecular dynamics, convergence tests for k-points, plane-wave cutoffs and timesteps, the unit system each code uses, energy-minimization stopping criteria, and archiving of exact input files. Use for DFT, classical or machine-learned potential simulations of molecules, crystals, surfaces and liquids; use molecular-dynamics for biomolecular trajectory analysis and pymatgen for detailed library usage.
summary: "ASE, pymatgen, LAMMPS and GROMACS setup with convergence tests and units per code."
category: chemistry
allowed-tools: [Read, Write, Bash, python]
license: MIT
version: 1.0.0
author: Synthetic Sciences
metadata:
  skill-author: Synthetic Sciences
---

# Atomistic workflows

An atomistic number is defined only together with its code, units, convergence parameters
and stopping criteria; a "DFT energy" without k-mesh and cutoff cannot be reproduced.

## ASE

1. `Atoms(symbols, positions, cell, pbc)`; `ase.io.read` and `write` convert between
   formats (`read("traj.xyz", index=":")` for all frames). Internal units are eV and
   angstrom; `ase.units` supplies `fs`, `kB`, `Hartree` and `Bohr` for conversion (the
   native time unit is about 10.18 fs, so always multiply by `units.fs`). Attach a
   calculator with `atoms.calc = ...` (`EMT`, `ase.calculators.vasp.Vasp`,
   `espresso.Espresso`, `lammpslib.LAMMPSlib`, a machine-learned potential), then
   `get_potential_energy()`, `get_forces()`, `get_stress()` (eV per cubic angstrom).
2. Relaxation: `from ase.optimize import BFGS, LBFGS, FIRE`, then
   `opt = BFGS(atoms, trajectory="opt.traj", logfile="opt.log")` and
   `opt.run(fmax=0.01, steps=500)`. `fmax` is the largest force on any atom in eV per
   angstrom: 0.05 is loose, 0.01 standard, 0.001 for phonons. Relax the cell with
   `FrechetCellFilter` from `ase.filters` wrapped around the atoms; fix atoms with
   `FixAtoms`. Check that `opt.run` returned converged rather than exhausting `steps`.
3. MD: `MaxwellBoltzmannDistribution(atoms, temperature_K=300)` and `Stationary(atoms)`,
   then `Langevin(atoms, 1.0 * units.fs, temperature_K=300, friction=0.01 / units.fs)`
   or `NVTBerendsen`, `NPT`; `dyn.run(steps)` with a trajectory attached; record the seed.

## pymatgen

4. `Structure.from_file("POSCAR")` or a CIF; `structure.to(filename="out.cif")`.
   Symmetry via `SpacegroupAnalyzer(structure, symprec=0.01, angle_tolerance=5)` with
   `get_space_group_symbol()` and `get_conventional_standard_structure()`; `symprec`
   changes the answer (0.01 angstrom strict, 0.1 loose), so report it.
   `Kpoints.automatic_density(structure, kppa=1000)` sets k-mesh density per reciprocal
   atom. `Vasprun("vasprun.xml")` exposes `final_energy`, `converged_electronic` and
   `converged_ionic`; read both flags. `AseAtomsAdaptor` bridges to ASE.
5. Materials Project: `from mp_api.client import MPRester`, then
   `mpr.materials.summary.search(formula="Fe2O3", fields=[...])` with fields such as
   `material_id`, `structure`, `energy_above_hull` and `band_gap`. Database energies
   carry their own functional and correction scheme; never mix them with raw energies
   from your own runs without applying the same corrections. Record the database release
   and the `material_id`.

## Convergence

6. Plane-wave DFT: converge the quantity you report (total energy per atom, an energy
   difference, forces, stress) against cutoff (VASP `ENCUT` in eV, at least 1.3 x
   `ENMAX` for stress and cell relaxation; Quantum ESPRESSO `ecutwfc` in Ry with
   `ecutrho` 4 to 12 times larger) and against k-mesh (Monkhorst-Pack or Gamma-centred,
   density stated), to a criterion such as 1 meV per atom. Metals need smearing
   (`ISMEAR`, `SIGMA`; `occupations="smearing"`, `degauss`) and denser meshes. Record
   pseudopotential or PAW set and version, functional, DFT+U values, dispersion
   correction, spin initialization, electronic (`EDIFF`, `conv_thr`) and ionic (`EDIFFG`,
   `forc_conv_thr`) thresholds. Slabs need at least 10 to 15 angstrom of vacuum and a
   dipole correction; defects need a supercell-size test.
7. MD: timestep at most 1 fs with explicit hydrogens, 2 fs with bond constraints,
   0.5 fs for high temperatures or very light atoms; validate by energy drift in NVE.
   Equilibrate NVT then NPT before production; check the observable against run length
   (block averaging or autocorrelation) and against system size.

## LAMMPS and GROMACS

8. LAMMPS: the `units` command (`metal`, `real`, `lj`, `si`) fixes every other unit in the
   input, so state it first. Skeleton: `atom_style`, `boundary p p p`, `read_data`,
   `pair_style` and `pair_coeff`, `timestep 0.001` (in the chosen time unit),
   `velocity all create 300 4928459 dist gaussian` (the seed is part of the record),
   `fix 1 all nvt temp 300 300 0.1`, `thermo_style custom step temp pe etotal press vol`,
   `dump`, `run`. `minimize 1e-8 1e-10 10000 100000` gives energy tolerance, force
   tolerance, max iterations and max force evaluations; report which criterion stopped
   it. `write_restart` and `read_restart` continue a run; `log.lammps` is the evidence.
9. GROMACS (nm, ps, kJ/mol, bar): `gmx pdb2gmx -ff amber99sb-ildn -water tip3p`,
   `gmx editconf -c -d 1.0 -bt dodecahedron`, `gmx solvate`, `gmx grompp`,
   `gmx genion -neutral -conc 0.15`. Minimization `.mdp`: `integrator = steep`,
   `emtol = 1000.0` (kJ mol^-1 nm^-1). Production: `integrator = md`, `dt = 0.002`,
   `constraints = h-bonds`, `cutoff-scheme = Verlet`, `coulombtype = PME`,
   `rcoulomb = 1.0`, `rvdw = 1.0`, `tcoupl = V-rescale`, `tau_t = 0.1`, `ref_t = 300`,
   `pcoupl = C-rescale`, `ref_p = 1.0`, `compressibility = 4.5e-5`. Restart with
   `gmx mdrun -cpi state.cpt`; analyze with `gmx energy`, `gmx rms`, `gmx trjconv`.

## Units per code

| Code | Length | Energy | Time | Force |
| --- | --- | --- | --- | --- |
| ASE | angstrom | eV | angstrom sqrt(amu/eV), about 10.18 fs | eV/angstrom |
| VASP | angstrom | eV | fs (`POTIM`) | eV/angstrom |
| Quantum ESPRESSO | Bohr or angstrom (per card flag) | Ry (`ecutwfc`, `conv_thr`) | Rydberg atomic units, 4.8378e-17 s | Ry/Bohr |
| LAMMPS `metal` | angstrom | eV | ps | eV/angstrom |
| LAMMPS `real` | angstrom | kcal/mol | fs | kcal/mol/angstrom |
| GROMACS, OpenMM | nm | kJ/mol | ps | kJ/mol/nm |

## Reproducible inputs

- Archive the exact inputs (`INCAR`, `KPOINTS`, `POSCAR`, `POTCAR` titles and hashes;
  `in.lammps` and data files; every `.mdp` and `topol.top`), seeds, a `run.sh`, code
  versions (`lmp -h`, `gmx --version`, `ase.__version__`) and the raw outputs the
  numbers came from (`OUTCAR`, `vasprun.xml`, `log.lammps`, `.edr`).
- After any format conversion, check that atom counts, cell and composition survived.
- State functional, pseudopotentials, cutoffs, k-mesh, smearing, thresholds, force field,
  water model, timestep, ensemble, T and P, run length and equilibration discarded.

## Sources

- ASE documentation (units, optimizers, molecular dynamics): https://ase-lib.org/
- pymatgen documentation: https://pymatgen.org/
- Materials Project API documentation: https://docs.materialsproject.org/
- LAMMPS manual (`units`, `minimize`, `fix nvt`): https://docs.lammps.org/
- GROMACS reference manual and `.mdp` options: https://manual.gromacs.org/current/
- VASP wiki (`ENCUT`, `KPOINTS`, `EDIFFG`): https://www.vasp.at/wiki/
- Quantum ESPRESSO `pw.x` input description: https://www.quantum-espresso.org/Doc/INPUT_PW.html
- Lejaeghere et al. (2016), Reproducibility in density functional theory calculations of solids, Science 351, aad3000: https://doi.org/10.1126/science.aad3000

Versions

The database has no other skills named atomistic-workflows.

Database snapshot: 13.11.2026 · package version 2e5850eac19a (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

  • 100ase
    Use when manipulating atomistic structures, converting between file formats (CIF, POSCAR, XYZ, LAMMPS data), building supercells and surfaces, or running small geometry optimizations with ASE-supported calculators.
  • 100nvalchemi-toolkit
    Build and change NVIDIA ALCHEMI Toolkit (nvalchemi) workflows for atomistic simulation and machine-learned interatomic potentials (MLIPs). Use for batched structure relaxation, molecular dynamics, reaction paths, training or fine-tuning an MLIP, atomistic datasets in Zarr,…
  • 100gromacs
    Use when working on biomolecular molecular dynamics with GROMACS, including system setup, equilibration, production runs, trajectory analysis, or MM/PBSA-style post-processing.
  • 100gromacs
    Use when working on biomolecular molecular dynamics with GROMACS, especially system setup, equilibration, production runs, trajectory analysis, or MM/PBSA-style post-processing.
  • 90ase-workflows
    Route ASE atomistic workflow requests to task-specific subskills based on user intent. Use when the user asks for ASE-based static, relaxation, MD, or NEB workflows and you must apply consistent workflow controls independent of calculator backend.
  • 100pymatgen
    Comprehensive guidance for using pymatgen (Python Materials Genomics) for computational materials science. Covers structure creation and manipulation, file I/O (CIF, POSCAR, XYZ), symmetry analysis, Materials Project API integration, phase diagrams, electronic structure…

Feedback and reports

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