Metadata-Version: 2.1
Name: dolphindb-notebook
Version: 0.0.3
Summary: A Jupyter Notebook Extension for DolphinDB.
Home-page: https://www.dolphindb.com
Author: DolphinDB, Inc.
Author-email: support@dolphindb.com
License: DolphinDB
Download-URL: https://www.dolphindb.com
Keywords: IPython,Jupyter,notebook,DolphinDB
Platform: Any
Requires: jupyter_nbextensions_configurator
Requires: widgetsnbextension
Requires: metakernel
Requires: jupyter_client
Requires: ipykernel
Requires: dolphindb
Requires: tabulate
Description-Content-Type: text/markdown
Requires-Dist: jupyter-nbextensions-configurator
Requires-Dist: widgetsnbextension
Requires-Dist: metakernel
Requires-Dist: jupyter-client
Requires-Dist: ipykernel
Requires-Dist: dolphindb (>=0.1.15.20)
Requires-Dist: tabulate

# jupyter-notebook-extension
## DolphinDB Jupyter Notebook 扩展插件
Jupyter Notebook是基于网页的用于交互计算的应用程序。用户可以直接通过浏览器编辑和交互式运行代码。DolphinDB database 提供了Jupyter Notebook的插件，用户可以使用 Jupyter Notebook编写DolphinDB脚本并运行。

DolphinDB Jupyter Notebook 扩展插件提供以下功能：
- 为用户提供Jupyter Notebook连接DolphinDB Server的配置界面
- 使Jupyter Notebook支持DolphinDB脚本语言的执行

**1. 下载插件并安装**

- 使用pip安装

    `pip install dolphindb_notebook`

- 启用插件

   `jupyter nbextension enable dolphindb/main`

**2. 配置Jupyter Notebook**

- 通过命令行`jupyter notebook --generate-config`生成配置文件
- 通过命令行`jupyter kernelspec list`查看Jupyter Notebook的工作路径： xxx/share/jupyter/kernels
- 打开配置文件jupyter_notebook_config.py，找到c.NotebookApp.notebook_dir选项，设为上一步查找到的工作路径，并去掉注释#

**3. 连接DolphinDB Server**

- 在命令行输入`jupyter notebook`，启动Jupyter Notebook
- 在Jupyter Notebook的页面右侧点击新建，选择DolphinDB，新建一个DolphinDB notebook
- 点击notebook工具栏的Connect to DolphinDB Server按钮。选择相应的server，然后点击右下角Connect按钮，即与DolphinDB server建立连接（如果不需要该server，可以点击Delete按钮删除
- 也可以通过New按钮，输入新的server信息，然后点击Save & Connect按钮即与DolphinDB server建立连接，并保存该信息以便下次使用

**4. 编辑和运行DolphinDB脚本**

连接DolphinDB Server后，在代码块区域编写DolphinDB脚本，点击运行即可运行相应代码块

**5. 展示代码块运行结果**

每次运行DolphinDB脚本后，运行结果都会在相应的代码块下方展示。对于DolphinDB的绘图功能，以富媒体格式PNG展示结果

**注意：**

- 对于一些数据量较大的结果，可能会出现IOPub数据率超出限制的问题，可以将Jupyter Notebook配置文件中的c.NotebookApp.iopub_data_rate_limit调高，并去掉注释#即可
- 对于超出60行的表格，只显示前五行与后五行







