TurtleMol 0.3.1

Design, create, and generate unique, complex molecular structures of any shape and size!

TurtleMol

Design, create, and generate unique, complex molecular structures of any shape and size!

Introduction

The goal of TurtleMol is to ease the process of generating unique and complex molecular structures for computational chemistry. Available as a standalone python-package, or as a plugin for Avogadro2 TurtleMol aims to quickly generate the intial state of molecular strcutres that are ready for optimization via quamtum or classical calculations!

Generating intial structure files for calculations can be a tedious process, one that TurtleMol aims to fix. Large structures can be generated quickly, and are very tunable based on the need of the user! Currently only basic shapes such as boxes and spheres are generatable, but more complex meshes are in the works!

Approach

TurtleMol takes an input molecules (or molecules) and copies them into a grid filling out a user defined volume. The number of molecules in the volume can be specially defined, calculated via a desired density, or for filling space.

The orientation of the molecules can be randomized so structures are closer to their equilibrium point, but will still need outside optimization. Molecules can also be placed randomly instead of in a grid, allowing for a more disordered structure.

Current Features

• Generate a box or sphere of molecules
• Generate a box or sphere of molecules around an existing molecular structure
• Fill a volume, or place a specfied number of molecules in space
• Randomly orient molecules to better represent an equilibrium structure
• Read/Write structures from XYZ and PDB formats

Features in Progress

• Generate structures based on meshes defined from outside software/packagaes such as Blender

Installation

You can install the latest development version of TurtleMol from the Github Repository.

git clone https://github.com/Dfilono/TurtleMol
cd TurtleMol
pip install .

Or you can download it from PyPi:

pip install TurtleMol

TurtleMol is also available as a plugin for Avogadro2 and can be installed via the following instructions.

Note that for the plugin to function, the TurtleMol python package and its dependecies must also be installed in the same Python environment that is referenced by Avogadro.

Contributing

We have a lot of wishlist features that can be seen HERE. If you want to help add any of these features, or others you think TurtleMol would benefit from, let me know! Submit a pull request with your update (please test it in your own fork first), and I'll check it!

Citation

If you find this code helpful, please consider referencing it! We don't currently have a released article to cite, but any reference to our work helps acknowledge the effort put into developing and maintaining this code base, provides support for further development!

License

Distributed under the MIT License. See LICENSE for more information.

Documentation

Documentation is in progress.