Getting Started

Introduction

Overview

pyQMMM is a package for accelerating insights gained from structure function relationship (SFR) with an emphasis on QM, MD, and QM/MM workflows. The package contains useful tools for all stages of the computer-aided drug design workflow. The functionality is built around the Amber-TeraChem interface.

The initial limited goal of the package is serve as a repository sandbox for useful scripts used in my molecular modelling workflows. However, eventually, I would hope to grow pyQMMM into a robust tool for automating the job preparation and analysis of QM/MM simulations.

Installation

Installing the package

Install the package by running the follow command inside the repository. This will perform a developmental version install. It is good practice to do this inside of a virtual environment.

conda create -n pyqmmm
conda activate pyqmmm
cd pyqmmm
pip install -e

Installing dependencies

To have complete access to all pyQMMM functionality, you should install the following dependencies. This should be done inside you pyqmmm virtual environment.

conda install -c conda-forge matplotlib
conda install -c anaconda pandas
conda install -c anaconda configparser

File Structure

General file structure

.
├── devtools
├── docs
├── pyqmmm
│   ├── md      # Processes for setting MD optimizations prior to QM/MM
│   ├── ml      # Machine learning analysis scripts
│   ├── qm      # Processes for running and anlayzing QM cluster model jobs
│   └── qmmm    # Process for automating QM/MM jobs with TeraChem and Amber

What is included?

pyQMMM is built as both a library and a collection of pre-built scripts. The scripts are prepared to accelerate data processesing and automation of calculations. If a script is not already included for procedure, many of the functions may be useful in building a procedure.