Search the Site Index:





RPMD

Updated on 27 Aug 2026

Forthcoming.

NBeads=N

Specify N beads for PIMD/RPMD. The default is 1, which means the classical nuclei.

NTraj=N

Run N trajectories. The default is 1.

MaxPoints=N

Each trajectory runs for N points/steps. The default is 100. This specifies the maximum number of steps for each trajectory, but you can also stop a trajectory using Geom=ReadAllGIC by specifying stop criteria based on geometric information (within the maximum number of steps).

StepSize=N

Set time step size to N *0.00001 fs. The default is 2500 (0.25 fs). For MTS and REAP methods, it is the time for ab initio step, i.e., the larger time step.

Seed=N

Set the seed number to N for the random number generator. The default seed is 398465.

Thermo

Apply a thermostat to all internal modes, including the centroid mode of the ring polymer. It is the default when any thermostat is applied.

TRPMD

Only apply a thermostat to all ring-polymer internal modes, but not to the centroid mode. It is useful to avoid the resonance between physical vibrational modes and the ring internal modes [Rossi14].

PILEM

Use the path integral Langevin equation (PILE) thermostat with “middle” scheme. This is the default thermostat for Thermo option [Leimkuhler13, Leimkuhler13a, Liu16].

PILE

Use path integral Langevin equation (PILE) thermostat [Ceriotti10].

NHC

Use Nose-Hoover chain thermostat [Martyna92]. By default, the number of chains is three and the “global” version is applied (equivalent to GNHC). LNHC invokes the “local” version of NHC thermostat [Ceriotti10]. NoseHooverChain is a synonym for this option

InitialCondition=type

Specify the initial condition for coordinates and momenta. The type can be one of the following options:

  • RandVel: The initial velocities are randomly generated, and the initial coordinates are read from the molecule specification part. All trajectories have the same initial coordinates. This is the default.
  • ReadInput: Read Cartesian coordinates, momenta or velocities from the input stream after the molecular specification section. Note that the momenta/velocities must have the same symmetry orientation as the coordinates. The input unit of coordinates is the same as that in the molecular specification section. Momenta and velocities are in atomic units. In the case of multiple beads, each bead coordinates and/or momenta (velocities) should be given. If coordinates are not given in this section, all beads share the same coordinates given in the molecular specification section.
  • ThermVel: The initial velocities are generated according to Boltzmann’s distribution at the given temperature. The initial coordinates are read from the molecule specification. All trajectories have the same initial coordinates.
  • CHO: Classical harmonic oscillator approximation. This option requires providing the total energy followed by its unit after molecule specification. The unit can be in kcal/mol (kcalpermol), cm−1 (cm), or eV (ev); for example, TotalEnergy=1.0kcalpermol. Using this option, the program will calculate the harmonic frequencies using the input geometry and assume the input geometry is already optimized. The option Opt=ReadFC or Opt=RCFC should be used to read the Hessian from the checkpoint file.
  • Orthant: Orthant sampling. It requires the total energy to be provided after molecule specification.
  • QHO: Quantum harmonic oscillator approximation. It assumes all vibrational modes are in the vibrational ground state by default. If one or more vibration modes need to be excited to higher states, you can specify, for example, v2=1 v3=1 after molecule specification to use quantum number 1 for ν2 and ν3 states.
  • ReadChk: Read coordinates and momenta from one or more equilibrium trajectories saved in a checkpoint file. By default, the code reads the coordinates and momenta every 50 points starting from the 1000th step of trajectory number 1. You can also input these data by using keywords in the additional input section after the molecular specification. For example, StartPoint=100 StartTraj=2 SamplingInterval=2 says to read the coordinates and momenta every 2 points starting from step 100 of trajectory number 2.
  • Restart: Restart a previously interrupted job or restart a normally finished job but with a larger number of steps (i.e., increase MaxPoints to a larger N ). Requires the checkpoint file from a previous job.

SaveDipole

Save dipole moments at each step. Default is not to save dipole moments for BOMD, PIMD and RPMD. Ehrenfest (in electronic-state basis) and RT-TDSCF always save the dipole moments. In Ehrenfest and RT-TDSCF, dipole moments calculated at each electronic step are all saved, which means the total number of dipole moments are NFock*NMicro*MaxPoints, where NMicro=1 for RT-TDSCF case.

SaveCharges

Save all calculated charges by population analysis at each step. The default is not to save charges.

