SAMSON provides various visualization tools (visual models, visual presets, etc) and rendering options (styles, special effects, etc) to help you analyze molecular systems and create beautiful visualizations and animations.
See also: Selecting, Color schemes, Visual models, Visual presets, Presenting and animating
In this section, we will show how to use SAMSON's visualization tools and rendering options.
The fastest way to visualize a molecular system is by applying visual presets to it. Visual presets provide an efficient way to apply multiple visual representations and color schemes simultaneously to a complex molecular system based on selectors, all in just a few clicks. SAMSON provides a set of default visual presets and you can create and save your own visual presets, e.g., by modifying the existing ones. See the Visual presets section on how to apply and create visual presets.
To apply a visual preset click on Visualization menu > Visual preset or Biology menu > Visual preset and, in the pop-up window, select a visual preset among the existing ones and click apply.
The visual preset is applied to the selected nodes or to the whole document if nothing is selected. The visual models created by the visual preset are stored in the document in a folder named based on the visual preset.
In the example below, the receptor is shown as ribbons, ligands and waters are represented as licorice, and ions are shown through a van der Waals representation in just a few clicks.
Please refer to Visual presets section for more information on how to apply visual presets and create your own visual presets.
Further in this section you will learn how to apply visual models, colorize, and change various rendering effects.
Another fast way to visualize your system is by applying an illustrative visualization and rendering style inspired by the RCSB PDB Molecule of the Month style by David S. Goodsell (RCSB PDB-Rutgers and The Scripps Research Institute). For that, simply click on Visualization menu > Visualize > Illustrate. It applies an illustrative visual preset (the van der Waals visual model for receptors and ligands with the color per chain ID (illustrative) and the van der Waals model for ions), and sets the rendering preferences to resemble the illustrative style. The colorization is done in the way that it resembles the Molecule of the Month style by David S. Goodsell.
To reset the reset the view and the rendering style, remove the applied visual models in the Document view and choose Default in Visualization menu > Effects as shown in the Changing rendering style subsection.
SAMSON provides several predefined rendering style between which you can easily switch in Visualization menu > Effects.
Rendering styles make it possible to quickly switch between different sets of special rendering effects like ambient occlusion, lighting, fog, shadows. You can also easily change these rendering effects in Visualization menu > Effects or directly in Preferences as described below.
To save a picture, you can capture the SAMSON's viewport by pressing F10. You can modify the capture preferences in the Preferences > Interface > Captures panel (Interface menu > Preferences). See Captures preferences for more information.
Press F10 to take the viewport capture, the captured image is saved in the folder specified in capture preferences. Press Ctrl/ Cmd⌘+ 10 to take the viewport capture and choose where to save it. Press Shift+ 10 to copy the viewport capture to the clipboard.
You can hide from displaying in the viewport any group of structural nodes (atoms, chains, residues, molecules, etc), folders, visual models, meshes, and some other nodes. When you hide a parent node its children nodes will be automatically hidden as well, e.g. if you hide a residue then atoms in this residue will be hidden, but you can make the descendant nodes visible while their parent node is hidden.
You can hide a node just by unticking the box of this node in the document view. For example, in the image below the chain B is hidden and won't be visible in the viewport. You can show a node by ticking the box back.
Note: If at least one descendant of a node is visible then the node's box in the document view will be shown as ticked to depict that some of its descendants are visible.
To change the visibility of nodes, select them in the document view or in the viewport, then right-click and in the context menu go to the Visibility section where you can change the visibility of the selection and of all nodes. For example, in the image below we are to hide two chains.
Also, you can hide/show nodes using Python Scripting.
For some nodes (structural models, folders, labels, and many visual models, meshes) you can modify their transparency by selecting them and changing this parameter in the Inspector.
Here is how, a semi-transparent structural model might look like along an opaque secondary structure visual representation:
Atoms and bonds in structural models have a default visual representation, where atoms are represented as balls and bonds as sticks.
You can modify it in Preferences > Rendering > Structural models:
Try various options, constant atoms size or atom size proportional to van der Waals raduis, and various parameters for atom and bond sizes to see how it affects the display of molecules. If the Automatically test box is checked, this immediately affects the rendering in the viewport.
For example, here is how a molecule looks like with the "Constant atom size" option and the default atom radius (0.3Å):
And here how the same molecule looks like with the "Atom size proportional to van der Waals raduis" option.
Visual models provide alternate visual representations of structural models, or even some arbitrary shapes, that may be displayed in the viewport.
Let's open a molecule, e.g. 1AF6 using the Fetch PDB (you can find this extension in the Apps menu > All or using the Find commands, apps and editors... in the top-left corner of SAMSON) which will download it from RCSB PDB. We will apply a Ribbons (secondary structure) visual model to it.
Important: When a new visual model is added to the document, it is applied to the current selection, or, if nothing is selected, to the whole document. So, before adding a visual model make sure that a system to which you would like to apply it is selected and nothing else is selected, or nothing is selected if you would like to apply it to everything in the document.
Visual models may be added from the Visualization menu (Visualization > Visual model) or via Ctrl/ Cmd⌘ + Shift + V. A pop-up menu will appear asking you to choose a visual model type and provide a name for a visual model node that will be created. For example, let's choose the Ribbons (secondary structure) visual model.
As a result, a new visual model will be added in the document. You can also hide the structural model by unticking the box.
Provided they handle them, visual models can be colorized with color schemes. This is the case for the Ribbons (secondary structure) visual model which we added before (when no color scheme is applied, a default color scheme based on the residue sequence numbers is used, as in the picture above). For more information see the Colorizing section.
As other node, you can colorize a visual model in several ways:
In the example below, we apply different color schemes to the Ribbons visual model using the above-mentioned ways.
You can apply several visual models at once even to the same nodes. For example, try applying the Licorice visual model: select a molecule, click Ctrl/ Cmd⌘ + Shift + V, and choose the Licorice visual model.
See the Colorizing section.
Several rendering effects may be applied from the Preferences panel.
Ambient occlusion improves the perception of depth in molecules, by simulating the fact that deeper regions are less accessible to light, and are thus darker.
Two types of ambient occlusion are handled in SAMSON:
The ambient occlusion settings may be changed in the Rendering / Ambient occlusion section of the Preferences panel:
The screen-space ambient occlusion can be switched on/off in one click in the Visualization menu > Effects.
Here is the Ribbons visual model of 1AF6 without ambient occlusion:
And here it is with enabled screen-space ambient occlusion:
Anti-aliasing removes jagged edges from images, and may significantly improve rendering. The anti-aliasing settings may be changed in the Rendering / Ambient occlusion section of the Preferences panel. Fast Approximate Anti-Aliasing (FXAA) is typically very efficient, and can be activated on most recent graphics cards.
Note: Anti-aliasing requires more rendering from your GPU and therefore may slow-down the visualization for big systems.
Without anti-aliasing (choose Best speed from the list: multisampling factor set to 1, no FXAA), edges are very visible:
With FXAA and multisampling set to 2 (choose Higher quality from the list), edges are much smoother, and pixel boundaries are much less visible:
The background color of the viewport may be changed in the Rendering / Background section of the Preferences panel:
Four options are available:
Let's try to set a custom gradient background by choosing Custom and modifying the Custom top color and the Custom bottom color.
You can switch between different backgrounds easily in the Visualization menu > Effects and in the bottom of the Viewport.
You can always return to the default SAMSON background color.
This effect simulates the depth-of-field effect produced by actual cameras (e.g. blurred distant objects). If enabled, when you zoom in the molecule its distant parts will be blurred. The depth-of-field settings may be changed in the Rendering / Depth-of-field section of the Preferences panel:
Turn the depth-of-field on, set the strength to 80 and zoom on a molecule.
The depth-of-field can be switched on/off in one click in the Visualization menu.
Basically, fog makes distant objects less visible. Fog attenuates distant parts by blending them progressively with the background. Turn it on to make it easier to focus on the foreground.
The near and far distances are based on the camera location and determine where the fog is enabled. Before the "near distance" there is no fog, after the "far distance" every node is invisible. The "strenght" parameter influences the speed at which the fog is appearing.
The fog settings may be changed in the Rendering / Fog section of the Preferences panel:
The fog can be switched on/off in one click in the Visualization menu.
Here is 1YRF again with both depth-of-field and fog:
Shadows are particularly helpful to improve the perception of relative positions.
Note: In case of an old graphics card you may want to either disable this option, or choose the lower preset.
The shadows settings may be changed in the Rendering / Shadows section of the Preferences panel:
The shadows can be switched on/off in one click in the Visualization menu.
Without shadows, it may be difficult to perceive the relative positions, e.g., of 1YRF to the graphene sheet behind it:
With shadows, however, this becomes much easier:
In SAMSON, lighting can be modified in the Rendering > Lightning section of the Preferences panel:
This section makes it possible to control the parameters of the two point lights that illuminate the document, as well as global parameters. Each light has the following parameters:
The first light is typically the main light, which is thus typically brighter than the second light (a “back light”).
Finally, three more parameters are global:
Try changing all parameters and see the impact on rendering (switch on the Automatically test check box in the bottom).
You can easily switch between various presets for lighting either in Visualization menu > Effects > Lighting or in Preferences > Rendering > Lightning.
if you want to reproduce the flat lighting, set the light intensity for both first and second light to zero, the ambient light to 0.8, and the Fresnel power to zero.
Silhouettes make it easier to separate regions with different depths. The silhouettes settings may be changed in the Rendering / Silhouettes section of the Preferences panel.
The silhouettes can be switched on/off in one click in the Visualization menu.
Let's create the Ribbons (secondary structure) visual model for 1YRF molecule and enable silhouettes with the thickness set to 1
Let's make the following image of the molecule with PDB code 3J27 (part of the Dengue virus):
You can reproduce this image via the following steps:
Let's make the following image of the molecule with PDB code 1EQZ (the nucleosome core particle):
You can reproduce this image via the following steps:
Let's reproduce an image of the molecule with PDB code 3JC8 (the type IVa pilus machine in a piliated state).
Here we colorized 3JC8 by groups of chains. Please, download 3JC8.sam file in which for simplicity we combined chains in groups.
You can reproduce this image via the following steps:
Let's make the following image of the molecule with PDB code 4QWE (DNA polymerase in complex with DNA).
You can reproduce this image via the following steps:
atom.symbol S or atom.symbol Ca
(short version: a.s S or a.s Ca
) and click Enter. Now you should see 11 nodes selected, press Ctrl/ Cmd⌘ + Shift + V and add Van der Waals visual model. Select in the document view the newly created Van der Waals visual model and in the Inspector (click Ctrl/ Cmd⌘ + I if you do not see the Inspector) set the scale to 0.75.Let's make the following image of the molecule with PDB code 1DGF (the human erythrocyte catalase).
You can reproduce this image via the following steps:
n.t structuralGroup
(short version: n.t sg
) and click Enter, then right-click on any selected node, and choose Invert selection in the context menu, right-click again on any selected node and in the context menu choose Visibility > Hide selection. Let's now hide all water atoms: open the Find window, input a.water
and click Enter, then right-click on any selected node and in the context menu choose Visibility > Hide selection.See also: Color schemes See also: Visual models See also: Visual presets See also: Presenting and animating