GeinQSAR Studio
Home › The 3D workspace

The 3D workspace

The selected compounds of a dataset as an interactive 3D scene: how to fill it, how to draw and measure the molecules, how to add surfaces, and how the mouse and the keyboard move the view.

The 3D workspace is a document of its own, one per dataset, with the viewer on the left and a control panel on the right. It shows the compounds you selected in the spreadsheet, each as one entry of the scene, and it shares its selection with the spreadsheet and every plot of the dataset. It is the place to look at 3D structures before a 3D-QSAR study: to check that an imported alignment is what it should be, that the conformers are sensible, or to measure a distance in a docked pose.

Three steroids of the shipped sample in the workspace, drawn ball and stick. When more than one entry is shown, each entry gets its own carbon colour (here cyan, magenta and grey), so the molecules can be told apart where they overlap. The panel on the right holds the Entries, Display and Measure sections; Surface, View and Annotations are closed.
Three steroids of the shipped sample in the workspace, drawn ball and stick. When more than one entry is shown, each entry gets its own carbon colour (here cyan, magenta and grey), so the molecules can be told apart where they overlap. The panel on the right holds the Entries, Display and Measure sections; Surface, View and Annotations are closed.

Opening the workspace

CommandWhat it does
Chemistry > Open 3D workspace, Ctrl+3Opens the workspace of the active dataset and shows the rows selected in it.
3D-QSAR > Open the 3D workspaceThe same command, from the 3D-QSAR menu and the Workspace button of the 3D tab of the ribbon.
3D-QSAR > Generate conformers for the selectionShows the selected rows and builds a 3D structure for each that has none (Conformers on the 3D tab).
3D-QSAR > Add a molecular surfaceAdds a surface to every visible entry (Surface on the 3D tab).
Project explorerThe context menu of a dataset has Open 3D workspace.

The workspace shows what you selected and nothing else. With no row selected it opens empty, says No compounds selected in the view, and offers Show first in the panel, which shows the first rows of the dataset (at most 200). A workspace never adds rows on your behalf.

An empty workspace. The view carries one line, No compounds selected, and the Entries section offers Show first with the number of rows it would show; Show selection is greyed out until rows are selected in the spreadsheet.
An empty workspace. The view carries one line, No compounds selected, and the Entries section offers Show first with the number of rows it would show; Show selection is greyed out until rows are selected in the spreadsheet.

A compound whose structure carries 3D coordinates (an SD or MOL2 file of docked poses or of an aligned series) is drawn in those coordinates. A compound without them is embedded on demand by distance geometry with a force-field refinement, on a worker thread; the panel says Generating conformers meanwhile and the status bar reports how many were generated. The embedding is seeded, so the same structure gives the same conformer every time. A structure that cannot be embedded is reported in a notification and left out.

How a molecule is drawn

A 3D view opens on a white background, with the atoms in element colours: mid grey carbon, white hydrogen, blue nitrogen, red oxygen, gold sulfur. Each stick takes the colour of the atom at its own end and changes colour half-way along the bond, double and aromatic bonds are drawn as a main stick with a thinner one beside it, and the lighting is bright and even with one clear highlight. There are no outlines around the atoms: the shading separates the sticks on its own. That is the look a printed figure wants, so what is on the screen is what the figure will be.

The look of earlier versions is still available, as Lighting Soft, Element colours Classic and Background Dark in the control panel, with Silhouette outlines switched on in Settings. It reproduces the pictures of version 1.1.0 exactly.

The control panel

Each section opens and closes by its heading, and the program remembers which ones were open, the width of the panel (drag the divider) and the background. The Controls button of the viewer toolbar hides the whole panel.

The workspace of three compounds of a 2D-QSAR dataset with the Entries, Display and Measure sections open. Each entry has a Show box on the left and a Dim box on the right; Link selection is on, so picking an atom here selects the row in the spreadsheet.
The workspace of three compounds of a 2D-QSAR dataset with the Entries, Display and Measure sections open. Each entry has a Show box on the left and a Dim box on the right; Link selection is on, so picking an atom here selects the row in the spreadsheet.

Entries

ControlWhat it doesWhen to use it
Show selectionReplaces the entries by the rows now selected in the dataset (at most 200).After selecting a different set of rows in the spreadsheet or a plot.
Show first nOnly in an empty workspace: shows the first rows of the dataset.For a quick look at a file you have just imported.
Show boxShows or hides the entry.To take one molecule out of a crowded overlay without losing it.
Entry nameClicking it selects the compound in the dataset and in the scene. The name of a selected compound is drawn in the accent colour.To find the spreadsheet row of a molecule.
DimDraws the entry greyed out, so the others stand out.To compare two molecules against the rest of a series.