NCheckPointSteps=N

Save the trajectory data to a checkpoint file at every N steps. The default is 100.

SaveGradients

Save the gradients of all beads for each step of the trajectory. The default is not to save gradients.

NCheckCoord=N

Check the GICs defined by the Geom=ReadAllGIC keyword at every N steps to see if the defined stop criteria are met. The default is 100.

NSaveDensity=N

Save the AO density matrices every N steps to the checkpoint file. Note that the density matrices between these steps are discarded.

ThermoIntegration

Request the thermodynamics integration for free energy calculations [Tuckerman10]. TI is a synonym for this option. To use this option, the user has to provide the Freeze coordinates in the GICS input section. Since a complete set of GICs is not required for the constraints, and the computation of derivatives of the B matrix is costly for a large number of internal coordinates, it would be computationally efficient to only generate the interested GICs. For example, Geom=(ReadAllGIC) says to read all GICs from user input instead of generating any default GICs and then specify the Freeze/Frozen coordinates after the geometry specification section. Note that trajectory calculations don’t output the free energies, but save all quantities that are required for thermodynamics integration free energy calculations. The user needs a post-processing script to obtain the free energies.

ADMP

Use the atomic-centered density matrix propagation for the electronic degree of freedom for extended Lagrangian dynamics [Schlegel01, Iyengar01, Schlegel02].

TRXL

Use the time-reversible extended Lagrangian in extended Lagrangian dynamics [Niklasson06, Niklasson07, Niklasson09].

NMicroiterations=N

Specify N microiteration steps to propagate the density matrix for each nuclei step in the ADMP. Each microiteration time step is StepSize/N and only involves the energy (not gradient) calculation. The default is 0, which means there is no microiteration step.

OnlyInitialCondition

Specify only generate initial conditions for the given number of trajectories and do not run the propagation. Initial conditions include coordinates, momenta, and electron densities if they are required for the given dynamics method. OnlyIC is a synonym for this option.

GenDen

This option is used together with the OnlyInitialCondition option. It requests the generation and saving of the initial electron densities to be used later. For example, a job using this option generates and saves SCF densities for all beads, and a second job reads these densities and alters orbitals to mimic electronic excitation, then a third job uses the densities from the altered orbitals in the second job to start Ehrenfest dynamics.

ReadDen

This option is often used together with the OnlyInitialCondition and GenDen option. In the example shown in GenDen option, this option is used in the second job to read the saved electron densities to start dynamics.

VelocityVerlet

Use the Velocity Verlet method for integration, which is the default for PIMD and RPMD. VV is a synonym for this option.

MTS

Use the multiple-time scale method for integration [Zheng24]. The integration on the interpolated surface using the Velocity Verlet method with microstep size is used for fine integration. MTSVV is a synonym for this option.

MTSBS

Use the multiple-time scale method for integration [Zheng24]. The Bulirsch-Stoer method is used for more accurate integration on an interpolated surface. BS is a synonym for this option. This method is the default for the non-adiabatic dynamics.

MicroStepSize=N

Specify the time step size as N/10000 fs for the fine integration using the velocity Verlet method in MTS. The default step size is 0.0025 fs.

AdiabaticSwitch

Request adiabatic switching from harmonic potential to the real potential within the given time (SwitchTime). The input structure is assumed to be optimized since the harmonic frequency calculation is based on the input structure.

Ehrenfest

Use the Ehrenfest method for non-adiabatic dynamics propagating density matrix in the electronic-state basis. MeanField and MF are synonym for this option. Note: Do not confuse this option with the keyword Ehrenfest which propagates the electron densities in atomic-orbital basis using RT-TDHF or RT-TDDFT.

SurfaceHopping

Tully’s fewest switch surface hopping method for non-adiabatic dynamics. SH is a synonym for this option.

CSDM

Coherent switching with decay of mixing method for non-adiabatic dynamics [Zhu04].

InitialState=N

Specify the initial population state of the system for non-adiabatic dynamics. For example, InitialState=2 means the initial population is on the first excited state. InitialSurface is a synonym for this option.

NState=N

Specify the total number of states involved in non-adiabatic dynamics. Currently, only 2 states are supported because the nonadiabatic coupling is only calculated between the electronic ground state and the interested excited state from the TD, TDA or CAS methods. NSurfaces is a synonym for this option.

Forthcoming.

SideMenu

SideMenu