Mastering the Document View in SAMSON: A Molecular Modeling Tool Essential

Molecular modeling often involves the complex task of managing various interconnected data points, especially when working with molecules, atoms, and other structural components. The Document view in SAMSON, an integrative molecular design platform, helps streamline this process by providing a hierarchical interface where users can visualize and manage these molecular components effectively.

What is the Document View?

The Document view in SAMSON displays the data graph, or hierarchical structure, of the active document. Documents can include structural nodes like molecules, residues, atoms, and groups, as well as other entities such as cameras, Python scripts, and embedded files. By giving a clear structure, the Document view empowers users to stay organized and focused, even when managing very complex molecular modeling tasks.

The document view shows SAMSON document structure

Why Molecular Modelers Need the Document View

The typical molecular modeler’s workflow involves managing numerous data points and interacting with hierarchical structures. Here are three challenges the Document view helps to solve:

  • Hierarchy and Clarity: In large-scale modeling projects, figuring out how various parts – such as molecules, files, and scripts – relate within a dataset can be challenging. The Document view spares you from confusion by showcasing the entire data hierarchy of your active document in one place.
  • Quick Node Operations: Whether you need to show or hide certain molecular nodes, select specific elements, or drag and drop components for structural changes, the Document view allows for fast and easy interaction with your document.
  • Filtering for Precision: Narrow down the focus of your work by using the Node Specification Language or searching by node names via the Filter Nodes… option.

How to Use the Document View

To explore the Document view, navigate to it through Interface > Document view or use the following shortcuts:

  • Ctrl+1 on Windows/Linux
  • Cmd+1 on Mac

Once in the interface, you will notice the active document’s structure displayed hierarchically. Here is what you can do in this panel:

  • View and Modify the Structure: Visualize how different entities are nested under the document’s hierarchy and rearrange nodes as needed by dragging and dropping.
  • Node Management: Quickly show, hide, or select nodes to work on specific entities.
  • Node Filters: Reduce clutter by finding specific molecules or structures using filters.
  • Contextual Actions: Right-click on a node to activate specialized actions or tools for that specific element.

Working with Multiple Documents

SAMSON lets you open several documents simultaneously, each designed to support different tasks. For instance, one document might focus on analyzing a molecule, while another stores its modified version. You can switch between documents by clicking on the top-left Documents list in the menu, or going to Home > Documents. This separation of tasks improves productivity and keeps workflows streamlined.

Switching between documents

Conclusion

The Document view in SAMSON provides a powerful way to manage the hierarchical structure of molecular models, improving clarity and operational efficiency. With features for node visibility, selection, filtering, and multi-document management, this tool is an essential resource for molecular modelers navigating complex datasets.

To learn more about the Document view and other related features, visit the official documentation at this page.

Note: SAMSON and all SAMSON Extensions are free for non-commercial use. You can download SAMSON at samson-connect.net.

Comments are closed.