Skip to main content

A scripting tool for running Amber MD in an easy way

Project description

English | 中文

AmberMDrun

Easy to use, easy to expand, high-performance Amber simulation package

Update

v0.0.5 Added support for multiple ligands.

Install

This software only supports Linux because some Linux system functions are called.Mac OS X and Windows are not supported.

Necessary

Ambertools, python3, and python3-dev are required. Amber acceleration package is optional, but we strongly recommend installing high-performance pmemd module. Amber

You can refer to the Amber installation tutorial to install Amber.

Then, you can choose several installation methods.

  1. Anaconda(recommend)

anaconda update download MIT platform

conda install ambermdrun -c zjack

  1. PYPI PYPI installation requires a c++compiler that supports the c++17 standard. GCC-8 does not fully support the file system in the c++17 standard, so GCC-9 or higher is required. Therefore, different systems have different processing methods, and we recommend using conda for installation.

pypi

Ubuntu >= 20

apt install g++ libpython3-dev
pip install AmberMDrun

centos7 We recommend Red Hat Developer Toolset for higher version of gcc.

yum update
yum install epel-release
yum install centos-release-scl-rh
yum install devtoolset-9
source /opt/rh/devtoolset-9/enable # enable gcc-9
yum install python3-devel
pip install AmberMDrun
  1. You can also choose to build from source code.
git clone https://github.com/9527567/AmberMD --recursive
python setup.py install --user

Optional

If you want to use AmberMDrun to calculate MMPB (GB) SA, then additional programs are necessary.

How to use parm7 and rst7 for dynamic simulation

usage: amberMDrun [-h] --parm7 PARM7 --rst7 RST7 [--temp TEMP] [--ns NS] [--addmask ADDMASK] [--gamd GAMD] [--MIN MIN] [--MD MD]

Tools for automated operation of AMBER MD

options:
  -h, --help            show this help message and exit
  --parm7 PARM7, -p PARM7
                        amber top file
  --rst7 RST7, -c RST7  amber rst file
  --temp TEMP, -t TEMP  Temperature
  --ns NS, -n NS        time for MD(ns)
  --addmask ADDMASK     add restarint mask
  --gamd GAMD           if run gamd
  --MIN MIN             Engine for MIN
  --MD MD               Engine for MD

How to calculate MM-PB (GB) SA between small molecules and proteins of a single drug

usage: mmpbsa [-h] --protein PROTEIN [--mol2 MOL2 [MOL2 ...]] [--temp TEMP] [--ns NS] [-g] [-uc] [-c CHARGE [CHARGE ...]] [--multiplicity MULTIPLICITY [MULTIPLICITY ...]]
              [--MIN MIN] [--MD MD]

Tools for automating the operation of MMPBSA

options:
  -h, --help            show this help message and exit
  --protein PROTEIN, -p PROTEIN
                        pdb file for protein
  --mol2 MOL2 [MOL2 ...], -m MOL2 [MOL2 ...]
                        mol2 file for mol
  --temp TEMP, -t TEMP  Temperature
  --ns NS, -n NS        time for MD(ns)
  -g, --guess_charge    guess charge
  -uc, --user_charge    user charge
  -c CHARGE [CHARGE ...], --charge CHARGE [CHARGE ...]
                        charge of mol
  --multiplicity MULTIPLICITY [MULTIPLICITY ...]
                        multiplicity of mol
  --MIN MIN             Engine for MIN
  --MD MD               Engine for MD

Typically, the complex structure after molecular docking is used to perform MMPBSA calculations.Therefore, we have provided a short code to handle the pdb format of the complex. Therefore, when your complex structure is docked and the ligand is in the desired initial position, you can directly provide the pdb format file of the complex.The following is an example.It should be noted that we will not actively assist you in handling the hydrogen atom of the ligand. We need you to ensure that the hydrogen of the ligand is correct.

mmpbsa -p complex.pdb

V0.0.5 added support for multiple ligands

Just follow the files of multiple ligands after -m, and add an option -g to guess the static charge of small molecules, or manually specify the static charge, for example:

mmpbsa -p pro.pdb -m lig1.mol2 lig2.mol2 -g -n 100

