Geinium
Home › The 3-D viewer and playback

The 3-D viewer and playback

Looking at the structure and the trajectory: representations, presets, periodic boundaries, measurements, images and movie frames.

The viewer draws structures and trajectories with the program's own renderer. It opens a finished job with its trajectory in one step, plays the run at any speed, follows the binding site frame by frame, measures distances and angles, and writes images and movie frames for publication. Every figure of a results package says what happened; the viewer shows it, and it is the place to check any feature of a figure that you cannot explain.

The Viewer page before anything is opened. The tool bar at the top opens a structure, a trajectory, a job folder or a topology; the panels on the right hold the system information, the presets and the representation of each class of molecule.
The Viewer page before anything is opened. The tool bar at the top opens a structure, a trajectory, a job folder or a topology; the panels on the right hold the system information, the presets and the representation of each class of molecule.

Opening something to look at

ButtonOpensNotes
StructureA .gro, .pdb, .ent or .pqr file.The starting point for anything that is not a job.
TrajectoryAn .xtc or .trr trajectory (also a multi-model .gro or .pdb).The structure must be open first, with the same number of atoms; a matching structure and topology next to the trajectory are found automatically.
Job folderSystem, topology and production trajectory of a job or run folder, and the bond orders of the ligand.The quickest route for a finished job; with several trajectories you choose one.
TopologyBonds, masses and molecules from a .top file.Exact bonds instead of bonds guessed from distances.

From the Results page, Show in viewer does the same as Job folder for the open job and its first replica. The Viewer page itself is F3.

A finished job in the viewer at frame 501 of 1001 (50 ns). The System panel names the file, the atom, residue and molecule counts, the source of the bonds and the secondary structure of the shown frame; under it, the trajectory with its frame count and time span. The player under the view holds the frame slider, the frame number, the time, the speed, the step and the loop mode.
A finished job in the viewer at frame 501 of 1001 (50 ns). The System panel names the file, the atom, residue and molecule counts, the source of the bonds and the secondary structure of the shown frame; under it, the trajectory with its frame count and time span. The player under the view holds the frame slider, the frame number, the time, the speed, the step and the loop mode.

Moving around

ActionMouse or key
RotateDrag with the left button; arrow keys
Roll about the viewing axisShift and drag with the left button
Move (pan)Drag with the right or middle button, or Ctrl and drag
ZoomMouse wheel; + and −
Centre on an atomDouble-click the atom
Fit the view to the visible atomsFit or F
Reset orientation and fitReset or R
Orthographic or perspectiveO
Pick an atomClick it (what a click does is set under Labels and measurements)

Presets

A preset sets the representation, colours, display options and camera for a common purpose in one click. It is applied once; everything it sets can be changed afterwards. The animations below are real trajectory frames drawn by the viewer.

Trajectory playback with the Default preset: the complex in its water box (100 ns run). Cartoon coloured by chain, the ligand as ball and stick, ions as spheres, water as thin lines and the periodic box drawn; the camera stays fixed while the protein moves.
Trajectory playback with the Default preset: the complex in its water box (100 ns run). Cartoon coloured by chain, the ligand as ball and stick, ions as spheres, water as thin lines and the periodic box drawn; the camera stays fixed while the protein moves.
Publication preset: cartoon and ligand with outlines and ambient occlusion, orthographic view. Water, ions and the box are hidden and the camera looks along the smallest extent of the protein, which here shows the receptor and its insert side by side.
Publication preset: cartoon and ligand with outlines and ambient occlusion, orthographic view. Water, ions and the box are hidden and the camera looks along the smallest extent of the protein, which here shows the receptor and its insert side by side.
Binding site preset: pocket residues, labels and hydrogen bonds follow the ligand frame by frame. Residues with a heavy atom within 0.5 nm of the ligand are sticks with labels, hydrogen bonds are dashed lines labelled with their donor-acceptor distance in nm, and the cartoon is pale and translucent.
Binding site preset: pocket residues, labels and hydrogen bonds follow the ligand frame by frame. Residues with a heavy atom within 0.5 nm of the ligand are sticks with labels, hydrogen bonds are dashed lines labelled with their donor-acceptor distance in nm, and the cartoon is pale and translucent.
Membrane preset: bilayer side view with phosphorus atoms as spheres (short equilibration of a membrane test system: a glycophorin A helix dimer in POPC). The protein is restrained in this stage, so mainly the lipid tails, the water and the ions move.
Membrane preset: bilayer side view with phosphorus atoms as spheres (short equilibration of a membrane test system: a glycophorin A helix dimer in POPC). The protein is restrained in this stage, so mainly the lipid tails, the water and the ions move.
PresetWhat it showsUse it for
DefaultEverything: cartoon by chain, ligand ball and stick, ions as spheres, water as lines, box drawn, perspective view.Checking the whole system: solvation, ions, the box and whether anything left it.
PublicationProtein and ligand only, outlines, ambient occlusion, weaker depth cue, white background, orthographic camera.Figures of the complex.
Binding siteThe ligand with green carbons and polar hydrogens, the residues within 0.5 nm as labelled sticks, protein-ligand hydrogen bonds with distances, everything in front of the site clipped away; the camera looks into the pocket from its most open side.Following the binding mode during playback and relating it to the interaction diagram.
MembraneA side view with the membrane normal pointing up, lipids as thin sticks with phosphorus atoms as spheres, cartoon, ions, water as lines, box drawn, orthographic.Membrane systems: bilayer thickness, the position of the protein, water in the bilayer.
The Binding site preset on the Viewer page. The line under the preset buttons says how many residues are within 0.5 nm and how many hydrogen bonds are present in the shown frame; both are worked out again for every frame.
The Binding site preset on the Viewer page. The line under the preset buttons says how many residues are within 0.5 nm and how many hydrogen bonds are present in the shown frame; both are worked out again for every frame.

