For molecular modelers, organizing and analyzing complex molecular structures can be a significant challenge. SAMSON’s Node Specification Language (NSL) offers a powerful solution with its structuralGroup attribute space, designed to precisely control and analyze structural groups in your molecular models. But how do you get started? Let’s break this down step-by-step.
What Are Structural Group Attributes?
Structural group attributes in NSL allow molecular modelers to filter, modify, and interpret structural group nodes efficiently. The structuralGroup attribute space is tailored specifically for structural group nodes and includes both inherited attributes and attributes unique to this space.
For example, inherited attributes let you interact with general properties such as visibility or selected state. On the other hand, unique attributes such as formalCharge or numberOfAtoms enable more specialized exploration. These fine-tuned controls can address diverse modeling needs, making your molecular modeling more effective and precise.
How to Use Structural Group Attributes
The structural group attribute space (short form: sg) gives you easy-to-use commands to target specific molecular structures. Let’s go over some key attributes and their application:
1. Working with Formal Charges (sg.fc)
Formal charges are crucial for understanding molecular interactions. The formalCharge attribute matches structural groups with specific formal charges. Example usage:
sg.fc 1: Matches groups with a formal charge of 1.sg.fc 6:8: Matches groups with a formal charge ranging from 6 to 8.
This can help you identify areas of high or low charge density in your models.
2. Filtering by Atom Counts (sg.nat)
The numberOfAtoms (sg.nat) attribute lets you quickly locate structural groups based on the number of atoms they contain. Example:
sg.nat > 100: Matches all structural groups with more than 100 atoms.sg.nat 100:200: Matches groups with atom counts between 100 and 200.
Use this to focus on large or small cluster details, depending on your research needs.
3. Narrowing Down Specific Elements
SAMSON goes further by enabling selection of specific atom types like carbon, hydrogen, oxygen, sulfur, and more, using attributes such as numberOfCarbons (sg.nC) or numberOfHydrogens (sg.nH):
sg.nC 10:20: Matches groups with 10 to 20 carbon atoms.sg.nH < 10: Filters groups with fewer than 10 hydrogen atoms.
This specificity is particularly helpful when studying functional groups or reaction mechanisms.
4. Tracking Structural Role: Visibility and Selection Flags
Inherited attributes such as visibilityFlag (sg.vf) and selectionFlag (sg.sf) allow you to manage and track visible or selected structural groups within your model. For example:
sg.vf false: Matches invisible structural groups.sg.selected: Matches groups that are currently selected.
With these controls, you can declutter your working environment and focus on specific regions of interest.
From Theory to Practice: Example Queries
The queries you create with NSL can be as simple or as complex as needed. Here’s a quick scenario:
- Task: Identify the structural groups that are visible and contain more than 50 carbon atoms.
- Query:
sg.v and sg.nC > 50.
With such queries, you can instantly gain actionable insights into your molecular structures!
Explore More
SAMSON’s Node Specification Language (NSL) opens up a world of possibilities for molecular modelers. To dive deeper into structural group attributes and their applications, visit the official documentation page.
Note: SAMSON and all SAMSON Extensions are free for non-commercial use. Download SAMSON at SAMSON Connect.