The Right Tool for the Molecular Task: A Practical Guide to SAMSON Editors

When working with a molecular structure, an unexpected response to a mouse click or keyboard action can interrupt your train of thought. Often, the first useful question is simple: Which editor is active? In SAMSON, editors respond to user interactions, and exactly one editor is active at a time. Knowing how to identify and find the right editor can make everyday modeling work easier to navigate.

Think of an editor as the tool for an interaction

An editor is not just a command that runs once. It is an extension that responds to interaction events in SAMSON, such as mouse and keyboard input. Different editors support different kinds of work: examples include generating nanotubes, deforming molecular structures while preserving local rigidity, selecting with a rectangle, and applying rigid-body transforms.

This distinction offers a useful way to approach a task. Before interacting with the structure, consider what kind of interaction you need: are you navigating the viewport, selecting something, or changing the position or shape of an object? That question can help narrow down which editor to look for.

Check the active editor before you act

Because only one editor is active at any time, the active editor matters. If the viewport does something other than you expected, pause before repeating the action. Check which editor is selected, then choose the one that matches your current task. This small habit can help distinguish an incorrect tool choice from a problem with the molecular structure itself.

Editors are available from the menu on the left side of the viewport. When an editor is active, quick access commands for it are shown in the top-left corner of the viewport. For a quick route when you already know what you need, use the Find everything search box at the top of SAMSON to search for an editor.

The editor menu in SAMSON
The editor menu is located on the left side of the viewport.

Choose the right reference for the job

Some tasks are easier to identify by their goal than by the editor’s name. If you want to move around the viewport, the Moving around guide covers viewport navigation editors. If you want to transform objects, the Moving objects guide covers move editors used for transforms, alignment, and distribution.

For other work, the examples can help set expectations. A nanotube generator is an editor for creating a structure; a rectangle selection editor is for selecting; and a rigid-body transform editor is for changing an object’s pose. These are different interaction goals, so it is worth choosing the editor that corresponds to the action you intend to perform.

A nanotube generator editor
A nanotube generator is one example of an editor in SAMSON.

When the editor you need is missing

SAMSON includes editors by default, and additional editors can be added from SAMSON Connect. If you are trying to develop an editor of your own, the documentation’s extension generation guide is the relevant starting point. Editors belong to the broader family of SAMSON Extensions, but their defining role is to respond to user interaction.

A simple routine can keep tool selection clear: identify the task, locate the matching editor in the left menu or through Find everything, confirm it is active, and then interact with the viewport. If the result is unexpected, check the active editor before changing your approach.

For more details, see the SAMSON Editors reference.

SAMSON and all SAMSON Extensions are free for non-commercial use. Get SAMSON at www.samson-connect.net.

Comments are closed.