For molecular modelers, one common challenge is selecting specific nodes—such as atoms, residues, or structural groups—across often complex molecular documents. Whether you’re working with a large protein or a small ligand, this process can quickly become overwhelming without the right tools. Fortunately, SAMSON’s Find command, powered by the Node Specification Language (NSL), provides a robust solution to this problem.
Why Use the Find Command?
The Find command is a powerful feature in SAMSON that allows users to specify and select nodes based on precise criteria. Using NSL strings, you can describe nodes or groups of nodes by attributes, proximity, topology, and more. This saves time, reduces manual work, and improves accuracy, especially when managing complex molecular data.
Using the Find Command
The Find command is accessible in your SAMSON workspace. Simply open the search box and input your desired NSL string. For example, let’s say you want to find hydrogens in your document. By typing H into the search box, you can instantly select all hydrogen atoms within the current molecular context.
Advanced users will appreciate the Tab key feature, which offers automatic, context-sensitive completion. Suppose you type "ALA (with the opening quotation mark), intending to search for nodes named after Alanine residues. Pressing Tab will give you a filtered list of options such as:
"ALA 22 Backbone""ALA 22 Side chain""ALA 28"- …
With this feature, you can explore your document’s hierarchical structure effortlessly, saving time and avoiding misselections.
Interactive Assistance with AI
Another remarkable feature is the AI Assistant, which takes the Find command to a new level. By clicking the AI Assistant button 
next to the selection string, you can ask for help generating NSL expressions tailored to your document. For instance, the AI can help craft an expression to select all backbone nodes, outputting something like node.type backbone.
This feature leverages the active document’s hierarchy, offering selections relevant to your specific molecular context. For molecular modelers juggling detailed workflows, it simplifies the process while maintaining precision.
Example Applications
Here’s a quick list of tasks you can easily achieve using the Find command:
- Finding residues within a certain ID range:
residue.id 20:40. - Selecting side chain nodes with sulfur atoms:
node.type sideChain having S. - Highlighting backbone nodes:
node.type backbone. - Identifying atoms near a target residue:
atom.symbol C within 5A of "GLU 50".
The vast flexibility of NSL lets you go from simple queries to highly detailed conditions, such as combining logical and proximity operators.
Visualizing Your Search Results
To better understand what’s happening, SAMSON provides visual feedback. For example, here’s what it looks like when you use the Find command to select specific nodes:
Paired with features like filtering in the Document view, the Find command ensures that whether you’re refining your molecular selection or adjusting your structural focus, you always maintain a clear grasp of your work.
Final Thoughts
The Find command not only empowers users to manage molecular complexity but also integrates seamlessly with SAMSON’s broader toolkit. Its combination of flexibility, intelligent suggestions, and precision makes it indispensable for molecular modelers.
To learn more about the Find command and NSL, visit the official SAMSON Node Specification Language documentation.
SAMSON and all SAMSON Extensions are free for non-commercial use. You can download SAMSON at SAMSON Connect.