Mastering Label Visibility Attributes in SAMSON

Visualization is critical when working on molecular modeling. Cluttered or unclear views can impede analysis, making it harder to explore and manipulate structures effectively. One handy solution within SAMSON’s Node Specification Language (NSL) is its label visibility attributes. These attributes allow modelers fine-grained control over the visibility and selection of label nodes. In this blog post, we’ll explain how to better manage label visibility using these attributes.

What are Label Attributes?

In SAMSON, label attributes belong to the label attribute space, identified with the shorthand la. These attributes help manage label nodes’ visibility and selection flags. Here’s an overview of some key label attributes you can employ:

hidden (la.h): Determines whether a label node is hidden. Can be set to true or false.
visible (la.v): Indicates if a label node is visible. Accepts true or false.
visibilityFlag (la.vf): Functions as a toggle for visibility, with values true and false.

The Power of Label Control

The interplay between hidden, visible, and visibilityFlag provides incredible flexibility for visibility management. For instance:

Hide all labels: Use la.h true to hide specific label nodes and declutter the scene.
Show selective labels: Enable visibility for a specific label node, such as la.v, while keeping others hidden.
Adjust flags: Fine-tune visibility dynamically by modifying the la.vf attribute.

For example, suppose your molecular model has multiple label nodes, and you only want selected ones to appear. By specifying filters like not la.h, you can hide unwanted labels while focusing on relevant nodes. Similarly, toggling la.v false lets you display only the areas of interest.

Application in a Modeling Workflow

During molecular modeling, label attributes become immensely useful when creating publication-ready diagrams or analyzing specific molecular properties:

Declutter 3D Models: Hide unnecessary labels that obscure molecule structures using la.h true.
Highlight Key Features: Emphasize particular nodes by setting la.v true, making them stand out visually.
Dynamic Visualization: Use la.vf to toggle visibility on the fly during presentations or analyses.

Example

Here is an example use case:


// Hide all labels
la.h true

// Show labels with names starting with 'A'
la.n "A*" la.v true

// Hide all labels

la.h true

// Show labels with names starting with 'A'

la.n "A*" la.v true

This example hides all labels and then selectively shows only those starting with the letter ‘A’. Such precise control saves time and avoids information overload in large datasets.

For complete details and additional use cases of label attributes, visit the official documentation page.

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