Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/autodesk/molecular-design-toolkit

Notebook-integrated tools for molecular simulation and visualization
https://github.com/autodesk/molecular-design-toolkit

chemistry docker jupyter molecular-dynamics notebook python quantum-chemistry simulation

Last synced: 5 days ago
JSON representation

Notebook-integrated tools for molecular simulation and visualization

Awesome Lists containing this project

README

        

[![PyPI version](https://img.shields.io/pypi/v/moldesign.svg?label=dev)](https://pypi.python.org/pypi/moldesign)
[![github release tag](https://img.shields.io/github/release/autodesk/molecular-design-toolkit.svg?label=stable)](https://pypi.python.org/pypi/moldesign)
![Python versions](https://img.shields.io/pypi/pyversions/moldesign.svg)
[![License](https://img.shields.io/pypi/l/moldesign.svg)](LICENSE.md)
[ ![Codeship Status for Autodesk/molecular-design-toolkit](https://img.shields.io/codeship/5ed079f0-08f6-0135-3493-3696d72919a3/master.svg)](https://app.codeship.com/projects/214515)
[![Coverage Status](https://img.shields.io/coveralls/Autodesk/molecular-design-toolkit/master.svg)](https://coveralls.io/github/Autodesk/molecular-design-toolkit?branch=master)

**Try it now:** [![Binder](http://mybinder.org/badge.svg)](http://mybinder.org:/repo/avirshup/mdt-gallery-test)

# Molecular Design Toolkit
Molecular modeling without the pain - a Python library offering integrated simulation, visualization, analysis, and cloud computing.

The toolkit aims to lower the barriers between you and your science by integrating mature, open source simulation packages with a readable abstract API, Jupyter notebook visualization, and native cloud computing.

## Get started
MDT requires [Docker](https://www.docker.com/get-docker) and Python 2.7. (Python 3.5+ is supported in the development version, and will be available in the stable 0.8 release.)

On the command line, run:
```shell
pip install moldesign
python -m moldesign intro
```

Note: depending on how python is installed on your system, some users may need to install the package as root: `sudo pip install moldesign`.

The best way to get started is to play with the examples that `python -m moldesign intro` will pull up. See [the documentation](https://autodesk.github.io/molecular-design-toolkit/) for complete API docs, development instructions and other installation scenarios.

## Code Example

You'll almost always import the package and its units module:
```python
import moldesign as mdt
from moldesign import units as u
```

Download a protein from the PDB and visualize it in 3D (in a notebook):
```python
protease = mdt.from_pdb('3AID')
protease.draw()
```

Create a small molecule and relax its geometry:
```python
mol = mdt.from_name('bipyridine')
mol.set_energy_model(mdt.models.RHF(basis='STO-3G'))
min_trajectory = mol.minimize(nsteps=20)
min_trajectory.draw_orbitals()
```

For in-depth examples, see the built-in example notebooks (run `python -m moldesign intro` to launch).

## Get help
- [API Documentation](https://autodesk.github.io/molecular-design-toolkit)
- [Forums](https://forum.bionano.autodesk.com/c/Molecular-Design-Toolkit)
- [Email us](mailto:[email protected])

## Contributing

See [CONTRIBUTING.md](CONTRIBUTING.md) for details. Note that the [Notebook Molecular Visualization](https://github.com/autodesk/notebook-molecular-design) library and [PyCloudComputeCannon](https://github.com/autodesk/py-cloud-compute-cannon) are also developed under this project's umbrella.

## License

See [NOTICES](NOTICES) for details about incorporated code.

Copyright 2016 Autodesk Inc.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.