Efficiency is critical in molecular modeling, where researchers often work with complex structures, large datasets, and elaborate workflows. One common challenge is managing these extensive models and files effectively to maintain a clear overview of research progress. Fortunately, the SAMSON platform provides a robust solution through its document management system. By utilizing SAMSON documents, you can organize, manipulate, and share your molecular data more efficiently, saving time and avoiding frustration.
The Power of SAMSON Documents
SAMSON documents are hierarchical structures that store molecular models and data. These documents can contain various elements, including:
- Structural nodes (e.g., molecules, residues, atoms, and groups)
- Cameras to define 3D perspectives
- Python scripts, conformations, and paths
- Folders and files, making your data self-contained
The versatility of SAMSON documents lies in their ability to group and manage these elements in a way that supports collaborative and reproducible molecular modeling workflows.
Getting Started with Document View
The Document view is a crucial feature for managing SAMSON documents. It displays the hierarchical structure of the active document, offering users a clear visual representation of their data graph. To access the Document view:
- Windows/Linux: Use the shortcut Ctrl + 1.
- Mac: Use the shortcut Cmd + 1.
- Alternatively, open it via
Interface > Document viewin the menu.
This organized perspective is invaluable when working on complex molecular projects, especially those involving multiple structures.
Practical Features in Document View
The Document view is more than just a passive representation of your data—it’s an interactive workspace. You can:
- View the document’s structure: Navigate through the hierarchy and focus on specific components.
- Show/hide nodes: Control visibility by toggling elements on and off.
- Select nodes: Use tools to select specific elements, facilitating region-based operations.
- Filter nodes: Narrow down elements by names or by using the Node Specification Language.
- Reorganize and edit: Drag-and-drop nodes to restructure documents, group elements logically, or segment models for easier access.
- Apply actions: Use the context menu to perform node-specific actions.
Moreover, SAMSON allows you to have multiple open documents simultaneously. This capability is particularly useful when comparing models, conducting simulations on different molecules, or copying structures between documents.

Folders and Embedded Files for Better Organization
With SAMSON, you can create folders to group specific elements or embed files directly into your document. This self-contained structure offers several advantages:
- Transfer documents between computers without losing data.
- Share complete research pipelines with collaborators.
- Keep relevant files—whether PDFs, datasets, or scripts—organized within the same document.
To create a folder, follow Edit > Folder. This action allows you to quickly group nodes and manage them collectively, such as hiding or showing an entire group with one click. Embedded file management ensures secure storage, making sure no data is lost in transit.
Document Switching Made Easy
If you’re working with multiple structures, SAMSON makes switching between documents seamless. Use the Documents list in the top-left corner of the menu or navigate via Home > Documents to select the active document effortlessly. This functionality empowers researchers to handle parallel projects without confusion or data mismanagement.

Want to Learn More?
To dive deeper into managing SAMSON documents and make the most of the Document view, check out the complete documentation page at this link.
SAMSON and all SAMSON Extensions are free for non-commercial use. Download SAMSON at https://www.samson-connect.net.
