Understanding Side Chain Attributes in SAMSON’s Node Specification Language

For molecular modelers, efficiently selecting, filtering, or analyzing molecular components is a vital part of their work. SAMSON, an integrative molecular design platform, offers a sophisticated Node Specification Language (NSL) system to streamline this process. One crucial aspect of the NSL is understanding side chain attributes, which help target specific side chain nodes in biomolecular structures. If you’ve ever wished for better ways to manipulate or query side chains of molecules in your project, this post explains how the attributes in SAMSON can make this convenient and effective.

What are Side Chain Attributes?

Side chain attributes allow you to describe and interact with the specific properties of side chain nodes from your molecular structure. They are defined within the sideChain attribute space, often with shorthand names for modeling convenience. These attributes are particularly useful in cases where one needs to group, filter, or adjust molecules with similar physical or chemical properties.

Key Attributes and How to Use Them

Below are the most commonly used side chain attributes:

  • visibilityFlag (short name: vf): Indicates whether the side chain node is set to be visible (true) or not (false). Example expressions: sc.vf, sc.vf false.
  • numberOfAtoms (short name: nat): Specifies the total number of atoms in the side chain. Expressions such as sc.nat > 100 or sc.nat 50:200 enable easy selection based on atom count.
  • numberOfCarbons (short name: nC): Retrieves the count of carbon atoms. For example, you can use sc.nC 10:20 to zero in on side chains with a specific carbon range.
  • hidden (short name: h): Indicates whether the node is hidden (true) or not (false). Manipulate visibility using simple commands like sc.h or not sc.h.
  • name (short name: n): Identifies the side chain by name, working with string queries such as sc.n "L*" to match all names beginning with “L.”

The full list of attributes includes properties like ownsMaterial (om), partialCharge (pc), and various elemental counts (such as numberOfNitrogens (nN)). For exploring combinations of attributes, you can even chain expressions like sc.nC 5:10 and sc.vf—a powerful way to filter objects interactively.

Application: Simplified Molecular Modeling

Imagine you’re analyzing a dataset of biomolecules and need to highlight side chains with fewer than six nitrogen atoms, a specific formal charge, and visibility enabled. The combination of attributes allows you to run a query such as:

This kind of flexibility empowers modelers to focus on specific molecular features and expedite decision-making for critical design tasks.

Where Can You Learn More?

The attributes described here represent just a subset of the tools available in NSL for side chain modeling. To dive deeper into all side chain attributes, and their specific examples, visit the official documentation page on side chain attributes.

The Node Specification Language simplifies molecular modeling tasks by providing a precise language for querying and modifying molecular properties. By utilizing side chain attributes effectively, you can save time and enhance the accuracy of your molecular design projects.

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

Comments are closed.