A crowded molecular scene can make a simple question surprisingly hard to answer: which presentation nodes are hidden, visible, selected, or named in a particular way? Instead of relying only on what you can pick out in the view, you can use the presentation attribute space in SAMSON’s Node Specification Language (NSL) to describe the nodes you want to inspect.
The key is to be precise about what you are asking. “Find presentations that are not visible” and “find presentations whose visibility flag is false” are different queries: NSL lists visible and visibilityFlag as separate attributes. The documentation does not define them as interchangeable, so it is useful to query the attribute that matches the question you have.
Start with the presentation namespace
Presentation attributes live in the presentation attribute space, abbreviated pr. This space matches only presentation nodes. That scope matters: it gives your expression a clear target rather than asking about every kind of node in the scene.
For example, pr.v uses the short name for visible. To express the opposite condition, use not pr.v. Similarly, pr.h checks hidden, while not pr.h expresses its negation. These compact expressions can help turn a visual search into a clearly stated condition.
Use names to narrow the search
Presentation nodes inherit the name attribute from the node attribute space. Use pr.n followed by a quoted string to specify a name expression. The reference gives pr.n "A" and pr.n "L*" as examples. Keeping the value in quotes is important when writing a name expression.
A practical way to approach a hard-to-read scene is to narrow your question in stages: first consider the presentation-node scope, then use a name expression if you have a useful label, and finally add the state you want to investigate. This keeps the query focused and makes it easier to notice which part of the expression needs adjustment. Treat the name examples as NSL expressions, rather than assuming that every naming convention in a molecular project behaves the same way.
Selection has two listed attributes
The reference lists both selected and selectionFlag. For presentations, selected has no short name, so write pr.selected or not pr.selected; the page explicitly notes that it does not inherit the short name s. The selectionFlag attribute does have the short name sf, with examples pr.sf and pr.sf false.
Because both attributes appear in the reference, avoid silently substituting one for the other. If your question is about whether a presentation is selected, use the documented selected attribute. If you specifically want to inspect its selection flag, use selectionFlag or sf. Being explicit makes a query easier to read later—and easier to share with a colleague who is trying to reproduce your search.
Keep the visibility checks distinct
Visibility follows the same pattern. The presentation attribute list includes visible (short name v) and visibilityFlag (short name vf). Examples include pr.v, not pr.v, pr.vf, and pr.vf false. The page also lists hidden separately, with pr.h and not pr.h.
When debugging a display-related question, try the exact attribute that describes what you want to check instead of treating these names as synonyms. That small habit avoids ambiguity in both your query and your notes. You can also keep the expression short while testing, then add a name condition or another attribute once you know which state you need to inspect.
For the full attribute table and inheritance details, see the SAMSON presentation attributes reference.
Note: SAMSON and all SAMSON Extensions are free for non-commercial use. Get SAMSON.
