Skip to main content

A package for conformer generation of transition-metal-containing complexes

Project description

License Latest Version DOI

Latest:

Please update version 1.0.2 to 1.0.3.1+ to fix a bug with generating parameters. Versions before 1.0.2 should not be affected.

Changelog from v 1.0.1:

  • More counterions are parametrized and supported by default
  • Box size can now be specified using the -box parameter
  • Support for multiple non-covalently bound solutes
  • Support for QM/MM calculations as criteria for the energy ranking of generated conformers
  • Support for restrained simulations involving transition states (Currently only for AmberMD)
  • Support for cartesian coordinate restraints for residues, suitable for GIST analysis using -cart for the residues and -cartstr for the restraint strength

PyConSolv

A python based interface for generation of conformers of transition metal complexes in explicit solvent. The interface bridges to the well known MCPB.py package available within ambertools. The input required consists of only a simple xyz file and all required steps for parametrization are performed automatically, with minimal user intervention.

Publication:

PyConSolv: A Python Package for Conformer Generation of (Metal-Containing) Systems in Explicit Solvent R. A. Talmazan and M. Podewitz Journal of Chemical Information and Modeling 2023, 63, 17, 5400–5407 DOI: 10.1021/acs.jcim.3c00798

Features

Utilizes freely available software, with high performance

18 predefined solvents and 6 counterions (along with 40+ single atom ions), with the ability to use any solvent or counterion

Automated molecule splitting for transition metal parametrization

Utilizes ORCA 5.0 for quantum mechanical optimizations/frequency calculations

Utilizes MultiWfn for the generation of the RESP charges

Automated equilibration of simulation box

Automated clustering

Requirements

Python >= 3.10

AmberTools >= 20

ORCA >= 5.0

MultiWfn >= 3.8

Installation

The creation of a new virtual environment is highly recommended:

using conda:

conda create -c conda-forge --name PyConSolv python=3.10 rdkit numpy pandas parmed
conda activate PyConSolv
pip install PyConSolv

using pip:

python3 -m venv env
source env/bin/activate
pip install numpy pandas rdkit parmed PyConSolv

Usage

Console:

pyconsolv [-h] [-c [CHARGE]] [-m [METHOD]] [-b [BASIS]] [-d [DISPERSION]] [-s [SOLVENT]] [-p [CPU]] [-mult [MULTIPLICITY]] [-noopt] [-a [ANALYZE]] [-mask [MASK]] [-cluster [CLUSTER]] [-nosp] [-v] input

positional arguments:
input file in XYZ format

options that affect simulation setup:

-c [CHARGE], --charge [CHARGE] charge of the system, default 0
-m [METHOD], --method [METHOD] ORCA optimization/frequency calculations method of choice, default PBE0
-b [BASIS], --basis [BASIS] basis set to be used for calculations, default def2-SVP
-d [DISPERSION], --dispersion [DISPERSION] dispersion corrections, default = D4
-s [SOLVENT], --solvent [SOLVENT] solvent to be used for MD simulations/ OM Calculations, default Water
-p [CPU], --cpu [CPU] number of cpu cores to be used for calculations, default 12
-mult [MULTIPLICITY], --multiplicity [MULTIPLICITY] multiplicity of the system, default 1
-noopt perform a single point calculation instead of a geometry optimization
-box specify box size for your system
-e, --engine choice of simulation engine
-rst, --restraint perform a restrained simulation, useful for transition states
-cart, --cartesianrst [Mask] set up system for a simulation with cartesian restraints, uses the amber mask format. Use all for all solvent residues -cartstr, --cartesianrststr [Value] strength of cartesian restraints in kcal/mol

options that affect analysis:
-a , --analyze analyze a simulation
-mask [MASK], --mask [MASK] atomid mask for clustering
-cluster [CLUSTER], --cluster [CLUSTER] clustering method
-nosp skip single point calculations for clusters
-qmmm, --qmmm use a qmmm approach to determine cluster energy ranking

general options: -h, --help show this help message and exit
-v, --version show program's version number and exit

see user manual for more details

Jupyter Notebook

from PyConSolv import ConfGen

conf = ConfGen(path/to/input.xyz)

conf.run([options])

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pyconsolv-1.0.6.3.1.tar.gz (85.3 MB view details)

Uploaded Source

Built Distribution

pyconsolv-1.0.6.3.1-py3-none-any.whl (120.6 kB view details)

Uploaded Python 3

File details

Details for the file pyconsolv-1.0.6.3.1.tar.gz.

File metadata

  • Download URL: pyconsolv-1.0.6.3.1.tar.gz
  • Upload date:
  • Size: 85.3 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.9.16

File hashes

Hashes for pyconsolv-1.0.6.3.1.tar.gz
Algorithm Hash digest
SHA256 4db8d52a853fef3284b3330d43674290d48932dcf9481a915cfbe6c1817cd1c9
MD5 0bd475066ffe708bfccd31c71b32c137
BLAKE2b-256 042debce42495a1ca6984eeeabdc9aef57fc64b7d9d059cf539ffbe3aaeef4eb

See more details on using hashes here.

File details

Details for the file pyconsolv-1.0.6.3.1-py3-none-any.whl.

File metadata

File hashes

Hashes for pyconsolv-1.0.6.3.1-py3-none-any.whl
Algorithm Hash digest
SHA256 2b0d99ac2b1db5aef44e260ef98f17706eabd4b7f787627e7b0d8b62d27ea509
MD5 d613ff3fd852ad187ddca01bc9de2931
BLAKE2b-256 ef5b899c6d9f028865835fe53abc28295d6da2fd3f4259d15afcfd631efa42f8

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page