Type object
File match kimmdy.yml kimmdy.yaml
Schema URL https://catalog.lintel.tools/schemas/schemastore/kimmdy-config-file/latest.json
Source https://raw.githubusercontent.com/graeter-group/kimmdy/main/src/kimmdy/kimmdy-yaml-schema.json

Validate with Lintel

npx @lintel/lintel check
Type: object

Properties

changer object required

Settings for applying a reaction recipe

2 nested properties
coordinates object required

Settings related to coordinate/geometry changes when applying a recipe

3 nested properties
md string

MD step from the 'mds' section that is used for relaxation MDs

slow_growth_pairs

This is deprecated. Specify in config.changer.coordinates.slow_growth instead.

slow_growth string

Whether the chosen MD step is a slow growth/free-energy simulation to relax after applying a reaction recipe. true and yes are equivalent to full for backwards compatibility. morse_only disables using pairs to transition non-bonded interactions as well and only uses morse bonds to emulate simple non-bonded interactions. The empty string means no slow growth.

Default: ""
Values: "yes" "true" "full" "morse_only" ""
topology object required

Settings for parameter changes in the topology file

3 nested properties
break_plumed boolean

Whether to remove bonds from the plumed.dat input file when applying a reaction recipe that breaks a bond. Unless needed for performance optimization, this can be left at false, because the homolysis plugin in kimmdy-reactions also cheeckts to not break non-existing bonds by default (which can be turned off).

Default: false
parameterization string

Parameterization scheme that is used on the topology file after changes to it

Default: "basic"
Values: "grappa" "basic"
parameterization_kwargs object

Keyword argument container for the selected parameterization scheme

sequence string | object[] required

List of tasks. Each task can be a string (the name of the task) or an object with the task name and a multiplicity mult: <int>

slurm object

SLURM HPC options

7 nested properties
N integer

Number of nodes

Default: 1
ntasks_per_node integer

n tasks per node

Default: 20
mincpus integer

mincpus

Default: 20
cpus_per_task integer

cpus per task

Default: 1
gpus integer

n gpus

Default: 1
runcmd string

Command to (re)submit the jobscript. Default is sbatch. For local testing replace with an empty string do run the jobscript directly.

Default: "sbatch"
partition string

HPC partition

Default: "<your-partition>"
dryrun boolean

Don't run the actual simulations, just print the tasks

Default: false
just_sample boolean

Don't execute the recipes returned by the chosen reaction, just get the rates (and choose one). KIMMDY will exit after reactions have been queried for the first time in the sequence.

Default: false
parameterize_at_setup boolean

parameterize the topology during the setup task

Default: true
cwd string

Working directory. Default is current working directory

name string

Used for output folder if out is not specified

Default: "kimmdy"
out string

Output folder

log object

Settings for logging

2 nested properties
file string

Logfile name (will result in a path relative to out)

Default: "kimmdy.log"
level string

Loglevel

Default: "INFO"
Values: "DEBUG" "INFO" "WARNING" "ERROR" "CRITICAL"
max_tasks integer

Maximum number of tasks to run. This is useful when a task in the sequence can dymanically add more tasks. 0 means no limit.

Default: 0
max_hours integer

Stop KIMMDY after max_hours hours. Set this lower than the limit of your HPC cluster for use with a re-submit jobscript. 0 Means no limit.

Default: 0
kmc string

KMC algorithm overwrite. Should be set by the reactions, but can be changed here. Not all reactions may support all algorithms.

Default: ""
Values: "" "rfkmc" "frm" "extrande" "extrande_mod" "multi_rfkmc" "dummy_first"
multi_kmc integer

Number of reactions to be executed in one step by a multi variant of a KMC algorithm.

Default: 1
tau_scale number

Scaling parameter for tau in the extrande kmc algorithm.

Default: "1.0"
top string

Topology file

Default: "topol.top"
topology object

Settings for handling the topology file.

1 nested properties
reactive object

Specify what moleculetypes will be part of the Reactive moleculetype. By default, solvent and ions are excluded.

3 nested properties
include string

Explicitly include a moleculetype or list of moleculetypes as a space-separated string.

Default: ""
exclude string

Explicitly exclude a moleculetype or a list as a space-separated string. For example the lipid moleculetype in a bilayer simulation e.g. DPPC POPC'

Default: ""
nrexcl integer

Explictly set the nrexcl value for the Reactive moleculetype. By default the value is taken from the first found reactive moleculetype.

gro string

Coordinate file

Default: "conf.gro"
ndx string

Gromaxs index file

Default: "index.ndx"
edissoc string

File with additional dissociation energy terms. This is used for the homolysis and hydrolysis reactions.

Default: "edissoc.dat"
grompp_prefix string

Prefix command for grompp execution on non MPI compiled clusters, e.g., 'srun --ntasks=1'.

Default: ""
gromacs_alias string

Gromacs alias. e.g. gmx or mpirun gmx_mpi

Default: "gmx"
mdrun_prefix string

Prefix command for mdrun execution on non MPI compiled clusters, e.g., 'srun --ntasks=1'.

Default: ""
gmx_mdrun_flags string

Flags passed to gmx mdrun. Default -maxh 24 -dlb yes

Default: "-maxh 24 -dlb yes"
ff string

Force field directory (looks for .ff in cwd if not set)

Default: "*.ff"
residuetypes string

GROMACS rtp file that contains residuetypes. Looks for aminoacids.rtp it not set. KIMMDY will first look in the current working directory and then relative to the forecfield directory.

radicals string

space-separated string of radical atom ids, can be empty

plumed string

.dat file containing plumed config

tpr string

.tpr file of a finished simulation for starting directly with a reaction

trr string

.trr file of a finished simulation for starting directly with a reaction

xtc string

.xtc file of a finished simulation for starting directly with a reaction

mdp string

.mdp file of a finished simulation for starting directly with a reaction

edr

This is deprecated and no longer required.

restart boolean

Restart or continue from a previous run (in config.out) instead of starting from scratch

Default: false
mds object

Settings for MD steps, e.g. mdp files, plumed files, etc.

reactions object

Settings for reactions

6 nested properties
save_recipes boolean

Save recipes as csv during the reactions step

Default: true