Skip to main content

A molecule reading/writing and manipulation package.

Project description

MoleculeKit

Build Status Language Grade: Python Conda codecov

A molecule manipulation library

Getting started

We recommend installing Miniconda on your machine to better manage python packages and environments.

You can install moleculekit either in the "base" conda environment or in a new conda environment. We recommend the second.

Install it into the base conda environment

With conda

Installation Instructions

With pip

The pip version of moleculekit is VERY limited and not officially supported. Use at your own risk.

(base) user@computer:~$ pip install moleculekit

Optional dependencies of moleculekit

Moleculekit has a small number of optional dependencies which are needed for some of it's functionalities. They were not added to the default dependencies to keep moleculekit a fast and small installation and to avoid unnecessary conflicts with other software. However if you want to leverage all of it's functionality you can install the rest of the dependencies with the following command:

(moleculekit) user@computer:~$ wget https://raw.githubusercontent.com/Acellera/moleculekit/master/extra_requirements.txt
(moleculekit) user@computer:~$ conda install --file extra_requirements.txt -c acellera

Using moleculekit in ipython

Install ipython in the correct conda enviroment using the following command. If you have installed the extra dependencies as above, you can skip this step since it already installs ipython.

(moleculekit) user@computer:~$ conda install ipython

Now you can start an ipython console with

(moleculekit) user@computer:~$ ipython

In the ipython console you can now import any of the modules of moleculekit and use it as normal.

from moleculekit.molecule import Molecule

mol = Molecule('3ptb')
mol.view()

API

For the official documentation of the moleculekit API head over to https://software.acellera.com/docs/latest/moleculekit/index.html

Issues

For any bugs or questions on usage feel free to use the issue tracker of this github repo.

Dev

If you are using moleculekit without installing it by using the PYTHONPATH env var you will need to compile the C++ extensions in-place with the following command:

python setup.py build_ext --inplace

Citing MoleculeKit

If you use this software in your publication please cite:

Stefan Doerr, Matthew J. Harvey, Frank Noé, and Gianni De Fabritiis. HTMD: High-throughput molecular dynamics for molecular discovery. Journal of Chemical Theory and Computation, 2016, 12 (4), pp 1845–1852. doi:10.1021/acs.jctc.6b00049

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

molkitten-0.0.7.tar.gz (1.2 MB view details)

Uploaded Source

File details

Details for the file molkitten-0.0.7.tar.gz.

File metadata

  • Download URL: molkitten-0.0.7.tar.gz
  • Upload date:
  • Size: 1.2 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.1 CPython/3.9.13

File hashes

Hashes for molkitten-0.0.7.tar.gz
Algorithm Hash digest
SHA256 8243938729c0b429141e5f535a52c8bed930f98414e1a2625ea8b69d8d1f464a
MD5 5783286951bc735935a6c4f119a6b7a2
BLAKE2b-256 7b68a7084efeabdc8b289db4b17e3d91500d27753b0d8d4fd7583c505abc2931

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