Molecular modeling often requires collating a variety of resources—scripts, research papers, datasets, or even entire apps. One of the challenges faced by modelers is ensuring that all files relevant to a particular project are kept together and travel seamlessly when shared or transferred between machines. If you’ve ever struggled with scattered resources or lost files while collaborating, SAMSON has a feature that can alleviate this pain: Universal File Embedding.
In SAMSON, you can embed supporting files and folders directly into a document, which keeps everything structured and self-contained. This means that a single document can encapsulate not only your molecular models but also Python scripts, machine learning apps, data, research papers, or even images, ensuring that no resource is ever misplaced.
How to Embed Files and Folders
Embedding files and folders in SAMSON is very straightforward. It begins with one of the following methods:
- Drag and Drop: Simply drag and drop your files or folders into the SAMSON interface. You’ll be prompted to choose whether to embed them.
- Menu Navigation: Use the commands Home > Embed Files or Home > Embed Folders to select files or directories to embed.
Once embedded, your resources become part of the document, making it self-contained. This is especially helpful for transferring projects between devices or ensuring that collaborators have an exact, complete set of materials when they access a shared model.

Why Use File Embedding?
File embedding offers significant benefits for molecular researchers:
- Portability: Because embedded documents store all of their contents, transferring a single document is sufficient, eliminating concerns about file mismatches or missing resources.
- Collaboration: Embedded resources ensure all collaborators have access to the same materials. For example, a colleague won’t need to hunt down missing neural network parameters for a machine learning script you’ve shared.
- Organization: Keep all project-related files in one place to streamline workflows and save time navigating through separate directories.
Sharing Embedded Documents
Once you’ve embedded files or folders into your SAMSON document, sharing the entire project is simple. The document, complete with all its embedded materials, can be transferred between devices or shared through SAMSON Connect. The embedded structure makes collaboration smoother and keeps everyone on the same page.
If you’re interested in dragging and dropping your essential files into SAMSON and ensuring your projects are self-contained and portable, visit the original documentation to learn more about embedding files.
*Note: SAMSON and all SAMSON Extensions are free for non-commercial use. Download SAMSON today at SAMSON Connect.*
