For molecular modelers, one of the most common pains encountered when building molecular systems is ensuring correct fragment orientation and avoiding errors in substitutions. Misaligned fragments or implausible substitutions can disrupt workflows and introduce inaccuracies, especially when assembling complex molecules. Luckily, SAMSON’s builder includes smart features to help you predict orientations, prevent errors, and accelerate your modeling tasks.
Effortless Fragment Assembly
Whether you’re building molecules out of atoms or assembling them from pre-existing fragments, SAMSON simplifies workflows with its predictive fragment orientation capabilities. By default, the builder tries to position fragments so that they don’t overlap with existing atoms. This is particularly useful when performing substitutions or when attempting to smoothly integrate new fragments into an already detailed molecule.
How It Works
- When adding a fragment, SAMSON automatically positions it by analyzing the spatial configuration of neighboring atoms and calculating plausible orientations.
- Fragments are displayed with overlays to clearly indicate permissible and impermissible actions: green indicates valid placements, while red suggests forbidden orientations or risky overlaps.
- SAMSON automatically adjusts hydrogens when fragments are added to avoid steric clashes.
Below is an example where the fragment orientation and substitutions are managed seamlessly:

In instances where you’d like to override these predictions, SAMSON allows you to customize orientation in the Preferences panel.
Merge Overlapping Atoms and Control Plausible Substitutions
Beyond orientation, SAMSON provides built-in tools to enhance accuracy during the assembly process. For instance:
- When connecting a fragment close to overlapping atoms, the builder enables automatic merging so that new atoms are seamlessly combined with existing ones.
- The builder highlights acceptable additions or substitutions with green overlays, while forbidden choices appear in red, ensuring you avoid implausible structural configurations.
You can easily switch on or disable these features under Preferences > Editors > Add.
Fine Control with Substitution Atom Selection
During fragment substitution, SAMSON allows you to manually select the substitution atom. By pressing and holding the Shift key while adding a fragment, you can choose which atom or bond in the current fragment will replace the atom or bond you click on in the document.
This hands-on control empowers experts to achieve highly specific configurations tailored to their project goals, as shown here:

Customizing Preferences for Your Needs
All these features are customizable through the Preferences settings in SAMSON. For example, you can:
- Enable or disable hydrogen adjustments.
- Allow or prevent automatic merging of neighboring atoms.
- Control randomized orientations for standalone fragments.
- Set preferences for avoiding unexpected substitutions.
This flexibility ensures the SAMSON builder adapts to your unique modeling style while maintaining control and precision.
Why It Matters
Correct fragment orientation and substitution management are critical in molecular modeling tasks, whether you’re exploring new molecule designs or simulating biochemical interactions. SAMSON equips users with intuitive tools to streamline this process, reducing manual errors and improving overall modeling efficiency.
To explore these fragment orientation features and more, visit the full documentation at SAMSON Building Molecules Documentation.
Note: SAMSON and all SAMSON Extensions are free for non-commercial use. Get started by downloading SAMSON at SAMSON Connect.
