For molecular modelers working with complex structures, manipulating groups of atoms with precision is essential. A common challenge in this domain is how to visually and computationally undock structural nodes or meshes without spending excessive time on manual repositioning. SAMSON’s Undock animation provides an elegant, automated solution to this problem. Let’s explore how it works and how you can use it in your molecular modeling projects.
What is the Undock Animation?
The Undock animation in SAMSON allows users to “undock” groups of atoms or meshes from their current positions, considered docked positions, and automatically computes their final positions away from these docked states. This tool is not just a timesaver—it ensures consistent and accurate repositioning, removing guesswork and manual adjustments.
For example, let’s say you have docked ligand molecules within a receptor and now need to visualize them leaving their binding pockets. The Undock animation handles this process seamlessly.
How to Apply the Undock Animation
Adding the Undock animation requires just a few straightforward steps:
- Select your nodes: Choose at least two structural nodes or meshes in your document. The first node acts as the static receptor, while the other nodes will be animated. If multiple nodes should act as the receptor, you can create a folder, move all receptor nodes to that folder, and select the folder as the first node.
- Double-click: Navigate to the Animation panel in SAMSON’s Animator and double-click on the Undock animation effect.
If no nodes are selected, SAMSON automatically guesses the nodes to apply the undocking process to, simplifying the workflow further.
Once added, the animation will take place between two keyframes. You can move these keyframes along the Animator timeline to adjust the duration of the animation. SAMSON automatically calculates the amplitude of the undocking motion, but you can fine-tune it by inspecting the animation properties.
Exploring Parameters
SAMSON’s Animator offers robust customization options:
- Amplitude: Adjust the magnitude of the undocking movement using the Inspector.
- Easing curve: Modify how the animation progresses over time by altering its Easing curve. This parameter influences interpolation between frames.
These flexible options ensure that your animations match both the scientific accuracy and the visual presentation standards you require.
Example Visualization
Here is a visual example of how the Undock animation works in SAMSON:

In this example, groups of atoms or meshes move away from their docked positions in a smooth, visually coherent manner. Such presentations are especially valuable in molecular dynamics visualizations or when presenting molecular mechanisms in research or teaching.
Why Molecular Modelers Love This Tool
Traditional methods of undocking atoms involve tedious manual adjustments or developing custom scripts. SAMSON’s Undock animation automates this workflow, saving time while ensuring reproducible and visually impressive results. Whether you’re creating animations for a publication, a lecture, or theoretical studies, this tool simplifies your tasks and enhances clarity in molecular modeling.
To learn more about how to use the Undock animation, visit the official documentation here: Undock Animation Documentation.
Note: SAMSON and all SAMSON Extensions are free for non-commercial use. You can download SAMSON at SAMSON Connect.
