Geinium
Home › File formats

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

ExtensionContentWhere it can be opened
.pdb, .entProtein or complex (all models are read)Run MD, Batch, System Builder; 3D viewer; Analysis page; mdsim tools
.cif, .mmcifProtein 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
.pdbqtDocking 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, .mol2A 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
.groCoordinates with box (and velocities)3D viewer, Analysis page, mdsim tools
.pqrStructure with charges and radii3D viewer
.xtcCompressed trajectory (positions)3D viewer, Analysis page, mdsim analysis tools
.trrFull-precision trajectory (positions, velocities, forces)The same; also the exact continuation of a stage
.edrEnergy fileAnalysis page ("Energy file"), mdsim energy
.xvgPlot data: columns of numbers with labelsAnalysis page, mdsim plot, mdsim xvgdiff; per-residue colouring in the viewer
.ndxIndex groupsAnalysis page, mdsim tools
.top, .itpTopology: molecules, atoms, bonds, parameters3D viewer (bonds and molecules), Analysis page, System Builder ("Existing topology (.itp)" for a ligand)
.mdpRun parametersmdsim grompp
.mdtprGeinium's run input: parameters, topology and coordinates in one fileSimulate page, mdsim mdrun, mdsim bench, analysis tools
.logRun log of an MD stageRun-log monitor (Simulation > Monitor a run log), Simulate page
project*.jsonProject file of a jobRun MD, Batch, Simulate page, mdsim pipeline
protocol*.jsonProtocol written by the System BuilderSimulate page
.gnmResult bundleResults page
.fastaProtein sequence for gap modelling"Protein sequence" of Run MD, structure.sequence_fasta
.png, .jpg, .svgLogo for the reportExport 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.

ItemOpens
A folderA job folder opens on the Results page; any other folder becomes the project folder.
.gnmThe Results page.
.gro, .pdb, .ent, .pqrThe 3D viewer.
.xtc, .trrThe 3D viewer, as the trajectory of the open structure; without one: "Open the structure first."
.xvgThe Analysis page.
project*.jsonThe Results page if the job has results, otherwise the Simulate page.
protocol*.json, .mdtprThe Simulate page.
.topThe 3D viewer, with the topology applied to the open structure.
.logThe run-log monitor.
.csv, .png, .svg, .pdf, .txt, .mdThe 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

FileWritten byContent
project.json in a job folderRun MD and Batch, at every startThe project that reproduces the job with mdsim pipeline.
batch_queue.jsonThe Batch pageThe queue (schema mdsim-gui-queue/1), written before each job starts.
Geinium.iniThe applicationThe settings.
PNG, JPG or BMPFile > Save viewer imageAn image of the 3D view.
Numbered PNG filesFile > Export movie framesFrames for a film.
PNG, SVG or PDF"Save image" on the Results page, "Save plot" on the Analysis page, mdsim plotOne figure.
CSV"Save data" on the Results pageThe numbers of the shown figure in the chosen units.

Units inside files

FilesUnitsNotes
Engine and analysis files: .gro, .xtc, .trr, .edr, .xvg, .top, .itp, .mdpnm, ps, kJ/mol, K, bar, elementary charge, atomic mass unitThe standard units of molecular dynamics.
.pdbÅThe convention of the PDB format.
MM-GBSA results in the job folderkcal/mol, ÅThe conventions of the method.
Results packageThe chosen length unit (nm or Å) and energy unit (kcal/mol or kJ/mol); time in nsOne 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.