ensemble (PIMD)
The ensemble keyword is used to set up an integration method (an integrator).
The pimd and pimd_scr integrators incorporate nuclear quantum effects in equilibrium properties using path integral molecular dynamics (PIMD).
The rpmd and trpmd integrators provide approximate real-time quantum dynamics [Craig2004] [Rossi2014].
Syntax
ensemble pimd <num_beads> <T_1> <T_2> <T_coup> [<pressure_control_parameters>] [eco <omega_max>]
ensemble pimd_scr <num_beads> <T_1> <T_2> <T_coup> <pressure_control_parameters> [eco <omega_max>]
ensemble rpmd <num_beads>
ensemble trpmd <num_beads>
Parameters
num_beads is the number of beads in the ring polymer. It must be even and between 2 and 128.
T_1 and T_2 are the initial and final target temperatures in K and must be positive.
The target changes linearly during the run; use equal values for a constant temperature.
T_coup is the thermostat relaxation time in time steps and must be at least 1.
pimd applies a Langevin thermostat to both the internal and centroid modes [Ceriotti2010].
Without pressure parameters, the simulation cell is fixed.
Adding pressure parameters enables a Berendsen barostat.
pimd_scr requires pressure parameters and uses stochastic cell rescaling instead.
Both accept the same three pressure-control parameter forms as the standard NPT integrators: isotropic, independent box lengths, and triclinic.
Pressures and elastic moduli are in GPa; p_coup is in time steps.
rpmd evolves the ring polymer without a thermostat.
trpmd applies a Langevin thermostat only to the internal modes, leaving the centroid mode unthermostatted.
Appending eco <omega_max> to pimd or pimd_scr selects economised path-integral internal-mode frequencies [Zeng2026].
omega_max is a positive maximum physical vibrational wavenumber in cm-1.
The dimensionless fitting range is \(x_{\max}=hc\omega_{\max}/(k_{\rm B}T)\) and follows the target temperature during a ramp.
Without eco, GPUMD uses the original Trotter internal-mode frequencies.
rpmd and trpmd always use the original Trotter frequencies.
Output
None.
Examples
Run PIMD with 32 beads at a fixed target temperature of 300 K:
ensemble pimd 32 300 300 100
Use isotropic stochastic cell rescaling at 0 GPa, with an estimated modulus of 100 GPa:
ensemble pimd_scr 32 300 300 100 0 100 1000
Enable Eco frequencies at fixed cell with a maximum wavenumber of 4000 cm-1:
ensemble pimd 32 300 300 100 eco 4000
Notes
Initialize the ring polymer with a pimd or pimd_scr run before using rpmd or trpmd.
The number of beads cannot change between runs.