Molecular modelers often struggle with keeping track of precise measurements during complex simulations and manipulations. Whether it’s measuring bond lengths, angles, or dihedrals, documenting and visualizing these metrics efficiently can make a significant difference in productivity and clarity. That’s where SAMSON’s measurement labels come to the rescue.
The Challenge: Temporary vs. Saved Measurements
When working with molecular structures in SAMSON, you can use the Measure editor to quickly display measurements. Temporary measurements, such as distances or angles, are accessible as you work. However, they disappear as soon as new measurements are made. This can be limiting if you need to compare multiple measurements simultaneously or save crucial data for later reference.
To overcome this limitation, SAMSON allows you to save measurements as labels within your documents. Labels persist across measurements, zoom levels, and even across sessions if the document is saved in one of SAMSON’s file formats (.sam or .samx).
Saving and Managing Measurement Labels
Here’s how you can transform measurements into saved labels:
- Activate the Measure editor (
) from the viewport or via the Ctrl/Cmd + M shortcut. - Perform your measurement. For example, click on two atoms to measure the distance between them, or on three atoms to measure an angle.
- Once the measurement is displayed, press Enter to save it as a label. This label will now be added to your document and can be modified or customized later.

Advantages of Labels
Labels in SAMSON are more than simple text annotations. They are linked to the atoms involved in the measurement, enabling dynamic updates as the molecular structure changes. Whether you move atoms or perform energy minimizations, the labels remain accurate and relevant.
If you want to examine specific labeled atoms, you can select a label, open the Inspector, and access details such as atom-atom distance projections on planes. This enhanced functionality brings clarity and precision to your modeling workflow.

Customization: Adapting Labels to Your Needs
Labels go beyond static information. You can tailor their appearance for better clarity and presentation:
- Change colors: Modify line colors, angle planes, or torsion representations using the Inspector to distinguish multiple measurements or highlight key metrics.
- Customize text format: Adjust font, size, and text color to ensure labels blend seamlessly with your molecular visualization or stand out when needed.
- Reset to default: Quickly revert any customizations via a double-click or by clicking the
button in the Inspector.


Keeping It Smooth: Automatic Updates
Saved labels aren’t just static markers—they update in real time whenever atoms or charges change. Whether you’re moving atoms manually, performing interactive minimizations, or using other editing tools, you can trust that your measurements remain accurate. This feature is especially valuable for researchers monitoring how structural changes impact molecular parameters.

Conclusion
Transforming your molecular measurements into saved labels in SAMSON not only enhances workflow efficiency but also provides you with a dynamic, customizable, and professional way of managing critical data. To learn more about measurements and labels in SAMSON, visit the official documentation. It’s time to bring clarity and structure to your molecular modeling process.
Note: SAMSON and all SAMSON Extensions are free for non-commercial use. You can download SAMSON from SAMSON Connect.