Labels and hydrogen bonds of the Binding site preset are recomputed in every frame, so residues come and go as the ligand moves. Its hydrogen bonds use the same criteria as the analysis (donor-acceptor distance up to 0.35 nm, hydrogen-donor-acceptor angle up to 30°), so what you see in a frame is what the analysis counted in that frame.

Representations and colours

The Representation panel has one row per class of molecule: Protein, Nucleic acid, Water, Ions, Lipids and Ligand / other, each with a check box to show it, the atom count, an H box for hydrogens, a style, a colouring and a radius factor.

SettingChoices
StyleHidden, Lines, Points (small spheres), Licorice (sticks), Ball and stick, Spacefill (van der Waals), Cartoon
ColouringElement, Chain, Residue type, Residue name, Molecule, Secondary structure, Rainbow (N to C), Uniform, B-factor / RMSF
Cartoon as tube, Cartoon opacityA tube instead of helices and arrows; a translucent cartoon to see through it.
Secondary structure per frameHelices and strands assigned again for every displayed frame with the DSSP method, so the cartoon follows unfolding during playback.
Ligand bond ordersDouble and triple bonds of the ligand from the ligand file, else perceived; for display only.

B-factor / RMSF colouring colours by the B-factor column of the structure or, with Per-residue values (.xvg), by a per-residue file such as the residue RMSF written by the rmsf analysis. That puts the RMSF figure of the Results page onto the structure. Nucleic acids are drawn as sticks; there is no cartoon for them.

Display and quality holds the render Quality (Automatic, Draft: single pass, Medium: FXAA, High: 2 x 2 supersampling, Ultra: 3 x 3 supersampling), Ambient occlusion, Silhouette outlines, Depth cueing (fog), Orthographic projection, the Background (Theme, White, Black, Light gradient, Dark gradient) and a Front clip plane that cuts away what is in front of the region of interest.

Molecular surface

Show surface draws a Gaussian molecular surface Of the protein (or nucleic acid), the protein with the ligand, or the ligand alone, with a chosen Colour and Opacity. Below 100 % opacity the nearest layer is drawn transparent, so a ligand inside a pocket stays visible through the protein surface.

Playback

The Viewer page during playback: frame slider, time and the preset buttons. The Binding site preset is active, and the status line under the presets updates the residue and hydrogen-bond counts as the frames advance.
The Viewer page during playback: frame slider, time and the preset buttons. The Binding site preset is active, and the status line under the presets updates the residue and hydrogen-bond counts as the frames advance.
ControlWhat it does
First, previous, play / pause, next, lastAlso Home, comma, Space, full stop and End.
Slider and frame boxDrag, or type a frame number and press Enter.
TimeThe simulation time of the shown frame, in ns.
Speed1, 2, 5, 10, 15, 24, 30 or 60 frames per second (30 by default).
stepAdvance by this many trajectory frames per shown frame: a step of 10 plays a 1001-frame run in 100 frames.
Once, Loop, BounceAt the end: stop, start again, or play backwards.
LiveAppears when the trajectory is still being written: stays on its newest frame, which is how a running job is watched.

Trajectories are indexed when they are opened and frames are read from the file when they are shown, with recently shown frames kept in a memory cache whose size is set on the Settings page. A trajectory of hundreds of megabytes therefore opens at once, and the status line under the view says how many frames per second are actually drawn.

Periodic boundaries

