Geinium
Home › The System Builder page

The System Builder page

Building a system step by step with every option visible, for when the defaults of Run MD are not what you want.

When to use it instead of Run MD

Run MD takes a complex through the whole protocol with settings that suit most protein-ligand complexes, and shows only the choices that usually matter. The System Builder shows every choice of system construction and protocol, builds the system without simulating it, and lets you inspect it before anything runs. Use it when you need:

A finished build is simulated on the Simulate page; a saved project runs on Run MD, in the Batch queue or on the Simulate page.

The System Builder before a structure is chosen. Look at the four groups, Molecules,
The System Builder before a structure is chosen. Look at the four groups, Molecules, "Box, solvent and ions", Protocol and Files, and at the "Build" box at the bottom, which stays in view while the form scrolls. On a narrow window the groups stack in one column.

Molecules

ControlDefaultMeaning and when to change it
"Protein"emptyThe receptor or complex (.pdb, .ent, .cif, .mmcif, .pdbqt).
"Repair structure"onMissing atoms, alternate conformers, naming; atoms of the input are never moved. Switch it off only for a structure that is already complete and named for the force field. Taking the ligand from the protein file needs it.
"Keep input protonation"offTakes protonation states from the hydrogens of the input instead of the pH rules. Available with repair on. (Its tooltip mentions pH 7; the default pH is 7.4.)
"Protonation overrides"emptyExplicit states as chain:residue=state, for example A:508=GLH A:32=ASH. See Protonation at pH.
"Ligand"emptyA separate ligand file (.sdf, .mol, .mol2, .pdb, .pdbqt) or an .itp topology.
"Ligand from protein file"offTakes the ligand from the protein file, for a complex exported as one PDB. Use either this or "Ligand", not both.
"Ligand parameters""GAFF2 + AM1-BCC charges"Or "Existing topology (.itp)" for parameters made elsewhere; then "Ligand coordinates" (.gro or .pdb, in the frame of the receptor) is required.
"Ligand residue" and "Net charge"LIG, autoSee Ligand parameters.
"Preparation"pH 7.4, model short gapsThe same section as on Run MD: pH, ligand protonation, missing residues, sequence, molecules to remove. See Structure preparation.
"Force field"amber14sbThe force fields of the data library, each with a short description. GAFF2 ligands combine with AMBER force fields only; membranes need amber14sb.
"Water model"TIP3PThe water models of the chosen force field.
The Builder with m3_dicyclomine.pdb as the protein and
The Builder with m3_dicyclomine.pdb as the protein and "Ligand from protein file" ticked. Look at the Files group: "Ready to build" in green means the form is complete. The "Build system" button stays greyed here because no build folder has been chosen yet.

Box, solvent and ions

"Box type", "Solute-box distance", "Neutralise", "Salt concentration", "Ions", "Membrane" ("Lipid bilayer"), "Bilayer", "Lipid margin", "Orientation reference" and "Structural ions" are described in Box, solvent, ions and membranes. With "Lipid bilayer" ticked, the box controls, minimisation, equilibration, thermostat and barostat are greyed with the tooltip "Fixed by the membrane equilibration protocol".

Protocol

ControlDefault (range)Meaning and when to change it
"Minimisation"50000 steps, 1000 kJ/mol/nm (100 to 1,000,000 steps; 1 to 10000)Steepest descent stops at the step limit or when the largest force falls below the tolerance. A tighter tolerance is rarely needed before restrained equilibration.
"NVT equilibration"100 psRestrained equilibration at constant volume. Lengthen it for a large or strongly strained system.
"NPT equilibration"100 psRestrained equilibration at constant pressure, during which the density settles. Lengthen it if the density still drifts at its end.
"Production"100 ns (0.001 to 100000)Unrestrained simulation of every replica.
"Time step" with "Mass repartitioning"2.0 fs, off (0.5 to 4.0 fs)Above 2 fs the hydrogen masses must be repartitioned; raising the step ticks the box. See The simulation protocol.
"Temperature"300 KNote: Run MD and the pipeline default to 310 K. Ticking "Lipid bilayer" changes 300 K to 310 K.
"Pressure"1 barReference pressure of the barostat.
"Thermostat"V-rescaleOr Nose-Hoover, Berendsen. V-rescale gives the correct canonical ensemble and relaxes quickly; Berendsen does not sample the canonical ensemble and suits only equilibration.
"Barostat"C-rescaleOr Parrinello-Rahman, Berendsen. C-rescale samples the correct ensemble and is stable from the start; Parrinello-Rahman can oscillate in a system far from equilibrium.
"Replicas"3 (1 to 64)Independent production runs. Run MD defaults to 1.
"Velocity seeds"1001, 2001, 3001One seed per replica, comma separated; seeds must differ. "New seeds" draws a new set, for a second, independent set of replicas.

Files

The Files group shows "Ready to build" in green, or "To do: ..." with what is still missing, for example "a ligand alone cannot be built yet: give the receptor PDB", "choose either a ligand file or the ligand of the protein PDB, not both", "ligand residue name: 1-4 characters" or "time steps above 2 fs need hydrogen mass repartitioning".

ButtonWhat it doesWhen to use it
"Write run parameters"Writes the parameter files (.mdp) of this protocol into a folder you choose. Not available for membrane systems.To inspect or edit the run parameters, or to run them on the Simulate page with a run input made by hand.
"Save project"Writes a project file (project.json) for Run MD, the batch queue or the Simulate page.To run the same system later, on another PC, or many times in the queue.

Building

"Build folder" (default 01_build in the project folder of the Project panel) receives the system. "Build system" checks the form and, for a membrane protein without a membrane, asks the "Membrane protein" question first. If the folder already holds simulation output, Geinium asks before moving it aside. The "Before the start" dialog of Run MD is not asked here; set the missing-residue choice in the Preparation section instead.

The build runs through these steps, each shown as "Step i of n: <stage>" beside the progress bar: "Structure repair", "Protein topology", "Ligand parameters (GAFF2 + AM1-BCC)", "Complex assembly", "Periodic box", "Solvent", "Ions" (or "Membrane embedding, water and ions"), "Protocol and index groups" and "Run-input check". "Cancel" stops it after the current step.

The Builder during a build. Look at the line beside the progress bar, which names the step that is running (
The Builder during a build. Look at the line beside the progress bar, which names the step that is running ("Step i of n: ..."), and at the "Cancel" button, which is enabled only while a build runs.

When the build ends, the status reads "Built in X s" in green and a result line gives the counts, for example "N atoms, M lipids, W water molecules, a NA + b CL, ligand LIG; K warning(s), see the log", followed by the path of the system file. The system opens in the viewer and its protocol is loaded on the Simulate page, ready to start. A failed build reads "Build failed" in red with the reason below.

The Builder after a finished build. Look at
The Builder after a finished build. Look at "Built in ... s" in green and the result line under the progress bar: the atom count, water molecules, ions and ligand name, and the number of warnings to read in the log before simulating.