Display

ControlChoicesDefault and reason
HydrogensAll, Polar only, NoneAll. Polar only keeps the hydrogens on nitrogen, oxygen and sulfur, which are the ones that matter for hydrogen bonding and for donor fields; it removes most of the clutter of a large overlay.
Atom labelsNone, Element, Index, Element and indexNone. Index labels are the atom numbers of the structure, which is what a core definition or a per-atom property refers to.
Hydrogen bondsOn or offOff. Draws dashed lines between donor and acceptor atoms within 3.5 Å (Baker and Hubbard 1984), between all entries, which is how a ligand pair or a ligand and a water network is checked.
Link selectionOn or offOn. Selecting atoms selects the compound in the spreadsheet and the plots, and the other way round. Switch it off to select atoms for a measurement without changing the selection of the dataset.

Measure

Choose Tool: Distance, Angle or Dihedral, then click two, three or four atoms in the view. The measurement is drawn with its value in the scene and Count says how many there are; Clear removes them all. A click on a surface or a lobe instead of an atom uses the point under the cursor. Esc abandons a measurement that is half picked. Set the tool back to None to select atoms by clicking again.

Surface

ControlMeaning
TypeVan der Waals: the union of the atom spheres. Solvent accessible: the same spheres grown by a 1.4 Å probe, the surface the centre of a water molecule can reach. Solvent excluded: the surface a rolling 1.4 Å probe leaves (the Connolly surface), which follows the contact surface of the molecule more closely.
Add surfaceBuilds the chosen surface for every visible entry, replacing the surfaces that were there. The work runs as a job; the status bar reports how many surfaces were added.
OpacityFrom 0.10 to 1.00, 0.45 when the workspace opens. A translucent surface leaves the skeleton readable.
Remove surfacesRemoves every surface.
A van der Waals surface added to the entries, with the opacity raised to 0.91 so that the surface is nearly opaque. The Surface section shows the type, Add surface, the opacity slider and Remove surfaces.
A van der Waals surface added to the entries, with the opacity raised to 0.91 so that the surface is nearly opaque. The Surface section shows the type, Add surface, the opacity slider and Remove surfaces.

View and Annotations

These two sections are the same in every 3D view of the program: the workspace, the maps of the 3D-QSAR dashboard and the pharmacophore view.

ControlMeaning
DirectionTurns the camera to the best view, front, back, left, right, top or bottom, and frames the content.
ProjectionPerspective or orthographic. Orthographic keeps parallel lines parallel and sizes comparable across the picture, as most published figures do.
MotionStill, Spin (about the vertical axis) or Rock (back and forth). Motion helps the eye read depth in a dense overlay.
Clip slab, ThicknessDraws only a slab around the centre of the view, from 1 to 30 Å thick, to look inside a crowded scene.
Depth cueFades the back of the scene towards the background, from 0 (off) to 1.
ShadowsAmbient occlusion: soft contact shadows where atoms meet, from 0 (off) to 2.5.
LightingBright (the default), Soft, Studio, Glossy, Flat or Toon. Bright for everyday work and for figures, Soft for the look of earlier versions, Glossy for the look of classic contour-map figures, Flat for schematics.
Element coloursStandard (the default): mid grey carbon, white hydrogen, blue nitrogen, red oxygen, gold sulfur, the colours of the usual stick picture. Classic: the dark carbon and the colours of the 2D drawings, the palette of earlier versions.
BackgroundWhite (the default), Dark, Light or Black. White is the background of a printed figure; the choice is remembered for each kind of view.
Save view, Load viewWrites the camera, the lighting and the annotation settings to a file and reads them back, so a figure can be made again from the same angle.
LegendCorner, Bottom strip or Off.
Title, Scale bar, Axes, LabelsThe title of the scene in the top-left corner, a bar of a round length in Å, the x, y and z axes of the model frame, and atom, feature and measurement labels.

The viewer toolbar

The toolbar in the top-left corner of the view has the frequent actions. When the view is narrow, the buttons that do not fit move into a More menu at its end.

ButtonAction
Fit to view (F)Frames what is drawn.
View directionBest view, front, back, left, right, top, bottom. The best view looks along the direction in which the content is widest and tallest.
RepresentationWire, Stick, Ball and stick, CPK or Licorice, for every entry.
BackgroundDark, Light, White, Black.
Export figure (camera)Opens the 3D figure dialog, which renders the scene off screen at a stated size and resolution. See Publication figures.
DisplayOnly in views without a control panel, such as the preview of a wizard page: projection, motion, depth cue, shadows and the annotations as one menu.
ControlsShows or hides the control panel.
Focus mode (F11)Hides the side panels of the window so the document has the whole window. Esc leaves it.
Full screen (Ctrl+F11)Draws the view alone over the whole window. The same button or Esc leaves it.

