Mastering Structural Group Attributes in SAMSON: A Guide for Molecular Modelers

For molecular modelers, understanding and managing complex molecular structures is a critical part of the job. The Structural Group attribute space in SAMSON’s Node Specification Language (NSL) provides a powerful way to fine-tune your selections and analyze molecular groups more effectively. This blog breaks down the key attributes of the structuralGroup attribute space and explains how they can be used in practical scenarios to save time and streamline your modeling workflow.

What are Structural Group Attributes?

Structural group attributes pertain to the structuralGroup Node Specification Language (NSL) attribute space, specifically designed to handle structural groups in SAMSON. Attributes like numberOfAtoms, visibilityFlag, and partialCharge allow you to retrieve, filter, and analyze the properties of structural groups within larger molecular models. Attributes can handle data such as integers, booleans, strings, and floats, giving you great flexibility to define the exact criteria you’re looking for in a molecule’s structural group.

Practical Use

Here’s how some of these attributes can make your job as a molecular modeler easier:

  • Number of Atoms: The attribute sg.nat lets you filter structural groups based on their number of atoms. For instance, sg.nat > 100 finds all structural groups with more than 100 atoms. If you’re investigating high-molecular-weight compounds, this attribute is indispensable.
  • Number of Specific Atoms: If you need to find structural groups rich in specific elements like oxygen or hydrogen, use attributes like sg.nO for oxygen or sg.nH for hydrogen. This can be helpful for analyzing functional groups in macromolecules.
  • Visibility and Selection Flags: By using sg.vf (visibility flag) or sg.selected, you can fine-tune which parts of a structure are displayed or highlight specific regions for modification. For example, not sg.vf will return invisible structural groups.
  • Formal and Partial Charge: Attributes such as sg.fc (formal charge) and sg.pc (partial charge) allow you to filter structural groups by their charge. This is useful for conducting electrostatic analyses or examining charged subgroups, such as ions.

Examples to Get You Started

Let’s consider some practical query examples to show how these attributes work in SAMSON:

  • sg.nat 100:200: Matches structural groups with the number of atoms between 100 and 200.
  • sg.nO < 10: Matches all structural groups containing fewer than 10 oxygen atoms.
  • sg.pc 1.5:2.0: Retrieves structural groups with a partial charge between 1.5 and 2.0.
  • sg.vf: Filters groups that are currently visible within the model, making it easy to isolate regions for visualization.

Why Use These Attributes?

The structuralGroup attributes are not just complex in name—they’re powerful analytical tools for anyone looking to model complex molecular systems effectively. By combining these attributes with other NSL functionalities, you can ensure precision in your queries, streamline interpretations, and ultimately save time in your research or design workflow.

If you want a deeper dive into definitions and additional examples, check out the full documentation page here.

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

Comments are closed.