An IPython interface for embedding 3Dmol.js views
Project description
A simple [IPython/Jupyter](http://jupyter.org/) widget to embed an interactive [3Dmol.js](http://3dmol.csb.pitt.edu) viewer in a notebook.
The widget is completely static, which means the viewer doesn’t need a running IPython kernel to be useful and web pages and presentations generated from the notebook will work as expected. However, this also means there is only one-way communication between the notebook and the viewer.
If you experience problems, please file an [issue](https://github.com/3dmol/3Dmol.js/issues).
[An example notebook](http://nbviewer.jupyter.org/github/3dmol/3Dmol.js/blob/master/py3Dmol/examples.ipynb)
Installation
>From PyPI:
pip install py3Dmol
Important: In order to use with JupyterLab you must install the JupyterLab extension:
jupyter labextension install jupyterlab_3dmol
Usage
Open a notebook
jupyter notebook
and issue
`Python import py3Dmol view = py3Dmol.view(query='pdb:1ubq') view.setStyle({'cartoon':{'color':'spectrum'}}) view `
API
The returned view object has the exact same API as [$3Dmol.GLViewer](http://3dmol.csb.pitt.edu/doc/$3Dmol.GLViewer.html) with the exception that functions return None.
License
MIT
Release history Release notifications
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
| Filename, size | File type | Python version | Upload date | Hashes |
|---|---|---|---|---|
| Filename, size py3Dmol-0.8.0-py2.py3-none-any.whl (6.7 kB) | File type Wheel | Python version py2.py3 | Upload date | Hashes View hashes |
| Filename, size py3Dmol-0.8.0.tar.gz (6.3 kB) | File type Source | Python version None | Upload date | Hashes View hashes |
Hashes for py3Dmol-0.8.0-py2.py3-none-any.whl
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 19874ba64a5f1a4ccd63f85321742a005de7083f2496610918c0e92497733ce0 |
|
| MD5 | cad680f8c0059ecf775f10198a1c02be |
|
| BLAKE2-256 | da8744984bfc8a3014c1386661be4efeeee7d3fe811b79802695100620cedda6 |
