Molecular modelers often encounter the challenge of keeping track of precise measurements such as distances, bond lengths, angles, and dihedrals within complex structures. If you’re working on large systems, you may find temporary measurements insufficient and overwhelming to manage. This is where SAMSON’s ability to save measurements as labels can help.
The Measure editor in SAMSON is a powerful tool designed specifically for measuring and documenting molecular data effectively. What sets it apart is how these measurements can be saved as labels, ensuring they persist across sessions and are easy to locate, inspect, and customize. Here’s an overview to help you leverage measurement labels effectively:
Saving Your Measurements as Labels
When making measurements, you can save them as labels in the SAMSON document by pressing Enter. Once saved, labels become part of your workspace, allowing for easier management and reuse. Temporary measurements, on the other hand, are ephemeral, displayed only until the next measurement is made.
For example:
- Click on a bond to measure and display its length.
- Click on two atoms to measure the distance between them.
- For angles or torsions, click on three or four atoms respectively.
The saved labels remain visible during your modeling work and can be included in your saved file if you export your structure in one of the SAMSON file formats (.sam or .samx).
Inspecting and Modifying Saved Labels
Once saved, labels provide flexibility and additional insights. By selecting a label and opening the Inspector, you gain access to the atoms or nodes associated with the measurement, providing further measurement details such as projections on planes for atom-atom distance measurements.
Customizing the Appearance of Labels
Saved labels can be customized to suit your preferences by using the Inspector. Here are a few key modifications you can apply:
- Change label font, color, and offset for better visual clarity.
- Modify the colors of distance lines or angle planes using options like “Line color” or “Planes color.”
- Reset colors to defaults by double-clicking associated text or using the
button for text color.
Customizing labels helps save time when focusing on specific measurements within a complex molecular model. Below is a visual example of a customized distance line:

Adjusting Global Preferences
SAMSON also allows you to set global preferences for labels through the Preferences menu. From there, you can:
- Specify default fonts for unsaved labels.
- Adjust the number of decimal places for distances and angles shown in labels.
These features ensure consistent styles for your annotations and improve the readability of your measurements.
Why Save Measurements as Labels?
Using labels not only ensures your measurements are preserved for future reference but also helps streamline your workflow. They reduce redundancy, enhance precision, and improve documentation when collaborating or preparing reports. Whether you’re analyzing a protein-ligand interaction or calculating torsional angles in a complex molecule, saved labels make the process efficient and reliable.
To learn more about measuring and labeling in SAMSON, visit the official documentation page.
SAMSON and all SAMSON Extensions are free for non-commercial use. Learn more and download SAMSON at https://www.samson-connect.net.
