Making Sense of Molecule Attributes in SAMSON’s Node Specification Language

Molecular modelers often need a flexible and efficient way to filter and analyze molecule properties when designing or inspecting complex molecular systems. SAMSON’s Node Specification Language (NSL) offers a powerful set of tools to accomplish this through the molecule attribute space. This blog post will guide you through understanding and utilizing molecule attributes to streamline your molecular modeling projects.

Why Molecule Attributes Matter

Imagine working on a massive molecular system and needing to quickly select specific molecules with certain characteristics—such as molecules with a specific number of atoms, chains, or residues. This process could be tedious without a robust query framework. Molecule attributes in NSL provide a way to query and filter molecular nodes easily, saving time and improving precision.

Exploring the Key Attributes

The molecule attribute space includes a variety of properties to describe molecules. These attributes can be grouped into three categories:

  • Attributes inherited from the node or structuralGroup attribute spaces.
  • Attributes specific to the molecule attribute space.

Highlights of Molecule-Specific Attributes

Some attributes unique to the molecule space include:

  • numberOfChains (mol.nc): Matches molecules with a specific number of chains. For example:
    • mol.nc < 3: Molecules with fewer than three chains.
    • mol.nc 2:4: Molecules with two to four chains.
  • numberOfResidues (mol.nr): Matches molecules based on residue count. For example:
    • mol.nr > 130: Molecules with more than 130 residues.
    • mol.nr 100:130: Molecules with residue counts between 100 and 130.
  • numberOfSegments (mol.ns): Use this to filter molecules by the number of segments they contain.
    • mol.ns > 2: Molecules with more than two segments.
    • mol.ns 1:3: Molecules with one to three segments.
  • numberOfStructuralGroups (mol.nsg): Matches molecules by the number of structural groups they contain.
    • mol.nsg > 10: Molecules with more than 10 structural groups.
    • mol.nsg 10:12: Molecules with group counts between 10 and 12.

Practical Examples

The NSL provides users with concise notation to quickly query and filter molecular systems. Here are a few practical examples of how to use the attribute space effectively:

  • mol.nC < 10: Select molecules with fewer than 10 carbon atoms.
  • mol.nO 5:10: Find molecules containing between 5 and 10 oxygen atoms.
  • not mol.h: Identify molecules that are not hidden in the current 3D representation.

Boost Your Molecular Modeling Efficiency

By leveraging the molecule attribute space in SAMSON’s NSL, you can significantly enhance your ability to select and analyze specific molecular subsets within expansive systems. Whether you need to focus on visibility, charge distributions, or atomic counts, NSL’s capabilities will make your task easier and faster.

For a complete overview of molecule attributes and usage examples, visit the original documentation page.

SAMSON and all SAMSON Extensions are free for non-commercial use. You can get SAMSON at SAMSON Connect.

Comments are closed.