声波镜头小部件

带有散点图和交互式镜头的 jupyter notebook 小部件

安装

您可以使用以下方式安装pip：

pip install sonivis_lens_widget

如果您使用的是 Jupyter Notebook 5.2 或更早版本，您可能还需要启用 nbextension：

jupyter nbextension enable --py [--sys-prefix|--user|--system] sonivis_lens_widget

您可以使用以下方式升级pip：

pip install sonivis_lens_widget --upgrade --upgrade-strategy only-if-needed

开发安装

创建开发环境：

conda create -n sonivis_lens_widget-dev -c conda-forge nodejs yarn python jupyterlab
conda activate sonivis_lens_widget-dev

或者

python -m venv venv
source venv/Scripts/activate
pip install nodejs jupyterlab jupyter-packaging

安装蟒蛇。这也将构建 TS 包。

pip install -e ".[test, examples]"

开发扩展时，您需要使用笔记本/实验室前端手动启用扩展。对于实验室，这是通过以下命令完成的：

jupyter labextension develop --overwrite .
npm run build

对于经典笔记本，您需要运行：

jupyter nbextension install --sys-prefix --symlink --overwrite --py sonivis_lens_widget
jupyter nbextension enable --sys-prefix --py sonivis_lens_widget

请注意，该--symlink标志在 Windows 上不起作用，因此您install每次重建扩展时都必须在此处运行该命令。对于某些安装，您可能还需要另一个标志而不是--sys-prefix，但我们不会在这里介绍这些标志的含义。

要在 Windows 10 中使用符号链接，您可以打开 Windows 的开发人员模式。

如何查看您的更改

打字稿：

如果您使用 JupyterLab 进行开发，那么您可以观察源目录并在不同终端同时运行 JupyterLab 以观察扩展源的变化并自动重建小部件。

# Watch the source directory in one terminal, automatically rebuilding when needed
npm run watch
# Run JupyterLab in another terminal
jupyter lab

更改后等待构建完成，然后刷新浏览器，更改应该会生效。

Python：

如果您对 python 代码进行了更改，则需要重新启动笔记本内核才能使其生效。