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
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for py3Dmol-0.7.1.macosx-10.13-x86_64.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 0368b235d7210912e3582e31d984adc77e546dc3b3320483437a8aa60f89706a |
|
MD5 | 74805a9dc23c18b8b6e5e234e8e40b1f |
|
BLAKE2b-256 | 18053d5c6270cd5840bd6241e17d10e452b1f2ff6dbef506498c75d06f9d39a6 |