If you’re a molecular modeler, you’ve likely run into the challenge of needing to efficiently select and filter specific nodes, residues, or molecular structures in complex models. Manually combing through large molecular datasets is impractical and tedious. That’s where SAMSON’s Node Specification Language (NSL) comes in. This powerful tool allows users to perform precise selections and filters based on attributes, topology, and proximity—saving time and reducing frustration.
The Problem: Efficiently Selecting Nodes
In molecular modeling, selecting specific atoms, residues, or structural features is critical for tasks such as editing, analyzing, or visualizing molecular models. Imagine needing to isolate all hydrogen atoms bonded to sulfur across a large molecular assembly or filtering residues within a certain distance of a target molecule. Without an efficient tool, such tasks can be extremely time-consuming.
SAMSON’s NSL provides a highly flexible solution to address this need. Users can create compact and powerful queries to select nodes based on their attributes, relationships, or spatial positions. Let’s dive into how you can start using NSL and explore its core functionality.
Quick Start: Where Can You Use NSL?
The NSL is integrated into key commands and interfaces in SAMSON:
- Use the Select > Find command to search and select nodes using NSL expressions. The Find command supports features like context-sensitive completion to simplify query writing.
- Enter NSL expressions in the filter box of the Document view for dynamic filtering and fast interaction with molecular structures.
For example, you can use expressions like node.type residue to select all residues, or "CA" within 5A of S to filter nodes within 5 Å of a sulfur atom.
Example Queries
Here are some practical NSL expressions to get you started:
node.category ligand, receptor: Selects all ligands and receptors.C or H: Selects all carbon or hydrogen atoms."CA" within 5A of S: Finds nodes named “CA” within 5 Å of any sulfur atom.node.type residue and not residue.type ALA: Selects all residues except alanine.H linking O: Selects hydrogens bonded to oxygens.
Not only are these expressions compact, but they also demonstrate how targeted you can make your selections in even the most complex molecular structures.
Find Command: A Closer Look
The Find command is one of the most powerful features for leveraging NSL. By pressing Ctrl+F (Windows) or Cmd+F (Mac), you open the search box where you can enter your NSL query. Additionally, the search box’s context-sensitive completion makes it easier for beginners to construct NSL expressions by providing suggestions based on your query.
For example, entering "ALA and pressing Tab will display all nodes whose names begin with “ALA”:
- “ALA 22 Backbone”
- “ALA 22 Side chain”
- “ALA 28”
The intuitive interface ensures that users can boost productivity without needing to memorize complex syntax.
Why NSL Saves Time
The ability to harness expressions like node.type sideChain having S (selecting side chain nodes that contain sulfur) or C within 5A of "GLN 2" (carbons within 5 Å of node GLN 2) eliminates guesswork, manual selection errors, and repetitive tasks. Whether you’re filtering atoms for editing, aligning specific residues, or analyzing atomic neighborhoods, NSL provides scalability and precision.
Interactive Tutorials and AI Assistance
If you are unsure how to write NSL expressions, SAMSON offers an interactive tutorial titled “Selecting using the Node Specification Language” under the Help > Tutorials menu. Additionally, the AI Assistant is a game-changer. You can click on the 
Ask AI button next to the selection string input to generate NSL expressions tailored to your active document. This feature allows for rapid learning and reduces the barrier to entry for new users.
Learn More
NSL transforms how molecular modelers interact with their data by streamlining complex selections. For a deeper dive into the syntax and additional examples, visit the official SAMSON Node Specification Language documentation.
Note: SAMSON and all SAMSON Extensions are free for non-commercial use. You can download SAMSON at https://www.samson-connect.net.