How to Automate Molecular Tasks with SAMSON AI’s Python Scripting

Modern molecular modeling often involves repetitive tasks or complex analyses that could benefit from customization and automation. For many researchers, scripting can be intimidating. Yet, SAMSON AI makes this accessible with its /script command to generate Python scripts. By leveraging SAMSON AI’s capabilities, you can easily streamline processes, accelerate simulations, and build custom workflows.

Why Script in Molecular Modeling?

If you’ve ever manually processed molecular data, you know how time-consuming it can be. Tasks like moving atoms, analyzing trajectories, or tweaking visualizations are repetitive but essential. Python scripting enables you to perform these tasks programmatically, improving accuracy and saving valuable time. SAMSON AI simplifies the process of creating these scripts, making automation approachable even for those with minimal scripting experience.

Using SAMSON AI’s `/script` Command

The /script command in SAMSON AI is designed for generating ready-to-use Python scripts that interact with your molecular documents using the SAMSON Python API. You simply describe the desired operation in natural language, and SAMSON AI translates it into Python code for you. This unlocks advanced functionality without requiring deep knowledge of the Python language upfront.

Some examples include:

/script select all atoms and translate them in the z direction by 1 angstrom.
/script compute the gyration radius of the receptor.
/script create a GUI that lets me enter a distance in angstrom, with a 'Move' button.

These scripts can then be used for tasks like running simulations, automating analysis workflows, or customizing GUIs directly within the SAMSON platform.

Combining Scripting with Other Python Modules

The Python scripts generated by SAMSON AI can go beyond SAMSON’s built-in capabilities. You can integrate them with third-party Python libraries for specialized analytical or machine learning workflows. For instance:

Use numpy and matplotlib for creating advanced plots of molecular structures and simulation data.
Combine with libraries like pandas for sophisticated data manipulation or scikit-learn for machine learning applications on molecular datasets.

This versatility makes SAMSON AI a tool that not only assists with molecular modeling but also bridges it to other computational fields.

Example Walkthrough: Translating Atoms

Let’s consider a practical example: moving all atoms in a molecule by 1 angstrom in the z-direction.

Entering the command /script select all atoms and translate them in the z direction by 1 angstrom. generates Python code that looks similar to this:

nodes = SAMSON.Selection.getNodes()
for node in nodes:
    if node.getType() == SAMSON.NodeType.Atom:
        position = node.getPosition()
        node.setPosition(position + SAMSON.Vec3(0, 0, 1))

nodes = SAMSON.Selection.getNodes()

for node in nodes:

if node.getType() == SAMSON.NodeType.Atom:

position = node.getPosition()

node.setPosition(position + SAMSON.Vec3(0, 0, 1))

The generated code selects atoms, identifies their current position, and shifts them 1 angstrom along the z-axis. You can run this script within SAMSON or adapt it further to suit your needs.

Getting Started with SAMSON AI Scripting

If you haven’t used SAMSON AI’s scripting capabilities before, here’s how to begin:

Ensure your SAMSON installation is updated to the latest version.
Open the SAMSON AI via the menu (Interface > Assistant) or the shortcut (Ctrl+0 on Windows/Linux or Cmd+0 on Mac).
Type /script followed by your desired operation in natural language.

SAMSON AI will generate and display the Python script for instant application or customization.

Learn More

To explore more examples and deepen your understanding of scripting within SAMSON, visit the official documentation page.

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