Molecular modeling often requires working with hierarchical structures where some elements act as groups encompassing others. For those diving into SAMSON’s powerful Node Specification Language (NSL), understanding node group attributes can ease the challenge of selecting and manipulating these groupings in molecular models.
In this post, we’ll explore the key attributes defined in the nodeGroup attribute space (short name: ng) and how these can be utilized to streamline molecular modeling workflows. This will empower you to organize, query, and act on grouped nodes efficiently.
Node Group Attribute Space
The node group attributes in NSL apply specifically to node group nodes, allowing you to interact seamlessly with hierarchical structures. These attributes enable you to target node groups using names, selection states, and flags. Here’s a breakdown of the available attributes:
| Attribute name | Short name | Possible values | Examples |
|---|---|---|---|
| name | n |
strings in quotes | ng.n "A"ng.n "L*" |
| selected | true, false |
ng.selectednot ng.selected |
|
| selectionFlag | sf |
true, false |
ng.sf falseng.sf |
What Makes These Attributes Useful?
The attributes in nodeGroup allow for fine-grained control over node groups:
- Name (
ng.n): You can identify groups by their names. For example,ng.n "L*"selects all node groups with names starting with “L”. This is especially helpful for targeting groups based on naming conventions in a large model. - Selection State (
ng.selected): You can query whether node groups are selected. Usenot ng.selectedto find nodes that are not currently selected. - Selection Flag (
ng.sf): A boolean flag often used to programmatically tag node groups. For instance,ng.sf falsecan help identify untagged groups for subsequent operations.
Inherited Behavior: Efficient Use of NSL
It’s worth noting that the nodeGroup attributes inherit certain behaviors from the general node attribute space. However, specialized use in nodeGroup refines this functionality for grouped nodes.
- Name (
name): While inherited, thenameattribute innodeGroupapplies specifically to group nodes. - Selection and Flags: Similarly,
selectedandselectionFlagwork optimally when scoped to node groups, offering greater precision for complex models.
By utilizing these attributes, you can build intricate queries that enhance the organization and interactivity of your molecular designs.
Conclusion
The ability to target and manipulate node groups is essential for efficient molecular modeling. By mastering the nodeGroup attribute space in SAMSON’s NSL, you can simplify workflows and gain better control over your models. For a detailed explanation of these attributes, along with more examples and deeper insights, visit the original documentation here.
SAMSON and all SAMSON Extensions are free for non-commercial use. You can get SAMSON at https://www.samson-connect.net.