As a molecular modeler, one of your main challenges is efficiently locating and manipulating specific atomic or molecular structures in large datasets. This is where SAMSON’s Find command and its powerful NSL come into play – they streamline the process by allowing users to define precise search criteria for their data.
The Find command in SAMSON utilizes NSL strings to filter and select nodes (atoms, residues, bonds, etc.) based on various properties. This feature significantly aids in tasks like isolating ligands, residues, or specific structural groups.
Simple Selections Made Easy
Using the Find command begins with entering an NSL query into the search box. The process is intuitive, and SAMSON ensures a user-friendly experience with a context-sensitive Tab key for autocompletion. For example:
- Typing
"ALA(with the opening quote) and pressing Tab quickly lists all nodes where the name begins with “ALA”, such as “ALA 22 Backbone”, “ALA 22 Side chain”, and more.
For molecular modelers aiming for precision, this tab-completion feature saves significant time and effort when working with datasets containing recurring patterns or naming conventions.

AI Assistance for Complex Queries
If you find constructing NSL queries challenging, SAMSON further simplifies the process by integrating an AI Assistant. Clicking the
Ask AI button enables the Assistant to generate an NSL expression tailored to your active document. For example, you can request to highlight all ligands in your structure, and the AI Assistant will craft the relevant NSL string for you.
This powerful AI integration not only accelerates productivity but also democratizes access to advanced node selection capabilities for novice users.
A Look at Real-World Examples
To better understand the flexibility of NSL in the Find command, here are some practical examples:
node.category ligand, receptor(short version:n.c lig, rec): Filters ligands and receptors.atom.chainID > 2(short version:a.ci > 2): Selects atoms in chains with IDs greater than 2."CA" within 5A of S(short version:"CA" w 5A of S): Finds nodes named “CA” that lie within 5 angstroms of sulfur atoms.
These examples are just the tip of the iceberg. NSL provides numerous operators and expressions for handling logical filters, topology-based searches, and more. Whether you need simple or highly intricate selections, NSL enables you to do so with clarity and precision.
Conclusion
By mastering the Find command and leveraging NSL strings, you can revolutionize your molecular modeling workflows. The ease of use, enhanced by AI assistance, makes it an invaluable tool for researchers working with large molecular structures.
To dive deeper into the Node Specification Language and explore more capabilities, visit the official NSL documentation page.
Note: SAMSON and all SAMSON Extensions are free for non-commercial use. You can get SAMSON here.
