Molecular modelers often face challenges when analyzing and manipulating complex structures. One such challenge lies in efficiently querying and filtering specific structural properties within molecular backbones. For users of the SAMSON molecular design platform, leveraging the backbone attribute space in the Node Specification Language (NSL) can simplify this task and save valuable time.
The backbone attribute space (short name: s) focuses solely on backbone nodes and provides access to a wide range of attributes inherited from both the node and structuralGroup attribute spaces. With these attributes, users can define queries to filter nodes based on properties such as visibility, composition, charge, and more.
Key Backbone Attributes and How to Use Them
Here are some of the most useful attributes in the backbone attribute space:
- Visibility: Whether a backbone node is visible can be checked using the
visible (bb.v)attribute. For instance, to query backbone nodes that are not visible, you can usenot bb.v. - Composition: Several attributes allow users to query the composition of backbone nodes, such as:
numberOfCarbons (bb.nC): Check the number of carbon atoms (e.g.,bb.nC < 10).numberOfHydrogens (bb.nH): Filter based on hydrogen count (e.g.,bb.nH 10:20).numberOfNitrogens (bb.nN): Target backbones with specific nitrogen counts.numberOfAtoms (bb.nat): Filter based on the total number of atoms (e.g.,bb.nat < 1000).
- Charge: The
formalCharge (bb.fc)andpartialCharge (bb.pc)attributes are used to filter backbones based on integer and float charge values, respectively. For example,bb.fc > 1targets backbone nodes with a formal charge greater than 1. - Material Ownership: Use attributes like
hasMaterial (bb.hm)andownsMaterial (bb.om)to check whether the backbone node possesses or owns material, with valuestrueorfalse.
Examples of Backbone Queries
The following examples demonstrate how to construct useful queries in SAMSON:
| Purpose | Query |
|---|---|
| Select visible backbone nodes | bb.v |
| Select backbones with more than 5 carbon atoms | bb.nC > 5 |
| Select backbones with partial charge between 1.5 and 2.0 | bb.pc 1.5:2.0 |
| Focus on backbones with fewer than 20 hydrogen atoms | bb.nH < 20 |
Benefits of Using Backbone Attributes
Mastering the backbone attribute space allows modelers to:
- Quickly focus on specific structural components of interest.
- Filter and process molecular data more efficiently.
- Create reproducible workflows for molecular design and analysis.
Whether you are investigating material properties, refining molecular structures, or conducting in-depth analyses, these attributes can significantly enhance your efficiency. For a detailed breakdown of each attribute and its use, we encourage you to explore the original documentation page.
SAMSON and all SAMSON Extensions are free for non-commercial use. Get SAMSON at https://www.samson-connect.net.