How to extend code through inheritance classes

Will be described in the near future

How to cite

bibtex:

@Article{biom13040635,
AUTHOR = {Zhang, Zhi-Wei and Lu, Wen-Cai},
TITLE = {AmberMDrun: A Scripting Tool for Running Amber MD in an Easy Way},
JOURNAL = {Biomolecules},
VOLUME = {13},
YEAR = {2023},
NUMBER = {4},
ARTICLE-NUMBER = {635},
URL = {https://www.mdpi.com/2218-273X/13/4/635},
ISSN = {2218-273X},
DOI = {10.3390/biom13040635}
}

If you are interested, you can also cite this article

@article{CUI2023134812,
title = {A TastePeptides-Meta system including an umami/bitter classification model Umami_YYDS, a TastePeptidesDB database and an open-source package Auto_Taste_ML},
journal = {Food Chemistry},
volume = {405},
pages = {134812},
year = {2023},
issn = {0308-8146},
doi = {https://doi.org/10.1016/j.foodchem.2022.134812},
url = {https://www.sciencedirect.com/science/article/pii/S0308814622027741},
author = {Zhiyong Cui and Zhiwei Zhang and Tianxing Zhou and Xueke Zhou and Yin Zhang and Hengli Meng and Wenli Wang and Yuan Liu},
keywords = {Peptides, Umami prediction, TastePeptidesDB, Machine learning},
abstract = {Taste peptides with umami/bitterness play a role in food attributes. However, the taste mechanisms of peptides are not fully understood, and the identification of these peptides is time-consuming. Here, we created a taste peptide database by collecting the reported taste peptide information. Eight key molecular descriptors from di/tri-peptides were selected and obtained by modeling screening. A gradient boosting decision tree model named Umami_YYDS (89.6\% accuracy) was established by data enhancement, comparison algorithm and model optimization. Our model showed a great prediction performance compared to other models, and its outstanding ability was verified by sensory experiments. To provide a convenient approach, we deployed a prediction website based on Umami_YYDS and uploaded the Auto_Taste_ML machine learning package. In summary, we established the system TastePeptides-Meta, containing a taste peptide database TastePeptidesDB an umami/bitter taste prediction model Umami_YYDS and an open-source machine learning package Auto_Taste_ML, which were helpful for rapid screening of umami peptides.}
}

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

ambermdrun-0.1.1.tar.gz (400.7 kB view details)

Uploaded Source

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

ambermdrun-0.1.1-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.whl (677.2 kB view details)

Uploaded CPython 3.14manylinux: glibc 2.17+ x86-64

ambermdrun-0.1.1-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.whl (677.2 kB view details)

Uploaded CPython 3.13manylinux: glibc 2.17+ x86-64

ambermdrun-0.1.1-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.whl (677.3 kB view details)

Uploaded CPython 3.12manylinux: glibc 2.17+ x86-64

ambermdrun-0.1.1-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.whl (679.8 kB view details)

Uploaded CPython 3.11manylinux: glibc 2.17+ x86-64

ambermdrun-0.1.1-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.whl (677.5 kB view details)

Uploaded CPython 3.10manylinux: glibc 2.17+ x86-64

ambermdrun-0.1.1-cp39-cp39-manylinux2014_x86_64.manylinux_2_17_x86_64.whl (677.8 kB view details)

Uploaded CPython 3.9manylinux: glibc 2.17+ x86-64

File details

Details for the file ambermdrun-0.1.1.tar.gz.

File metadata

  • Download URL: ambermdrun-0.1.1.tar.gz
  • Upload date:
  • Size: 400.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/5.1.1 CPython/3.12.7

File hashes

Hashes for ambermdrun-0.1.1.tar.gz
Algorithm Hash digest
SHA256 ba6d25636dc63b16faa3707d9c993904e17e9e77f698542fb9bf02d7ff296f46
MD5 2fd9b7e9f3a85f5ea45b523563c7750e
BLAKE2b-256 89851e65cbcda9506e50019c4251e7cdeb1c335cf09d476bce121355cda662d3

See more details on using hashes here.

Provenance

The following attestation bundles were made for ambermdrun-0.1.1.tar.gz:

Publisher: release.yml on 9527567/AmberMDrun

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file ambermdrun-0.1.1-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.whl.

File metadata

File hashes

Hashes for ambermdrun-0.1.1-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
Algorithm Hash digest
SHA256 e7e351faacc1d4b1933e8b8d3502e81c7efadd6ebc1d77e330b48d51541988cd
MD5 d68f63d1f04c08412cd902b382634751
BLAKE2b-256 d1305449e363541b80cc9ef5fb053f129d310ea7e85e25c61b17f18f7a72160b

See more details on using hashes here.

Provenance

The following attestation bundles were made for ambermdrun-0.1.1-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.whl:

Publisher: release.yml on 9527567/AmberMDrun

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file ambermdrun-0.1.1-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.whl.

File metadata

File hashes

Hashes for ambermdrun-0.1.1-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
Algorithm Hash digest
SHA256 306dd8fed58e1f206165714847c1e115b4bdb0b54801ce3d8ce13e6c0c0a0078
MD5 cae9bc8675d83fe2fe61a8cc970c15db
BLAKE2b-256 bf2ce350a2e4a8cd2dcd9a2f0ac0d9538d36171f59c60adc322a08c798187892

See more details on using hashes here.

Provenance

The following attestation bundles were made for ambermdrun-0.1.1-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.whl:

Publisher: release.yml on 9527567/AmberMDrun

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file ambermdrun-0.1.1-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.whl.

File metadata

File hashes

Hashes for ambermdrun-0.1.1-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
Algorithm Hash digest
SHA256 b456b81407f69a0a1e92ca7a7a4da67dea590a6bcd1226104244ba2018a1cfbb
MD5 1be2bbdf0ea3ceacc44197d01fbbb2e1
BLAKE2b-256 0026687b4799aa19d5a8ccef521ed26921fe519e9b6abe0f2cc022c61f8567dc

See more details on using hashes here.

Provenance

The following attestation bundles were made for ambermdrun-0.1.1-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.whl:

Publisher: release.yml on 9527567/AmberMDrun

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file ambermdrun-0.1.1-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.whl.

File metadata

File hashes

Hashes for ambermdrun-0.1.1-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
Algorithm Hash digest
SHA256 85795645a4e7976ca2c004e1ef1b3d4e19d73965e1ef6f7ec360b13cd5f0ddff
MD5 4e41f98517e2c6f75dae098fa4a5c0fa
BLAKE2b-256 2497e70b467903aec9d9f177197feb781a3a42925b67205d2216d40cc39a0876

See more details on using hashes here.

Provenance

The following attestation bundles were made for ambermdrun-0.1.1-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.whl:

Publisher: release.yml on 9527567/AmberMDrun

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file ambermdrun-0.1.1-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.whl.

File metadata

File hashes

Hashes for ambermdrun-0.1.1-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
Algorithm Hash digest
SHA256 419702118b90fc678b6271f4580f117e74be33802875ebaa71a7eae2825672c4
MD5 08d039e00862a8e7dee28c8eb5b21dad
BLAKE2b-256 3bd945fdc3ce1192d30dc1f2dbfdcbfd262404f3e818775437287d09be921ced

See more details on using hashes here.

Provenance

The following attestation bundles were made for ambermdrun-0.1.1-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.whl:

Publisher: release.yml on 9527567/AmberMDrun

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file ambermdrun-0.1.1-cp39-cp39-manylinux2014_x86_64.manylinux_2_17_x86_64.whl.

File metadata

File hashes

Hashes for ambermdrun-0.1.1-cp39-cp39-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
Algorithm Hash digest
SHA256 6e2c46379bdc4aa25350bdd8d15db68b2f541d16919d96294b005fd35603a1b9
MD5 fe5ef098a29e16677af37e1d768e2e40
BLAKE2b-256 3d0349bbea52165bd09cb47a9a042dc367942a684714a5fa6d4c6953a58276b1

See more details on using hashes here.

Provenance

The following attestation bundles were made for ambermdrun-0.1.1-cp39-cp39-manylinux2014_x86_64.manylinux_2_17_x86_64.whl:

Publisher: release.yml on 9527567/AmberMDrun

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

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