For molecular modelers working with simulations, customizing your tools to suit your computational needs is essential. When using the GROMACS Wizard in SAMSON, the default GROMACS setup is often sufficient. However, there are cases when you might want to run simulations using a locally installed version of GROMACS. Whether it’s for ensuring reproducibility or leveraging system-specific optimizations, the flexibility to choose your own GROMACS installation can make a significant difference. Let’s dive into how you can configure the GROMACS Wizard for your custom setup.
Why Use a Custom GROMACS Version?
By default, GROMACS Wizard is packaged with one of the latest versions of GROMACS. For many users, this default version works well for everyday tasks. However, some specific needs require flexibility:
- System-Specific Performance: Use the GROMACS package installed on your system and leverage any optimizations tailored to your hardware.
- Reproducibility: Select an exact GROMACS version and force-field directory to ensure consistent results across experiments.
If these scenarios sound familiar, it’s time to explore the customization options within GROMACS Wizard.
How to Configure the GROMACS Wizard
The process is simple. Start by clicking the Settings button at the top of the GROMACS Wizard interface. This will open a dialog where you can fine-tune your simulation setup.

To use a custom GROMACS installation, enable the Use a different GROMACS version option. You will need to specify two key paths:
- Path to GROMACS Executable: Select the executable file (
gmx.exeon Windows orgmxon Linux/macOS). The version of the GROMACS executable will be displayed for verification purposes. If the executable is invalid, you will see an error message. - Path to Force-Field Directory: Locate the directory containing force-field files (e.g.,
$HOME/gromacs/share/top/on Linux and macOS). This ensures compatibility with your selected GROMACS version.

Gaining Control Over Performance Parameters
Customizing your GROMACS installation also gives you more control over local performance parameters. These settings allow you to adjust parallelization, thread placement, domain decomposition, and PME algorithms. For instance:
- Set the number of threads with a non-zero value to keep your machine responsive.
- Leverage options like
ntmpi,ntomp, andpmeto fine-tune resource usage based on your hardware.
For advanced tips on performance tuning, refer to the GROMACS Manual – Getting good performance from mdrun.
Things to Keep in Mind
Before starting, ensure that you:
- Open the GROMACS Wizard so that the Settings button is accessible.
- Decide which GROMACS version and force-field directory you want to use if reproducibility is critical.
It is worth noting that these customizations apply only to local computations. Cloud-based jobs will not utilize these settings.
Ready to Get Started?
Configuring the GROMACS Wizard for custom setups can save you time and improve performance on your local machine. While the default package suits most users, specific research goals or hardware requirements might make this feature indispensable. To learn more about these configuration options and other advanced settings, visit the original documentation page at https://documentation.samson-connect.net/tutorials/gromacs-wizard/settings/.
Note: SAMSON and all SAMSON Extensions are free for non-commercial use. You can get SAMSON at https://www.samson-connect.net.
