Understanding Structural Group Attributes in SAMSON’s Node Specification Language

For molecular modelers diving into the world of integrative design, efficiently selecting and filtering components within complex structures can be a challenge. SAMSON’s Node Specification Language (NSL) simplifies this task with attributes designed specifically for structural groups. In this post, we’ll explore the key attributes you can leverage in the structuralGroup attribute space to streamline your molecular modeling process.

What are Structural Group Attributes?

Structural group attributes in NSL are properties that allow modelers to match and manipulate structural group nodes in a molecular system. These attributes act as filters, enabling precise selection based on properties such as atom count, charge, visibility, or composition. By understanding these attributes, you can perform efficient queries and operations, saving valuable time during modeling sessions.

Two Types of Attributes

Attributes in the structuralGroup attribute space fall into two categories:

  • Inherited from the general node attribute space: These attributes, such as hasMaterial, visible, and selected, apply universally across all node types in NSL but can also be used for structural groups.
  • Specific to structural groups: These are tailored for structural group nodes and include properties like formalCharge, numberOfAtoms, and numberOfCarbons.

Examples of Structural Group Attributes in Action

Here are a few concrete scenarios where these attributes can make your modeling work more productive:

1. Filtering by Formal Charge

The structuralGroup.formalCharge attribute, with the short name sg.fc, matches structural groups with specific total formal charges. For example:

  • sg.fc 1: Matches structural groups with a formal charge of 1.
  • sg.fc 6:8: Matches those with formal charges between 6 and 8.

Use this attribute to focus on charged species in your system, an essential step for analyzing reactivity or electrostatic interactions.

2. Targeting Atomic Composition

Attributes like numberOfAtoms (sg.nat), numberOfCarbons (sg.nC), and numberOfHydrogens (sg.nH) allow you to filter structural groups based on their atomic make-up. For example:

  • sg.nC < 10: Matches groups with fewer than 10 Carbon atoms.
  • sg.nat 100:200: Matches groups with total atom counts between 100 and 200.

These attributes are especially useful for identifying structural motifs or focusing on molecular fragments of interest.

3. Visibility and Selection Management

The visible (sg.v) and selected attributes offer control over representation and manipulation within SAMSON. For example:

  • sg.v: Matches groups that are currently visible in the interface.
  • not sg.selected: Matches groups that are not selected for editing or analysis.

Managing visibility and selections ensures a clutter-free workspace, enabling focused workflows on key molecular regions.

Why Use Structural Group Attributes?

By taking advantage of these attributes, you can construct efficient queries to navigate and analyze complex molecular systems. For example, you might combine multiple attributes to target structural groups with a specific number of Carbon atoms, a given formal charge, and visibility enabled. This precise filtering makes molecular modeling faster and more intuitive.

Explore More

Ready to integrate structural group attributes into your molecular workflows? Learn more about all available attributes and their applications in the full documentation: Structural Group Attributes Documentation.

Note: SAMSON and all SAMSON Extensions are free for non-commercial use. Get started by downloading SAMSON today at SAMSON-Connect.

Comments are closed.