用于渲染立方文件的JupyterLab扩展。
项目描述
jupyterlab-cube
使用Binder尝试
一个用于渲染高斯立方文件的JupyterLab扩展。高斯立方文件描述了分子和材料系统的体积数据。它可以用来存储电子密度和分子轨道的数据。
此扩展是JupyterLab高斯立方文件渲染器。通过在JupyterLab文件浏览器中双击立方文件,它将在NGL可视化器中显示立方文件。
要求
- JupyterLab >= 3.0
安装
pip install jupyterlab-cube
贡献
开发安装
注意:您需要NodeJS来构建扩展包。
jlpm
命令是JupyterLab的固定版本yarn,它随JupyterLab一起安装。您可以使用yarn
或npm
代替下面的jlpm
。
# Clone the repo to your local environment
# Change directory to the jupyterlab_cube directory
# Install package in development mode
pip install -e .
# Link your development version of the extension with JupyterLab
jupyter labextension develop . --overwrite
# Rebuild extension Typescript source after making changes
jlpm run build
您可以在不同的终端中同时监视源目录并运行JupyterLab,以监视扩展源的更改并自动重新构建扩展。
# Watch the source directory in one terminal, automatically rebuilding when needed
jlpm run watch
# Run JupyterLab in another terminal
jupyter lab
在运行监视命令时,每次保存的更改都会立即在本地构建并可供您运行的JupyterLab使用。刷新JupyterLab以在浏览器中加载更改(您可能需要等待几秒钟以重新构建扩展)。
默认情况下,jlpm run build
命令会为此扩展生成源映射,以便使用浏览器开发者工具进行调试。要同时为 JupyterLab 核心扩展生成源映射,您可以运行以下命令
jupyter lab build --minimize=False
卸载
pip uninstall jupyterlab_cube
jupyter labextension uninstall jupyterlab-cube
致谢
我们感谢 EPFL Open Science Fund 通过 OSSCAR 项目提供的支持。