A view frames its content when it opens. As long as you have not rotated, moved or zoomed it, it frames the content again whenever its size changes (the window is resized, the panel is hidden, focus mode is switched on). Once you move the camera it stays where you put it until you press Fit to view or choose a direction.

The control panel hidden with Controls: the view takes the width of the document and the molecules are framed again.
The control panel hidden with Controls: the view takes the width of the document and the molecules are framed again.
Focus mode: the ribbon, the project explorer and the inspector are hidden and the workspace has the whole window, with its panel still beside the view.
Focus mode: the ribbon, the project explorer and the inspector are hidden and the workspace has the whole window, with its panel still beside the view.
Full screen: only the view and its toolbar are drawn. The toolbar keeps the representation, background and figure buttons; the highlighted button at its end leaves full screen.
Full screen: only the view and its toolbar are drawn. The toolbar keeps the representation, background and figure buttons; the highlighted button at its end leaves full screen.

Mouse and keyboard

InputAction
Left dragRotate (a virtual trackball about the centre of the view).
Middle drag, or Shift + left dragMove the scene.
Right drag, or the wheelZoom. The wheel zooms towards the point under the cursor.
Ctrl + left dragSelect the atoms inside a rectangle.
Alt + left dragSelect the atoms inside a freehand outline (lasso).
Click on an atomSelect it (and with Link selection its compound). Shift+click adds, Ctrl+click toggles, Alt+click removes. A click on empty space clears the selection.
Double clickOn a molecule: frame that entry. On empty space: frame everything.
1 to 6Thin lines, wire, stick, ball and stick, CPK, licorice.
HCycle the hydrogens: all, polar only, none.
F, Shift+FFrame everything; frame the selection.
OSwitch between perspective and orthographic projection.
SStart or stop spinning.
Ctrl+ASelect every atom of the scene.
EscAbandon a half-picked measurement; otherwise clear the selection.
The keys act only while the pointer is over the view or the view has the keyboard focus.

Selection is shared

The workspace, the spreadsheet and the plots of a dataset share one selection. Picking an atom selects its row, and selecting rows elsewhere highlights the corresponding entries. A selection that arrives from the spreadsheet is not echoed back, so rows that are not shown in the workspace stay selected. Nothing is selected, shown or hidden on your behalf.

The 88 thrombin inhibitors of a published benchmark in the coordinates of their SD file, which are the alignment of the authors, drawn as sticks with one carbon colour per entry. A view of this kind is the quickest check that an aligned file has been read in its own frame before it goes into the 3D-QSAR builder with the alignment As supplied.
The 88 thrombin inhibitors of a published benchmark in the coordinates of their SD file, which are the alignment of the authors, drawn as sticks with one carbon colour per entry. A view of this kind is the quickest check that an aligned file has been read in its own frame before it goes into the 3D-QSAR builder with the alignment As supplied.

Rendering quality

The look of the workspace is set in Tools > Settings > 3D workspace (Ctrl+,). The settings apply to new views and to the workspace at once; the lighting, the background and the annotations of a workspace are its own and are kept.

SettingMeaningWhen to change it
Quality presetDraft, Balanced (default), High, Publication. Draft renders at 1x without contact shadows, Balanced at 1x with them, High at 2x with finer shadows and Publication at 3x with the finest.Draft on an integrated graphics adapter or a remote desktop; High or Publication on a fast card for sharper edges on screen.
Supersampling0 (default) takes the value of the preset; 1 to 4 sets it. The row shows the factor in effect.Only to override the preset.
Ambient occlusionContact shadows. The Draft preset turns them off whatever this box says.Off on slow hardware.
Silhouette outlinesDark outlines around atoms and bonds. Off by default: the standard look separates sticks by their shading alone.On for a dense overlay of an aligned series, or for a figure printed small.
Depth cueFading towards the back of the scene.Off for flat schematics.
Perspective projectionPerspective when ticked, orthographic otherwise.Untick it if you prefer every new view orthographic.
Hydrogens in a new 3D viewAll (the default), Polar only or None. The view's own control changes that view alone.Polar only when you work mostly with hydrogen-bonding patterns in crowded structures.
The 3D workspace page of the settings at its defaults: the Balanced preset, supersampling 0 (in effect 1x), contact shadows, depth cue and perspective on, outlines off, and all hydrogens in a new view.
The 3D workspace page of the settings at its defaults: the Balanced preset, supersampling 0 (in effect 1x), contact shadows, depth cue and perspective on, outlines off, and all hydrogens in a new view.

Exported figures are rendered off screen at their own size and resolution, independent of these settings; see Publication figures.