Getting Started with Backbone Attributes in Node Specification Language (NSL)

For molecular modelers who aim to delve deeper into the intricacies of molecular structures, understanding how to manipulate and query backbone attributes in SAMSON’s Node Specification Language (NSL) can be an invaluable skill. SAMSON’s NSL provides a powerful yet straightforward way to work with a molecule’s backbone attributes to streamline molecular design workflows.

What Are Backbone Attributes?

The backbone in SAMSON refers to specific molecular features that form the structural foundation of a molecular system. These attributes help modelers define, filter, and manipulate structural characteristics of the backbone through clearly defined properties. This makes it easier to retrieve or modify molecular data relevant to their specific tasks, whether analyzing molecular systems or designing new materials.

In NSL, backbone attributes exist in a defined backbone attribute space, with the short name s. You can access the attributes using simple, intuitive expressions.

Key Backbone Attributes Explained

Let’s go over some useful backbone attributes that can help you specify and query backbones more effectively:

  • visible (v): Indicates whether the backbone is visible (true) or not (false). For example, bb.v checks visibility, while not bb.v checks objects that are hidden.
  • hasMaterial (hm): Identifies whether the backbone contains material (true) or not (false). Use this attribute, for example, to filter only backbones that include material with bb.hm.
  • name (n): Filters backbones based on their names using string searches. For instance, bb.n "A" matches backbones labeled “A,” while bb.n "L*" matches backbones whose names start with “L”.
  • formalCharge (fc): A numerical value indicating the formal charge of the backbone. For example, bb.fc > 1 retrieves backbones with charges greater than 1.
  • numberOfAtoms (nat): Specifies the total number of atoms in the backbone. You can filter large or small backbones with queries like bb.nat < 1000 or bb.nat 100:200.

Using Backbone Attributes Effectively

One significant advantage of NSL is its simplicity in querying and filtering molecular structures. Backbone attributes, especially when combined with Boolean operators and ranges, allow you to express complex queries in a concise form. For instance:

  • bb.h: Returns all hidden backbones.
  • bb.v and bb.hm: Filters for visible backbones that include materials.
  • bb.fc 2:4: Finds backbones with a formal charge falling between 2 and 4.

Beyond just querying, this level of customization ensures that you can effectively separate areas of interest, save computational resources, and speed up your molecular projects.

Practical Examples

Here are some practical use cases:

  • If you want to isolate all backbones with more than 10 carbons and a visibility flag, you can write: bb.nC > 10 and bb.vf.
  • To analyze structures that are named “B*” and contain less than 50 atoms, write: bb.n "B*" and bb.nat < 50.

These examples show how leveraging backbone attributes helps you work smarter rather than harder in molecular modeling. Combining attributes with logical operations enables you to specify intricate conditions with minimal effort.

Learn More

Backbone attributes simplify molecular modeling and provide molecular designers with a versatile toolset. If you are curious and want to explore more use cases or gain a deeper understanding of the NSL backbone attributes, visit SAMSON’s documentation on Backbone Attributes.

SAMSON and all SAMSON Extensions are free for non-commercial use. Download SAMSON at SAMSON Connect.

Comments are closed.