Streamlining Molecular Modeling with SAMSON’s Molecule Attributes

Molecular modeling often involves filtering and categorizing molecules based on specific properties. This task can be both time-consuming and tedious without the right tools. Fortunately, SAMSON’s Node Specification Language (NSL) simplifies this challenge by introducing a set of molecule-specific attributes that streamline the process of defining and querying molecular properties.

What Are Molecule Attributes in SAMSON?

The molecule attribute space in SAMSON’s NSL is designed to match only molecule nodes, equipping modelers with a robust system for defining property-based queries. Attributes in this space come with short names, defined value types, and intuitive usage patterns, making it easy to perform complex queries efficiently. For instance, you can verify or filter molecules by their visibility, number of atoms, chains, residues, and much more.

Exploring Some Key Attributes

Below is an overview of some common molecule attributes and how they can aid your molecular modeling workflow:

1. Visibility and Selection Attributes

  • visible (v): Checks whether a molecule is visible. Example: mol.v matches visible molecules, while not mol.v targets hidden ones.
  • selected: Queries whether a molecule is selected. Example: mol.selected.

2. Structural Attributes

  • numberOfAtoms (nat): Matches molecules based on their number of atoms, which is provided as an integer range or comparison. Examples:
    • mol.nat < 1000: Finds molecules with fewer than 1000 atoms.
    • mol.nat 100:200: Finds molecules with atom counts between 100 and 200.
  • numberOfResidues (nr): Focuses on molecules by their residue count. Examples:
    • mol.nr > 130: Matches molecules with more than 130 residues.
    • mol.nr 100:130: Targets molecules whose residue count is between 100 and 130.

3. Advanced Attributes

You can perform even more specific queries, such as:

  • numberOfHydrogens (nH): Specifies molecules based on the number of hydrogen atoms. Example: mol.nH 10:20.
  • partialCharge (pc): Filters molecules with a specific partial charge. Example: mol.pc > 1.5.
  • numberOfChains (nc): Matches molecules with given chain counts, such as: mol.nc 2:4.

Why Use Molecule Attributes?

Molecular modelers often need to conduct repetitive filtering tasks when analyzing simulations and structures. By leveraging NSL’s molecule-specific attributes, you can automate these tasks and save time. For example, you can instantly assemble a list of all molecules in your project that meet specific requirements for their number of atoms, visibility, or any other property.

Moreover, combining these attributes enables complex queries. For example, to find molecules that have more than 10 chains and are currently visible, you can combine the relevant attributes: mol.nc > 10 and mol.v. This flexibility offers immense power to researchers working with large datasets or intricate molecular systems.

Learn More

To explore the full scope of molecule attributes in SAMSON, including examples, short names, and possible values, refer to the official documentation page: Molecule Attributes in SAMSON.

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

Comments are closed.