Understanding Attributes for Structural Models in SAMSON

Molecular modelers often need to query and manipulate specific properties of structural models for various applications such as drug development, protein-ligand interactions, and material simulations. In SAMSON, the integrative molecular design platform, structural model attributes provide a powerful way to interact with and analyze molecular structures. This blog post will introduce you to these attributes, focusing on their definitions and practical use cases, so that you can integrate them seamlessly into your workflows.

What Are Structural Model Attributes?

Structural model attributes belong to the structuralModel attribute space (short name: sm). These attributes allow you to interact specifically with structural model nodes. They fall into two categories:

  • Attributes inherited from the node attribute space (e.g., hidden, visible, etc.).
  • Attributes specific to the structuralModel space (e.g., sm.nat, sm.pc, and more).

Practical Use Cases

Below, we explore how some commonly used structural model attributes can help molecular modelers:

1. Filtering by Number of Atoms

The structuralModel.numberOfAtoms attribute (sm.nat) helps you find models with a specific number of atoms. For example:

  • sm.nat < 100: Matches structural models with fewer than 100 atoms.
  • sm.nat 100:200: Matches models with an atom count between 100 and 200.

Why is this helpful? When working with large molecular systems, you might want to limit your analysis to systems with a manageable number of atoms, especially for computational efficiency.

2. Querying Specific Elements or Chemical Traits

Attributes such as numberOfCarbons (sm.nC) and numberOfHydrogens (sm.nH) make it easier to target molecular subsets based on their elemental composition.

  • sm.nC < 10: Useful for detecting small organic molecules with fewer than 10 carbon atoms.
  • sm.nH > 20: Maybe you’re hunting for molecules with a high number of hydrogens for specific hydrogen-based interaction studies.

This type of filtering allows you to tailor your research based on chemical properties rather than relying on vague structural assumptions.

3. Detecting Segmental and Chain Information

The numberOfChains (sm.nc) and numberOfSegments (sm.ns) attributes enable the identification of structural models containing specific numbers of chains or segments.

  • sm.nc < 3: Finds models with fewer than three chains—ideal for simpler systems like dimers or small multimers.
  • sm.ns 2:4: Targets structural models containing between 2 and 4 distinct segments.

These attributes can be particularly useful when analyzing large biomolecular assemblies, such as proteins or macromolecular complexes.

4. Understanding Charges

The formalCharge (sm.fc) and partialCharge (sm.pc) attributes provide access to charge-related properties:

  • sm.fc 1: Matches systems with a formal charge of 1.
  • sm.pc 1.5:2.0: Identifies systems with partial charges in the 1.5 to 2.0 range.

Such queries are invaluable for electrostatics-based studies or when analyzing charge-dependent docking processes.

How to Use Structural Model Attributes in Practice

Using these attributes in SAMSON allows molecular modelers to quickly create precise filters and extract insights from complex structural models. For example, you might chain multiple attributes together to form advanced queries:

The above command filters structural models with more than 150 atoms and a partial charge greater than 1.0.

Where to Learn More

Structural Model attributes significantly enhance SAMSON’s analysis capabilities for molecular modeling. You can explore all the attributes in detail at the official documentation page.

SAMSON and all SAMSON Extensions are free for non-commercial use. You can download SAMSON from here.

Comments are closed.