When it comes to molecular dynamics simulations, one size rarely fits all. Whether you’re optimizing a protocol, reproducing a published study, or trying to match specific experimental conditions, modifying your simulation parameters is often essential. But editing .mdp files by hand can be a tedious process, especially for newcomers or those managing multiple simulations.
The GROMACS Wizard in SAMSON offers a streamlined experience for managing .mdp parameters directly through its graphical interface. In this post, we’ll explore how you can load, customize, and export .mdp files using this tool, all while reducing errors and saving time ⏱️.
The typical challenge
Many researchers dread the repetitive task of editing raw .mdp files. Miss a semicolon? Use a wrong keyword? You might break a simulation run. And copying parameters from one step to another—say, from NVT Equilibration to NPT Equilibration—carries the risk of inconsistencies that are hard to debug.
This is where the GROMACS Wizard comes in. It lets you visually edit simulation parameters grouped by categories, making it easier to understand what each parameter does and how it affects your simulation.
Getting started
Each simulation step—such as energy minimization, NVT/NPT equilibration, or production MD—has its own tab in the wizard, with default parameters preloaded. Click the All… button to open a full list of parameters for that step:

This will bring up a categorized window of advanced settings that mirrors the structure of the official GROMACS parameter documentation.
Tooltips make exploration safer
Not sure what a parameter does? Hover over its name to see a tooltip with additional information—helpful when you’re adjusting unfamiliar settings. It’s a small touch that makes a big difference when fine-tuning your runs.
Adding or overriding parameters
Some parameters may not appear in the advanced settings window. That’s where the Additional Parameters section comes in. You can paste any valid .mdp entry here, and it will override the corresponding setting elsewhere.
This is especially useful when using custom parameters from another project, or when experimenting with new algorithms or coupling schemes not shown in the interface:
|
1 2 3 |
tcoupl = Nose-Hoover pcoupl = Parrinello-Rahman |
Import and export with ease
Already have an .mdp file? Just click Load from file… to import its contents for the selected step. SAMSON will update matching parameters automatically and add new ones to the “Additional Parameters” section. Copy-pasting also works seamlessly.
To save your settings for reuse or sharing with colleagues, hit Save as…. You can also preview everything as plain text using the View as text button.

Quick actions for efficient modeling
- OK: Apply changes
- Cancel: Discard modifications (except resets)
- Reset: Restore defaults
All changes are saved when you close SAMSON, so your settings are preserved for future sessions.
Final thoughts
Managing .mdp files doesn’t have to be burdensome. With visual editing, tooltips, and fast import/export options, the GROMACS Wizard in SAMSON simplifies parameter customization while still giving you full control.
🧪 To learn more about managing custom parameters in SAMSON, visit the official documentation page: https://documentation.samson-connect.net/tutorials/gromacs-wizard/applying-custom-parameters/
SAMSON and all SAMSON Extensions are free for non-commercial use. You can download SAMSON at https://www.samson-connect.net.
