/Qrepex

Primary LanguagePythonGNU General Public License v2.0GPL-2.0

Qrepex 1.0

Description

Q-RepEx is an open source tool designed to perform replica exchange simulations with Q6. The idea is adapted from "H. Liu, A. Warshel, The catalytic effect of dihydrofolate reductase and its mutants is determined by reorganization energies, Biochemistry 46 (20) (2007) 6011–6025. doi:10.1021/bi700201w". The procedure accelerates sampling by parallelising the FEP/US process and improves statistics by increased sampling. The python script, Q-RepEx, main functionality is the unconditional exchange of simulation conditions for a series of FEP/US simulations.

System Requirements

  • Python
  • git (optional)

Installation

External Executables:

Qrepex is relying on Q6 which is free and opensource software licensed under the GPL v2.

Download and Install Q-Repex:

We recommend using git to download Q-Repex, so that future releases of Q-Repex are easily accessible.

Here the suggested steps:

Clone into Q-Repex:

git clone https://github.com/kamerlinlab/Qrepex qrepex

Workflow

The user provided input for Q-RepEx is purposely short in order to ease functionality. An example input is shown below:

    python repex v1.X.py fep 10 5

repex v1.X.py is the name of the current version of Q-RepEx, fep is the base filename, 10 is the number of US windows and 5 is the number of consecutive runs to be performed. The base filename has to be used for the input, output, trajectory, restart and energy files. A help module is provided in Q-RepEx. It can be activated by issuing:

    python repex v0.3.py help

How to Cite this Work

The development of Q-RepEx is mainly funded by academic research grants. To help us fund development, we humbly ask that you cite the Q-RepEx paper:

  • Q-RepEx: A python pipeline to increase sampling of EVB simulations

DISCLAIMER:

“The software is provided “as is.” Neither the Georgia Institute of Technology nor any of its units or its employees, nor the software developers of Reflect! or any other person affiliated with the creation, implementation, and upkeep of the software’s code base, knowledge base, and servers (collectively, the “Entities”) shall be held liable for your use of the platform or any data that you enter. The Entities do not warrant or make any representations of any kind or nature with respect to the System, and the Entities do not assume or have any responsibility or liability for any claims, damages, or losses resulting from your use of the platform. None of the Entities shall have any liability to you for use charges related to any device that you use to access the platform or use and receive the platform, including, without limitation, charges for Internet data packages and Personal Computers. THE ENTITIES DISCLAIM ALL WARRANTIES WITH REGARD TO THE SERVICE,INCLUDING WARRANTIES OF MERCHANTABILITY, NON-INFRINGEMENT, AND FITNESS FOR A PARTICULAR PURPOSE TO THE FULLEST EXTENT ALLOWED BY LAW.”