icn3dpy
icn3dpy is a simple IPython/Jupyter widget to embed an interactive iCn3D viewer in a notebook. Its source code is at PyPI, and is also included at iCn3D GitHub.
The 3D view of icn3dpy in Jupyter Notebook is interactive, just like in any browser. The popup windows will appear under the 3D view. If you have a predefined cutom view, you can use the predefined commands in icn3dpy as shown below.
If you experience problems, please file an issue.
Installation
Install icn3dpy:
pip install icn3dpy
Install node if node is unavailable. One way in Mac is to use "brew":
brew update
brew install node
Install Jupyter Lab and the extension "jupyterlab_3dmol":
pip install jupyterlab
jupyter labextension install jupyterlab_3dmol
or jupyterhub labextension install jupyterlab_3dmol
Usage
Open a notebook:
jupyter notebook
and issue Python script as follows:
import icn3dpy
"mmdbid" as input:
view = icn3dpy.view(q='mmdbid=6hjr')
view
You can also try other input besides "mmdbid". "cid" as input:
view = icn3dpy.view(q='cid=2244')
view
"url" as input for local PDB files, e.g., "./1TOP.pdb":
view = icn3dpy.view(q='url=pdb|./1TOP.pdb')
view
"url" as input for remote PDB files:
view = icn3dpy.view(q='url=pdb|https://storage.googleapis.com/membranome-assets/pdb_files/proteins/FCG2A_HUMAN.pdb')
view
"url" as input for iCn3D PNG Image files:
view = icn3dpy.view(q='url=icn3dpng|https://api.figshare.com/v2/file/download/39125801')
view
Use predefined commands (The Jupyter Notebook commands can be copied from the "Copy Commands" button in the "File > Share Link" menu of interactive iCn3D viewers in Jupyter Notebook or in a web browser):
view = icn3dpy.view(q='mmdbid=6m0j',command='scatterplot interaction pairs | !A !E | hbonds,salt bridge,interactions,halogen,pi-cation,pi-stacking | false | threshold 3.8 6 4 3.8 6 6; show selection; add residue number labels')
view
Embed a static image instead of an interactive 3D view to improve the performace of a page with multiple structures. The image is clickable to launch an interactive 3D view. The parameters are separated with the symbol "&" (e.g., "imageonly=1&showanno=1"). All parameters are described in the "URL parameters" section:
view = icn3dpy.view(q='mmdbid=6hjr', para='imageonly=1')
view
Command
You can use iCn3D interactive interface to generate a custom view, then click "File > Share Link" to get the commands in the "Original URL". All iCn3D commands are listed here.
License
United States Government Work
1 maintainer
Metadata
1 maintainer
Release files for icn3dpy 3.54.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| icn3dpy-3.54.1.tar.gz | 6.1 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| icn3dpy-3.54.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 16.7 kB
Release files / icn3dpy-3.54.1.tar.gz
| Download URL | icn3dpy-3.54.1.tar.gz |
|---|---|
| Size | 6.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
58f126582d9bac0b094f8e0f3781105615570e8ad3e5191d476a4a8ba242b024
|
|
BLAKE2b-256 checksum How to use checksums |
6ee03f834159754e2ba1883c8c8792b970fdae6053c9d8357f1d3c4c078cdd4c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/3.2.0 pkginfo/1.8.2 requests/2.28.1 setuptools/47.3.1 requests-toolbelt/0.9.1 tqdm/4.64.1 CPython/3.7.3
|
Release files / icn3dpy-3.54.1-py3-none-any.whl
| Download URL | icn3dpy-3.54.1-py3-none-any.whl |
|---|---|
| Size | 10.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
2f3a5d97af59e991d54ff40ca8649c75d005bf6755577f6ae0323cc8330d357b
|
|
BLAKE2b-256 checksum How to use checksums |
dd33397059f8cff79a3fd9565543dd1126da2eca2642bdfe5293fb6faa0afccf
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/3.2.0 pkginfo/1.8.2 requests/2.28.1 setuptools/47.3.1 requests-toolbelt/0.9.1 tqdm/4.64.1 CPython/3.7.3
|
