In a crowded molecular document, the difficult part is often not knowing what you want to inspect—it is expressing that intent precisely. You may need to isolate a ligand’s neighborhood, find a particular residue in one chain, or select a binding site before changing its representation. Repeatedly navigating a complex structure by hand can interrupt the work you are trying to do.
SAMSON AI offers a natural-language route into this task through the /select command. Instead of starting with selection syntax, describe the molecular features you want. SAMSON AI translates the request into the corresponding Node Specification Language (NSL), displays it, and executes it.

/ in the Assistant input to see available commands.A selection workflow that keeps you in control
- State the target and its context. Use a short, specific description. For example:
/select all lysines in chain B.Naming both the residue type and chain helps make your intention clear. - Use spatial criteria when proximity matters. If the goal is to inspect residues around a ligand, try
/select all side chains within 5 angstrom of the ligand.A distance cutoff turns a vague request like “near the ligand” into a measurable criterion. - Use the displayed NSL as a checkpoint. Because SAMSON AI shows the NSL corresponding to your natural-language request, you can review how the selection was interpreted. This is useful when a selection will guide later analysis or presentation: check that the expression reflects the target and constraints you intended.
- Then act on the selected nodes. Once the selection is right, you can ask SAMSON AI to perform a document action. For example, the documented command
/do select the ligand and apply a licorice model.combines choosing a target with changing how it is displayed. Other examples include zooming to the binding site or selecting a Gaussian surface and changing its color.
Make requests easier to interpret
When a result is broader or narrower than expected, refine the request by adding the missing distinction: a residue type, chain, spatial distance, or named structure component. This is a practical habit with any natural-language interface: include the criteria you would otherwise have to explain to a colleague. For instance, “select nearby residues” leaves the distance unspecified, while “select all side chains within 5 angstrom of the ligand” gives a concrete boundary.
It also helps to treat selection and action as separate decisions. First establish which nodes should be selected; then decide whether you want to change their representation, color, or view. Separating these steps makes it easier to notice whether an unexpected outcome came from the selection criteria or the requested action.
To open SAMSON AI, choose Interface > Assistant, or use Ctrl+0 on Windows and Linux, or Cmd+0 on Mac. Type / in the Assistant input to see the available commands. The assistant can be useful for document actions, but its answers may be inaccurate or based on a misinterpretation. Check important selections and verify critical information rather than assuming every result is correct.
For the complete command list, examples, and limitations, see the SAMSON AI documentation.
Note: SAMSON and all SAMSON Extensions are free for non-commercial use. Get SAMSON.
