Understanding Structural Group Attributes in SAMSON

Molecular modeling often comes with the challenge of managing and analyzing complex systems. For users of SAMSON, the integrative platform for molecular design, efficient navigation and querying of molecular data are essential. One tool to address this need is the structural group attribute space in the Node Specification Language (NSL). If you’re looking to refine your workflows or query structural groups more effectively, this guide may help.

What Are Structural Group Attributes?

The structuralGroup attribute space (sg) in NSL aims to work specifically with structural group nodes, providing precise ways to handle attributes linked to these entities. Using this space, you can explore various properties of structural groups such as:

  • Total number of atoms
  • Number of specific atom types (e.g., carbons, hydrogens, etc.)
  • Formal charge or Partial charge
  • And many more…

Accessible Attributes

There are two categories of attributes available for structural groups:

  1. Inherited Attributes
  2. Specific Attributes

1. Inherited Attributes

Attributes inherited from the general node space are useful across various contexts, such as:

  • hidden (h): Whether the structural group is hidden or visible.
  • selected: Check if a structural group is part of a selection.
  • hasMaterial (hm) and ownsMaterial (om): Manage materials associated with nodes.

These attributes help you control and identify structural groups based on visibility, selection status, and material ownership.

2. Specific Attributes

Specific to structuralGroup, these attributes allow more targeted queries:

  • formalCharge (fc): Total formal charge.
  • partialCharge (pc): Total partial charge (expressed as floats).
  • numberOfAtoms (nat): Total number of atoms within the group.
  • numberOfCarbons (nC): Count of carbon atoms.
  • numberOfHydrogens (nH): Count of hydrogen atoms.
  • numberOfOxygens (nO): Count of oxygen atoms.
  • structureID (id): Numeric identifier for structures.

For example, to identify structural groups with between 100 and 200 atoms, you can use the query:

Similarly, to locate structural groups with partial charge greater than 1.5, try:

Building Better Queries

By combining these attributes, complex queries can be designed to target very specific subsets of structural groups. Here are two actionable examples:

  • Querying for Energy-Relevant Data: Identify all structural groups with formal charges exceeding 1 and hydrogens between 5 and 10:
  • Visibility Management: Filter visible structural groups that are not hidden:

Through logical operators, you can refine outputs, simplifying the navigation of large and detailed molecular datasets.

Why It Matters

Understanding and fully utilizing the structural group attribute space in SAMSON not only saves time but also ensures accuracy in molecular analysis. Whether you’re conducting research, running simulations, or preparing visual representations, using structured queries can streamline operations immensely.

For a more detailed overview of sg attributes, visit the official documentation page here.

SAMSON and all SAMSON Extensions are free for non-commercial use. You can get SAMSON at https://www.samson-connect.net.

Comments are closed.