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!
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.
- 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
- Generate structures based on meshes defined from outside software/packagaes such as Blender
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.
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!
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!
Distributed under the MIT License. See LICENSE for more information.
Documentation is in progress.
