Understanding Structural Group Attributes in Molecular Modeling

Molecular modelers often face challenges when addressing structured data in their models. Whether you’re trying to locate a specific group within a complex molecular construct or narrowing down subsets of atoms for analysis, structural group attributes in SAMSON’s Node Specification Language (NSL) offer powerful solutions. This guide demystifies these attributes, explaining how they can streamline your molecular modeling tasks.

What Are Structural Group Attributes?

In SAMSON, structuralGroup attributes form part of the NSL. These attributes allow users to filter and identify specific structural groups within their molecular models, based on properties like composition, charge, or visibility.

Structural groups are a central concept when dealing with organized collections of atoms or molecular aggregates. By using the sg (short for structuralGroup) attribute space, users can focus exclusively on these groups.

Inherited vs. Specific Attributes

There are two categories of attributes for structural groups:

  • Inherited Attributes: These come from the broader node attribute space. Examples include:
    • sg.h (hidden): Filters structural groups based on whether they are hidden.
    • sg.v (visible): Matches structural groups based on their visibility.
    • sg.selected: Identifies whether a group is selected.
  • Specific Attributes: These are unique to structural groups and help explore their properties. Some examples are:
    • sg.fc (formalCharge): Matches groups by their formal charge.
    • sg.nat (numberOfAtoms): Filters based on the number of atoms in a group.
    • sg.nC, sg.nH, sg.nO: Attribute-specific filters for different atom types (Carbons, Hydrogens, Oxygens, etc.).
    • sg.pc (partialCharge): Matches groups with particular partial charges.

Common Use Cases

Here are practical examples where structural group attributes can be applied:

  • Selecting Visible Groups:
    sg.v returns all visible groups, while not sg.v excludes invisible groups.
  • Filtering by Atom Count:
    If you want groups with fewer than 500 atoms, use sg.nat < 500. For atoms within a range (e.g., 100 to 200), type sg.nat 100:200.
  • Analyzing Specific Formal Charges:
    To find groups with a formal charge of exactly +1, use sg.fc 1, or to locate groups with charges between 2 and 3, use sg.fc 2:3.

Example: Analyzing Oxygen Content in a Molecular Structure

If you want to identify groups with a certain number of oxygen atoms, you can use the sg.nO attribute:

  • sg.nO < 10: Retrieves groups with fewer than 10 oxygen atoms.
  • sg.nO 8:12: Matches groups with oxygen atom counts between 8 and 12.

Such filters are indispensable for narrowing down molecular substructures, focusing analysis, or preparing data for simulations.

Tips for Power Users

Maximize your productivity with the following tips:

  • Combine attributes logically: Use and, or, and not operators to build advanced queries. Example: sg.v and not sg.h for visible but non-hidden groups.
  • Use ranges effectively: Attributes like sg.nC (number of carbons) or sg.nH (number of hydrogens) support range queries, helping you refine searches efficiently.

For a full list of structural group attributes and their usage, visit the official documentation page.

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

Comments are closed.