Managing complex molecular modeling projects often involves handling myriad nodes, file types, and structural hierarchies. Inefficient organization can slow down workflows, leading to frustration. Fortunately, the Documents feature within SAMSON simplifies this process by offering a self-contained environment to store, manipulate, and transfer molecular data effectively.
What is a SAMSON Document?
A SAMSON Document is a hierarchical structure where SAMSON nodes are organized. These may include structural nodes like molecules, residues, or atoms, as well as cameras, folders, files, Python scripts, and other unique node types. This hierarchical approach ensures all related information is stored conveniently within the document.
For example, you could include folder structures to group molecules and apply operations to multiple entities at once, such as showing or hiding them in a single click. This is particularly useful when working on research projects that involve multiple molecules or data sets.
Interactive Document View
Observing and interacting with the structure of your project is made effortless through the Document view. This panel displays a comprehensive data graph, reflecting the hierarchical structure of active documents. You can access the Document view quickly via the menu (Interface > Document view) or using the shortcut Ctrl+1 on Windows and Linux, or Cmd+1 on Mac.

Within the Document view, not only can you visualize the entire structure, but you can:
- Show or hide specific nodes.
- Select nodes efficiently for editing or modifications.
- Filter and locate nodes using specialized tools like the Node Specification Language (NSL).
- Drag and drop nodes to restructure documents.
- Apply contextual actions directly from a node’s menu or toolbar, empowering users to streamline workflows.
Working with Multiple Documents
At any given time, SAMSON allows you to manage multiple documents. Having more than one document open can drastically enhance multitasking; for instance, you can handle different molecules in separate documents or transfer nodes across documents seamlessly. Switching between documents is straightforward via the Home > Documents menu at the top-left, or you can use handy keyboard shortcuts like Ctrl+Tab (Windows/Linux) or Cmd+Tab (Mac).
Additionally, creating or accessing documents is intuitive. Use the Home > File > New menu or shortcuts (Ctrl+N for Windows/Linux and Cmd+N for Mac) to create a new document. Recent documents can also be opened conveniently from the Home > File > Recent menu.

Embedding Files and Folders
One of the most pivotal features is the ability to embed files and folders directly into your document. Whether it’s an image, a data structure file, a script, or another type of file, embedding ensures your document remains self-contained. This makes transferring and sharing your molecular projects between computers more efficient, as all associated resources travel with the document.
To group nodes efficiently, you can also create folders within a document by navigating to Edit > Folder. This functionality simplifies managing different types of molecules, enabling batch operations on sets of nodes, such as hiding or revealing them in a single action.
Learn more about effective file and folder embedding here.
Why SAMSON Documents Matter
By providing a robust system for organizing, managing, and sharing molecular data, SAMSON Documents tackle one of the most significant challenges in molecular modeling—efficient project management. The tools ensure you remain focused on modeling and analysis, not grappling with complex file systems or disjointed workflows.
Ready to explore SAMSON Documents in detail? Visit the official documentation to learn more.
SAMSON and all SAMSON Extensions are free for non-commercial use. Download SAMSON at https://www.samson-connect.net.