The Periodic boundaries panel. The box information gives the box type, the vectors, the angles and the volume, and says how the shown frame is wrapped; the unit cell can be drawn as in the file, compact, triclinic or rectangular.
The Periodic boundaries panel. The box information gives the box type, the vectors, the angles and the volume, and says how the shown frame is wrapped; the unit cell can be drawn as in the file, compact, triclinic or rectangular.

A simulation runs in a periodic box, and a raw trajectory stores atoms wrapped into it: molecules are cut at the box faces and the protein can appear in pieces or drift out of view. The panel repairs this for display:

SettingEffectWhen to use it
Make molecules wholeJoins every molecule that the box cut.Always for a raw trajectory.
Center solutePuts the protein at the centre of the cell and every molecule as a whole inside the cell.When the protein drifts towards a face.
Unit cellAs in file, Compact, Triclinic, Rectangular: the cell the molecules are shown in; molecules are never split.Compact shows a rhombic dodecahedron as the near-spherical shape it is.
Show periodic box, Translucent box facesDraws the edges, and optionally the faces, of the box.Checking that the protein stays clear of its periodic images.

The centred trajectory that the analysis stage writes for a job is already whole and centred and is shown as written. It is not fitted, so the protein can still rotate in the box during playback.

Picking and measuring

Measurements in the viewer: each measured distance, angle or dihedral is drawn as dashed lines between the picked atoms with its value as a label. Measurements are stored as atoms, so their values are recomputed for every frame during playback.
Measurements in the viewer: each measured distance, angle or dihedral is drawn as dashed lines between the picked atoms with its value as a label. Measurements are stored as atoms, so their values are recomputed for every frame during playback.

Under Labels and measurements, Click sets what a click on an atom does: Atom information (name, residue, position, bonded atoms, secondary structure, distance to the previous pick, shown in the Picked atom panel), Distance (2 atoms), Angle (3 atoms), Dihedral (4 atoms) or Label residue. Distances are shown in nm or Å. Show labels, the label size, Clear labels and Clear measurements manage what is drawn, and Ligand hydrogen bonds draws the protein-ligand hydrogen bonds of the shown frame with the analysis criteria.

A measured distance followed through the trajectory is the quickest check of a single interaction from the diagram: pick the two atoms of a hydrogen bond and play the run; the frames in which the label exceeds 0.35 nm are the frames the analysis did not count.

Images and movie frames

The Save image dialog of the viewer: the size (from the view size to 8K, two journal column widths at the chosen resolution, or custom), the resolution in dpi with the printed size it gives, the anti-aliasing, a transparent background and the labels.
The Save image dialog of the viewer: the size (from the view size to 8K, two journal column widths at the chosen resolution, or custom), the resolution in dpi with the printed size it gives, the anti-aliasing, a transparent background and the labels.
The Export movie frames dialog: the first and last frame, every n-th frame and the frame size; the line under the fields says how many images will be written and how many seconds of film they make at 30 images per second.
The Export movie frames dialog: the first and last frame, every n-th frame and the frame size; the line under the fields says how many images will be written and how many seconds of film they make at 30 images per second.

Image (File > Save viewer image, Ctrl+Shift+S) renders the current view off screen at any size up to 16384 pixels per side and 72 to 2400 dpi (300 by default), with anti-aliasing up to 3 x 3 supersampling, an optional transparent background and the labels if you want them, as PNG, JPEG or BMP. Very large images are rendered in tiles, so the size is not limited by the screen. Movie frames renders every n-th frame of a range as numbered PNG files at 1280 x 720, 1920 x 1080 or 3840 x 2160, ready for any video tool; the camera and representation are those of the view.

For a figure, set up the view with the Publication or Binding site preset, choose the orientation, then use the journal column width at 300 or 600 dpi. For a movie, first set the step and range so that the film lasts 10 to 30 seconds; a 100 ns run with 1001 frames played at every frame is 33 seconds at 30 images per second.

The viewer beside a page

The viewer beside the Results page (F4): the RMSD figure is selected on the left while the trajectory of the same job plays on the right. Use it to find the frames behind a step in a curve.
The viewer beside the Results page (F4): the RMSD figure is selected on the left while the trajectory of the same job plays on the right. Use it to find the frames behind a step in a curve.

View > Viewer beside page (F4) shows the viewer next to the current page instead of on its own page. It is most useful with the Results page: select a figure, move the frame slider to the time of an event in the curve, and look at the structure at that moment.

Without a graphics driver

The viewer needs OpenGL 3.3. On a PC without a usable graphics driver, for example in some remote sessions or virtual machines, the program says so and, after a restart, uses the software renderer shipped with it; the start option --software-gl chooses it directly. Everything works, more slowly, but the live view has no ambient occlusion, outlines or anti-aliasing. Images saved with Image are computed on the CPU, which takes seconds for large sizes. See Troubleshooting.