File formats
Every file Geinium reads and writes.
Geinium reads and writes the common text and binary formats of biomolecular simulation, so its files can be opened by other programs and files from elsewhere can be analysed with it. Files it writes in these formats follow the format conventions exactly. Its own files (the run input, project files, result bundles and results packages) are documented below.
Files that are read
| Extension | Content | Where it can be opened |
|---|---|---|
.pdb, .ent | Protein or complex (all models are read) | Run MD, Batch, System Builder; 3D viewer; Analysis page; mdsim tools |
.cif, .mmcif | Protein or complex in mmCIF; converted to PDB records first, keeping author numbering, insertion codes, alternate locations, sequence records and links. Chain identifiers longer than 2 characters, residue numbers outside -999 to 9999 and names longer than 4 characters are refused, because PDB records cannot hold them. | Run MD, Batch, System Builder |
.pdbqt | Docking output: a complex (only the first model is used, with a warning) or a ligand with several poses (choose one) | Run MD, Batch, System Builder; "Ligand file" |
.sdf, .sd, .mol, .mol2 | A docked ligand in its own file, in 3D and in the coordinate frame of the receptor. SDF or MOL with bond orders is the safest choice. | "Ligand file" of Run MD and Batch, "Ligand" of the System Builder, mdsim ligparam |
.gro | Coordinates with box (and velocities) | 3D viewer, Analysis page, mdsim tools |
.pqr | Structure with charges and radii | 3D viewer |
.xtc | Compressed trajectory (positions) | 3D viewer, Analysis page, mdsim analysis tools |
.trr | Full-precision trajectory (positions, velocities, forces) | The same; also the exact continuation of a stage |
.edr | Energy file | Analysis page ("Energy file"), mdsim energy |
.xvg | Plot data: columns of numbers with labels | Analysis page, mdsim plot, mdsim xvgdiff; per-residue colouring in the viewer |
.ndx | Index groups | Analysis page, mdsim tools |
.top, .itp | Topology: molecules, atoms, bonds, parameters | 3D viewer (bonds and molecules), Analysis page, System Builder ("Existing topology (.itp)" for a ligand) |
.mdp | Run parameters | mdsim grompp |
.mdtpr | Geinium's run input: parameters, topology and coordinates in one file | Simulate page, mdsim mdrun, mdsim bench, analysis tools |
.log | Run log of an MD stage | Run-log monitor (Simulation > Monitor a run log), Simulate page |
project*.json | Project file of a job | Run MD, Batch, Simulate page, mdsim pipeline |
protocol*.json | Protocol written by the System Builder | Simulate page |
.gnm | Result bundle | Results page |
.fasta | Protein sequence for gap modelling | "Protein sequence" of Run MD, structure.sequence_fasta |
.png, .jpg, .svg | Logo for the report | Export dialog ("Image file"), mdsim export -logo |
What File > Open does
File > Open (Ctrl+O) and drag and drop onto the window decide by the type of what is opened. Several files dropped at once are handled together; structures are opened before trajectories.
| Item | Opens |
|---|---|
| A folder | A job folder opens on the Results page; any other folder becomes the project folder. |
.gnm | The Results page. |
.gro, .pdb, .ent, .pqr | The 3D viewer. |
.xtc, .trr | The 3D viewer, as the trajectory of the open structure; without one: "Open the structure first." |
.xvg | The Analysis page. |
project*.json | The Results page if the job has results, otherwise the Simulate page. |
protocol*.json, .mdtpr | The Simulate page. |
.top | The 3D viewer, with the topology applied to the open structure. |
.log | The run-log monitor. |
.csv, .png, .svg, .pdf, .txt, .md | The program Windows associates with the type. |
| Anything else | "<name>: unsupported file type". |
Files that are written
The job folder
A job writes its stages into numbered folders (01_structure to
09_results), each with the standard files of that step: repaired structure and ligand,
ligand parameters, topology, solvated system and index groups, run parameters, and for every MD stage
the run input, log, energy file, compressed trajectory, final structure, final state and checkpoint.
The layout is described in Project file keys. Next to the stage folders:
pipeline.log (time-stamped events), project.resolved.json (the project with
every default spelled out) and report.json.
The results package
<name>_results\ with report.pdf, images\ (PNG, SVG and
PDF of every figure), raw-data\ (CSV tables and JSON information blocks) and
manifest.json (schema geinium-export/1: every file with its size and SHA-256
checksum, the units and the settings). The export log is written next to it as
09_results\export.log. See Exporting results.
The result bundle (.gnm)
A result bundle is one file that reopens a finished job on any PC, written with File >
Save result bundle (.gnm) or mdsim pack. It is a ZIP archive, so any ZIP tool
can list it. It holds the project file, the job inputs and the work folder of the job without
checkpoints and raw trajectories, plus one trajectory per replica corrected for periodic boundaries
and thinned to about 500 frames (the frames themselves are copied unchanged). Its first entry
identifies it as a Geinium bundle, and its last, manifest.json (schema
geinium-results/1), records the size and SHA-256 checksum of every entry. Opening a bundle
verifies every checksum; Tools > Check a result bundle (.gnm) does the same on
request and answers "The bundle is intact: every file matches its CRC-32 and its SHA-256 checksum."
or "The bundle is DAMAGED:" with the files concerned. A thinned bundle is analysed over its stored
frames. Bundles of earlier versions that contain a Word report still open.
Other files
| File | Written by | Content |
|---|---|---|
project.json in a job folder | Run MD and Batch, at every start | The project that reproduces the job with mdsim pipeline. |
batch_queue.json | The Batch page | The queue (schema mdsim-gui-queue/1), written before each job starts. |
Geinium.ini | The application | The settings. |
| PNG, JPG or BMP | File > Save viewer image | An image of the 3D view. |
| Numbered PNG files | File > Export movie frames | Frames for a film. |
| PNG, SVG or PDF | "Save image" on the Results page, "Save plot" on the Analysis page, mdsim plot | One figure. |
| CSV | "Save data" on the Results page | The numbers of the shown figure in the chosen units. |
Units inside files
| Files | Units | Notes |
|---|---|---|
| Engine and analysis files: .gro, .xtc, .trr, .edr, .xvg, .top, .itp, .mdp | nm, ps, kJ/mol, K, bar, elementary charge, atomic mass unit | The standard units of molecular dynamics. |
| .pdb | Å | The convention of the PDB format. |
| MM-GBSA results in the job folder | kcal/mol, Å | The conventions of the method. |
| Results package | The chosen length unit (nm or Å) and energy unit (kcal/mol or kJ/mol); time in ns | One length and one energy unit for the whole package; the unit is part of every CSV column name. |
Text files are UTF-8 and use line feeds as line ends. Every .xvg file names, in a comment line, the tool that wrote it.