The Inspector is a powerful tool which provides a possibility to view and edit the properties (attributes) of the selected nodes (see Selecting to learn more about how to select nodes in SAMSON), whether it is one node or a group of different nodes. Simply, select a node and open the Inspector to see what is available.

The inspector can be opened via Interface menu > Inspector or via the Ctrl + 2 shortcut on Windows and Linux or Cmd⌘ + 2 on Mac.

Attributes and groups

Attributes shown in the inspector might either be modifiable or not. For an atom, for example, you cannot modify its atomic weight, element name and symbol, since they depend on the element type. However, once you modify the element type, let's say from Carbon to Nitrogen, all the dependent attributes will be changed accordingly.

For some attributes, there is a possibility to reset their value to the default one. For that, hover above the attribute's description and if the cursor changes as in the image below you can double-click on the label to reset this attribute to its default value.

Reset attribute to its default value

Attributes in the inspector are grouped into corresponding node type groups and attribute groups inside of each node type group.

Let's open any molecule, e.g. 1YRF, provided in the Samples folder. Select any atom from the molecule. You will see all the attributes of these atoms grouped into attribute groups.

Inspecting an atom

You may see several node type groups (e.g. Atom, Bond, etc) in the inspector depending on the selection and the controls (see below) you have chosen.

Let's use Rectangle selection to choose a group of atoms.

Inspecting a group of nodes

Filtering attributes

You can use the filter to see matching attributes only.

The Inspector controls

Having at least one atom selected, start typing "position" in the filter and you will only see the matching attributes.

Filtering attributes

Now, let's try and change one of the attributes as shown in the image below. When modifying the atom's position you will see how it moves.

Changing attributes


The Inspector has controls that allows you to choose:

a) whether you inspect the descendants of the selected nodes as well

Inspect Selected nodes only
Inspect Selected nodes and descendants

b) whether you edit all selected nodes or only the last selected node

Edit one node only (the last selected one)
Edit all selected nodes

Let's consider these features in more detail. Please, open any molecule, e.g. 1YRF provided in the Samples folder, and select in the document view the LEU 1 residue as shown in the image below.

The Document View with the 1YRF molecule and the chosen LEU 1 residue

If you choose the control "Selected nodes only", you will only see the residue attributes in the inspector.

Inspecting selected nodes only

If you choose the control "Selected nodes and descendants", you will see in the inspector attributes for the residue and all its descendants (backbone, side-chain, all atoms and bonds).

Inspecting selected nodes and descendants

Having chosen the same residue and "Selected nodes and descendants", type "position" in the filter and you will only see the attributes that match the filter.

Inspecting selected nodes and descendants. Filtering

Let's now try to change the "position" attributes. Choose the control "Edit one node only" and try to modify the position through the inspector. You will see that only one atom out of the whole selection changes its position: the last atom in the selection.

Inspecting selected nodes and descendants and editing one node only

Now, choose the control "Edit all selected nodes". The inspector will still show the attributes of the last selected node. Try to modify the position through the inspector. You will see that all atoms in the selection change their positions.

Inspecting selected nodes and descendants and editing all selected nodes

Note: If you want to move a group of atoms without changing the relative positions of atoms inside the group, do not uncheck the "Relative" checkbox. If the "Relative" checkbox is unchecked, the positions for all selected atoms will be modified to the same value. Try it, you can always undo thanks to the History mechanism.