A Guide to Note Attributes for Molecular Modelers

When dealing with molecular modeling, managing data within complex systems effectively is essential for achieving streamlined workflows. One often-overlooked yet incredibly powerful feature of the SAMSON platform is the use of note attributes in the Node Specification Language (NSL). This blog post explores note attributes and how you can use them to enhance your workflow.

What Are Note Attributes?

Note attributes belong to the note attribute space (short name: nt) and are specifically designed for handling note nodes in SAMSON. These attributes are inherited from the more general node attribute space but are specialized to work exclusively with note nodes.

For molecular modelers, note attributes are quite handy to manage additional information about regions of interest in a molecular model. Let’s take a look at some key attributes and their application:

Key Attributes and Their Uses

Attribute Name	Short Name	Possible Values	Examples
hidden	`h`	`true`, `false`	`nt.h` (find hidden notes) `not nt.h` (find visible notes)
name	`n`	strings in quotes	`nt.n "A"` (notes named ‘A’) `nt.n "L*"` (notes starting with ‘L’)
selected	N/A	`true`, `false`	`nt.selected` (selected notes) `not nt.selected` (unselected notes)
selectionFlag	`sf`	`true`, `false`	`nt.sf false` (notes where selectionFlag is false) `nt.sf` (notes with selectionFlag true)

Efficiency in Molecular Modeling

Here’s a practical example: imagine you are focusing on molecular annotations, tagging specific atoms, residues, or functional groups to track key insights during an analysis. By using note attributes such as hidden or name, you can define filters to hide irrelevant notes and keep only the ones matching your naming schema—for example, filtering notes like “Lipid A-F” specifically.

Note attributes provide flexibility to combine filters for robust queries. Want to isolate all visible notes named “DNA” while excluding anything flagged for selection? The combination of nt.v and nt.n "DNA" makes this seamless.

Take Your Work Further

Mastering note attributes empowers you to structure and manage molecular modeling projects with greater efficiency. Whether you’re working on annotations, filtering critical components, or simplifying your visual workspace, this tool provides a fine degree of control.

Explore all note attributes and see how they can enhance your modeling workflows in depth by visiting the documentation page. Learning how to use these features fully could be the key to solving recurring challenges in organizing information about molecular systems.

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