Molecular projects can accumulate notes alongside structures, measurements, and other nodes. When you need to inspect or work with notes specifically, a broad selection can bring in unrelated items—or leave you unsure which attributes apply. SAMSON’s Node Specification Language (NSL) provides a way to scope expressions to note nodes and check properties such as their names, visibility, and selection state.
Start by narrowing the target
The note attribute space has the short name nt, and it matches only note nodes. That makes nt a useful starting point when your task concerns notes rather than nodes in general. The attribute space includes inherited node attributes, so you can use it to refer to a note’s name, whether it is selected, and visibility-related properties.
For example, the documented expressions nt.n "A" and nt.n "L*" show how to refer to a note by name. Names are written as strings in quotes. If you are checking or building an expression, keep the nt prefix in place: it makes the intended node type explicit.
Visibility and hidden state: check the attribute you mean
The note reference lists both hidden (short name h) and visible (short name v). Examples include nt.h, not nt.h, nt.v, and not nt.v. These are separate attributes in the reference, so when troubleshooting a note that is not appearing as expected, check the specific property relevant to your question rather than assuming one label is a substitute for the other.
The same practical care applies to selection. The page lists selected and selectionFlag as distinct attributes. For notes, selected has no short name; the documented examples are nt.selected and not nt.selected. selectionFlag uses the short name sf, with examples nt.sf and nt.sf false. If you are unsure which one fits your task, consult the linked node attribute description instead of treating the two names as interchangeable.
A small checklist for note queries
- Are you targeting notes? Use the
ntattribute space, which the reference says matches only note nodes. - Are you matching a name? Use
nt.nand put the name string in quotes, as innt.n "A". - Are you checking visibility? Choose the attribute you mean:
nt.hforhidden, ornt.vforvisible. - Are you checking selection? Notice whether your expression uses
selectedorselectionFlag; the note reference documents them separately.
These distinctions are especially useful when revisiting a project after time away. Instead of relying on memory about a note’s state, you can inspect the relevant attribute in an NSL expression and keep the query scoped to notes.
For the complete list of note attributes and examples, see the SAMSON note attributes reference.
Note: SAMSON and all SAMSON Extensions are free for non-commercial use. Get SAMSON.
