Exploring Molecule Attributes in SAMSON’s Node Specification Language

Molecular modelers often face challenges in efficiently selecting and analyzing specific molecular data from vast datasets. The Node Specification Language (NSL) within SAMSON offers a powerful solution through its robust set of molecule attributes. In this blog post, we will guide you through how to leverage molecule attributes in NSL to streamline your workflows and retrieve the molecular information you need.

What Are Molecule Attributes?

Molecule attributes in NSL refer to properties defined in the molecule attribute space (short name: mol) that exclusively apply to molecule nodes. These attributes enable users to filter, search, and categorize molecular data according to specific criteria.

Inherited and Specific Attributes

Molecule attributes are composed of both inherited attributes from broader categories (like the node or structuralGroup spaces) and attributes unique to molecules. This enables greater flexibility for complex data interactions.

Examples of Key Attributes

  • molecule.numberOfAtoms (short: mol.nat): Represents the number of atoms in the molecule. For instance, mol.nat < 1000 matches molecules with fewer than 1000 atoms.
  • molecule.numberOfChains (short: mol.nc): Indicates the number of chains in a molecule. Example: mol.nc 2:4 matches molecules with 2 to 4 chains.
  • molecule.partialCharge (short: mol.pc): Refers to the partial charge, e.g., mol.pc > 1.5 filters molecules with a partial charge greater than 1.5.
  • hasMaterial (short: hm): A Boolean value that determines whether a molecule has material, e.g., mol.hm.

Structural Group Attributes

Attributes inherited from the structuralGroup attribute space provide additional insights, such as the number of carbons (nC), hydrogens (nH), and other atomic groupings.

Why Use Molecule Attributes in NSL?

Developing an understanding of molecule attributes can help you efficiently:

  • Search for specific molecules in large datasets.
  • Filter molecules based on certain criteria, such as the number of atoms or segments.
  • Visualize pertinent aspects of molecular structures.

Every Attribute Comes with Practical Examples

Examples provided in the documentation make it easy to apply these attributes without guesswork. For instance:

  • mol.fc > 1: Matches molecules with a formal charge greater than 1.
  • mol.nr 100:120: Matches molecules with residues ranging from 100 to 120.
  • not mol.hidden: Finds molecule nodes that are not hidden.

Learn More

Understanding molecule attributes in SAMSON can help molecular modelers save time and focus on analyzing critical molecular features. The full list of attributes, their short name aliases, and examples are well-detailed in the dedicated documentation page.

Note: SAMSON and all SAMSON Extensions are free for non-commercial use. You can download SAMSON at this link.

Comments are closed.