For molecular modelers, selecting specific elements in complex molecular systems is a recurrent and often challenging task. Whether it involves identifying binding-pocket residues, residues forming salt bridges, or water molecules close to ligands, precise selection is crucial for insightful analysis. The Node Specification Language (NSL) in SAMSON provides a powerful syntax to automate and simplify these tasks.
NSL expressions allow users to articulate selection criteria with incredible specificity. They minimize the manual effort required for filtering molecular components, particularly in large structures, while still enabling in-depth customization. Below, we explore a series of problem-oriented examples that demonstrate how NSL can save time and effort for common molecular selection operations.
What is NSL?
NSL, or Node Specification Language, is a syntax within SAMSON for selecting nodes based on their features, such as their position, chemical properties, or relationships to other nodes. The language is intuitive yet expressive, allowing researchers to pose complex queries that would otherwise be tedious to apply manually.
Examples of NSL Selection Tasks
Here are examples of how NSL simplifies common molecular selection challenges:
- Find receptor residues within 6 Å of any ligand, excluding Gly/Ala (mutagenesis focus):
((n.t r and not r.t GLY,ALA) in n.c rec) w 6A of n.c lig - Identify water molecules within 4 Å of any ligand (displaceable waters):
n.c wat w 4A of n.c lig - Select potential salt-bridge partners: Positive residues within 3 Å of negative residues:
r.c positive w 3A of r.c negative - Extract ligand heavy atoms (non-hydrogen) for contact analysis:
(n.t a in n.c lig) and not a.s H - Find side chains containing sulfur atoms within 3 Å of ligand (e.g. Cys/Met contacts):
(n.t sc having a.s S) w 3A of n.c lig
Understanding the Syntax
NSL utilizes intuitive keywords for selections:
w XÅ of: Finds nodes withinXangstroms of the specified target.and / or / not: Logical operators to combine conditions.in / out of: Include or exclude specific node categories.a.s,n.t,r.t: Refer to specific atomic, node, or residue types.
For example, the query r.c positive w 3A of r.c negative effectively selects positively charged residues within 3 Å of negatively charged residues, helping modelers quickly identify salt-bridge candidates in protein structures.
Gain an Analytical Edge
These examples represent just a subset of what NSL can achieve. By learning to articulate queries with precision, molecular modelers can delve deeper into structural and biochemical insights, enabling better hypothesis generation and validation. The capability to automate what would take hours to build manually ensures that you can focus your time and resources on interpreting results rather than creating workflows.
To explore more examples and unlock the full potential of NSL, check out the complete documentation here: https://documentation.samson-connect.net/users/latest/nsl/examples/.
SAMSON and all SAMSON Extensions are free for non-commercial use. You can learn more and download SAMSON at https://www.samson-connect.net.