Understanding Molecule Attributes in SAMSON’s Node Specification Language

Molecular modeling often involves specifying and filtering elements in complex systems efficiently. If you’re working in SAMSON, the Node Specification Language (NSL) offers a powerful way to simplify this process. Among its key components is the molecule attribute space, which lets you target and operate on molecule nodes using intuitive expressions.

Whether you are identifying specific molecules in massive datasets or isolating certain characteristics, the molecule attribute space in NSL provides a diverse range of attributes to streamline your workflow. Here, we’ll explore what you can do with molecule attributes and how they can aid your projects.

What Are Molecule Attributes?

The molecule attribute space, abbreviated as mol, is designed specifically for molecule nodes in molecular systems. Each attribute within this space corresponds to a key property of a molecule, allowing you to write simple yet powerful queries. For instance, you can evaluate attributes like numberOfAtoms, numberOfChains, and formalCharge, to name a few.

In addition to molecular-specific attributes, the molecule space inherits key attributes from the node and structuralGroup attribute spaces. This inheritance gives you rich flexibility for defining and filtering molecule properties based on a wide range of parameters.

Practical Examples of Using Molecule Attributes

Here are some simple use cases to demonstrate how molecule attributes can help:

  • Example 1: Filtering molecules by the number of atoms
    Suppose you want to select molecules with fewer than 1,000 atoms. You can use the attribute mol.nat for numberOfAtoms, like so:
    mol.nat < 1000
  • Example 2: Matching molecules with a formal charge
    To find molecules with a formal charge between 1 and 3, you can use the attribute mol.fc: mol.fc 1:3
  • Example 3: Checking visibility
    To isolate visible molecules, you can evaluate the mol.v (visible) attribute:
    mol.v. Or, to filter hidden molecules:
    not mol.v.

Specific Highlights from Molecular Attributes

Here are some attributes specific to the molecule space that you may find particularly useful:

  • numberOfChains (mol.nc): Matches molecules based on the number of chains they contain. For example, use mol.nc 2:4 to select molecules with 2 to 4 chains.
  • numberOfResidues (mol.nr): Identifies molecules based on the number of residues present. For instance, mol.nr > 100 selects molecules with more than 100 residues.
  • numberOfStructuralGroups (mol.nsg): Targets systems with the specified number of structural groups. Example: mol.nsg > 10.

Why Use These Attributes?

By leveraging molecule attributes, you can automate tedious filtering processes, focus on specific molecular systems, and gain better control over massive datasets. This is especially crucial for modeling tasks where precision and efficiency significantly impact the results.

Learn More

To dive deeper into the full set of molecule attributes and examples, you can visit the official documentation at https://documentation.samson-connect.net/users/latest/nsl/molecule/. There, you’ll find detailed explanations, examples, and related references to help you make the most of NSL.

*Note: SAMSON and all SAMSON Extensions are free for non-commercial use. Download SAMSON today at samson-connect.net.

Comments are closed.