For molecular modelers, managing the visibility and properties of labels on molecular nodes can be a tedious task, especially when dealing with complex structures. SAMSON’s Label Attributes feature offers a practical and efficient solution to streamline this process. By leveraging the label attribute space, you can gain better control and clarity over your label nodes, making your workflows much smoother.
What Are Label Attributes?
Label attributes are a specific subset of attributes within SAMSON’s Node Specification Language (NSL). They fall under the label attribute space (shortened to la), which matches exclusively with label nodes. Using these attributes, you can define specific behaviors or states for your labels, enabling you to customize and organize your molecular visualization as needed.
Key Label Attributes to Know
Here’s a deeper dive into the most important label attributes you’ll find useful:
- hidden (
h): Control whether a label is displayed or not. Set this totrueto hide a label orfalseto make it visible. Example:la.h,not la.h. - name (
n): Assign or filter label nodes by name. Names are expressed as strings in quotes. Example:la.n "A",la.n "L*". - selected: Test whether a label node is selected. Example:
la.selected,not la.selected. - selectionFlag (
sf): Define a selection-associated flag for a label node. Example usage:la.sf false,la.sf. - visibilityFlag (
vf): Manage visibility-related flags. Examples includela.vf falseandla.vf. - visible (
v): Test for label visibility directly. Example:la.v,not la.v.
The table below summarizes these attributes:
Practical Applications
For modeling intricate molecular structures, the ability to quickly manage labels is vital for enhancing visualization and clarity. For instance:
- Focus on specific parts of the model: Use
la.vornot la.vto isolate visible labels relevant to a current analysis task. - Efficiently annotate datasets: Assign intuitive names to label nodes using the
nameattribute for easy filtering. - Hide unnecessary clutter: Temporarily disable visibility or use
hiddento manage visual distractions. - Maintain dataset organization: Use selection and visibility flags (
sf,vf) to categorize and toggle subsets of labels.
Learn More
This is just a glimpse into the potential of label attributes in SAMSON. To explore more and find detailed examples, visit the full documentation page at https://documentation.samson-connect.net/users/latest/nsl/label/.
SAMSON and all SAMSON Extensions are free for non-commercial use. Start designing your molecular models by downloading SAMSON here: https://www.samson-connect.net.
