Understanding Backbone Attributes in SAMSON: A Molecular Modeler’s Guide

Molecular modelers who work with structural analysis often face challenges in simplifying the selection and visualization of specific molecular features. Leveraging backbone attributes in SAMSON’s Node Specification Language (NSL) can ease these tasks significantly. In this guide, we explore how backbone attributes help you query and manipulate molecular structures efficiently.

What Are Backbone Attributes?

Backbone attributes in SAMSON belong to the backbone attribute space, short-named s, which specifically targets nodes representing molecular backbones. These attributes allow users to query properties like atom counts, element presence, visibility, and more. They extend their functionality by inheriting attributes from other spaces like node and structuralGroup, enabling a versatile toolkit for molecular manipulation.

Features of Backbone Attributes

The key is understanding the types of attributes available and how to use them effectively. Here’s a snapshot of backbone attributes based on either their parent space or their unique functionalities:

Attributes from the node Space

  • Visibility and Hiding: For toggling molecular visibility with visible (v) and hidden (h).
  • Material Queries: Use hasMaterial (hm) and ownsMaterial (om).
  • Selection Flags: Manage node selections with selectionFlag (sf), selected, or selection visibilityFlag (vf).

Attributes from the structuralGroup Space

  • Element Counts: Quickly identify counts of specific atoms using attributes like numberOfCarbons (nC), numberOfHydrogens (nH), or even numberOfSulfurs (nS).
  • Charge Measurements: Include properties for formalCharge (fc) and partialCharge (pc).
  • Coarse Grained Details: Access higher-level molecular representations using numberOfCoarseGrainedAtoms (ncga).

Examples of Queries

Leveraging these attributes allows for specific and efficient querying. Below are a few helpful examples:

  • bb.hm: Checks whether a backbone has material.
  • bb.nC < 10: Filters backbones with fewer than ten carbon atoms.
  • bb.fc > 1: Finds backbones with a formal charge greater than one.
  • not bb.v: Identifies backbones that are not currently visible.

Why Use Backbone Attributes?

The ability to target and query specific molecular properties reduces time spent manually sorting through complex structures. For example, filtering hidden nodes or locating structural groups with certain element distributions becomes straightforward. As a molecular modeler, backbone attributes empower you to manage your molecular data with precision and flexibility.

To dive deeper into backbone attributes, explore the official documentation page at https://documentation.samson-connect.net/users/latest/nsl/backbone/.

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

Comments are closed.