Geinium
Home

Geinium documentation

Molecular dynamics of protein-ligand complexes on a Windows PC: from a docked complex to a simulated, analysed and reported system in one application.

Geinium takes a protein with a docked ligand and returns a simulated, analysed and reported system. It repairs the structure, protonates protein and ligand at the chosen pH, assigns GAFF2 atom types and AM1-BCC charges to the ligand, builds the AMBER ff14SB topology, places the complex in a box of water or in a lipid bilayer with ions, minimises, equilibrates, runs one or more production replicas, analyses the trajectories, computes protein-ligand interactions and an MM-GBSA binding energy, and writes a results package with a PDF report, every figure as an image file and the numbers behind every figure as raw data. No other program takes part at any stage, and nothing has to be installed beside it.

The Results page of a finished 100 ns job (Tricin-7-O-glucoside_4daj) on a 1920 x 1080 screen. Look at the navigation on the left, which lists every analysis in the order of the report, and at the Simulation card, which records the protocol actually used: ensemble, thermostat and barostat, 310 K, 2 fs, PME, the force fields and the number of frames analysed. The Membrane row states that this receptor was simulated in water on purpose; the row is there so that such a choice can never pass unnoticed.
The Results page of a finished 100 ns job (Tricin-7-O-glucoside_4daj) on a 1920 x 1080 screen. Look at the navigation on the left, which lists every analysis in the order of the report, and at the Simulation card, which records the protocol actually used: ensemble, thermostat and barostat, 310 K, 2 fs, PME, the force fields and the number of frames analysed. The Membrane row states that this receptor was simulated in water on purpose; the row is there so that such a choice can never pass unnoticed.

What it does

AreaWhat you get
PreparationRepair of missing atoms and alternate conformers, modelling of short missing loops from the sequence, caps at chain breaks, detection of fusion inserts, metal sites and modified residues, and protonation of protein and ligand at a chosen pH. See Structure preparation.
Ligand parametersGAFF2 atom types and AM1-BCC charges computed by Geinium itself, with warnings where a parameter had to be taken by analogy. See Ligand parameters.
SystemsA periodic water box (TIP3P, 0.15 mol/L NaCl by default) or, for a membrane protein, a Lipid21 bilayer of POPC and cholesterol with a staged equilibration. See Box, solvent, ions and membranes.
SimulationA GPU engine and a CPU reference engine, chosen automatically. 2 fs with standard hydrogen masses by default; 4 fs with hydrogen-mass repartitioning, multiple time stepping and several replicas are options. Every stage resumes after an interruption. See The simulation protocol.
AnalysesRMSD, RMSF, secondary structure, radius of gyration, surfaces, hydrogen bonds and run quality, each with a statistics table. See Trajectory analyses.
InteractionsHydrogen bonds, water bridges, salt bridges, stacking, halogen bonds, metal coordination and hydrophobic contacts with their occupancy, and a two-dimensional interaction diagram. See Protein-ligand interactions.
MM-GBSAA single-trajectory GB-OBC2 binding energy with its components and a block-averaged standard error, for ranking ligands. See Binding free energy (MM-GBSA).
PCA and landscapePrincipal components of the C-alpha motion and a free-energy landscape over the first two. See PCA and free-energy landscape.
Results packageOne folder with report.pdf, images at 300 or 600 dpi plus SVG and PDF, raw data as CSV and a manifest with a checksum of every file. Several jobs give one combined report. See Exporting results.
ViewerA molecular viewer with trajectory playback, presets for publication pictures, the binding site and membranes, and image and movie-frame export. See The 3-D viewer and playback.

Where to start

Installing and starting
What the package contains, what a PC needs, and how the GPU is found.
A tour of the window
Menus, tool bar, the page bar and the panels.
The Run MD page
One complex, from file to results, with the live monitor.
The Batch queue
Many complexes with shared settings, resumable after a restart.
The Results page
Every figure and table of a finished job.
Exporting results
The PDF report, images and raw data.
The command line
The same engine and pipeline from scripts.

Two programs, one engine

The installation contains two programs. Geinium.exe is the desktop application with the pages Home, Run MD, Batch, Results, Viewer, Analysis, Builder, Simulate and Settings. mdsim.exe is the command-line program, with about forty commands for preparation, simulation, analysis and reporting; mdsim help lists them and mdsim <command> -h lists the options of one. Both use the same engine, the same data library and the same file layout.

Every job started from Run MD or the Batch queue writes a project file, project.json, into its job folder. Running mdsim pipeline -config project.json on that file reproduces the job without the window, and a job run from a script can be opened on the Results page like any other. The file is described in Project file keys.

A note on units. The engine works in nanometres, picoseconds, kJ/mol, kelvin and bar, and every file it writes uses these units. The Results page and the export convert only for display and publication: lengths in nm or angstrom and energies in kcal/mol or kJ/mol, one of each per export, chosen in the header of the Results page or in the export dialog.

Limits worth knowing first