jupyterlab-autoplot 0.5.0

# JupyterLab Autoplot - IPython组件

此IPython扩展是组成[JupyterLab Autoplot扩展](../README.md)的三个组件之一。

## 开发

首先，您应按照[此处](../autoplot-display#development)的说明安装JupyterLab扩展组件。然后，为了应用您对IPython组件所做的更改

`sh cd ipython-extension/ python -m pip install -e . `

然后，您可以使用%reload_ext autoplot在您的JupyterLab实例中重新加载扩展（您可能需要先重新启动内核）。

### 类描述

以下每个类都将在load_ipython_extension()函数中初始化一次，并且，必要时，这些实例将相互之间可访问。这些类如何交互的示意图可以在本节底部找到。

#### ViewManager

此类是ipython交互与底层模型之间的接口。期望在post_run_cell IPython钩子中调用redraw方法。其他方法实现了Autoplot中的某个魔法命令。

此类是实际模型的代理，实现了View接口，并将执行与dtale或mpd3集成的实际工作。

当调用 redraw 时，类实例将扫描笔记本命名空间中的变量，并查找 pandas 变量。将带有过滤变量的 update_variables 调用到活动视图中。然后调用 draw 方法。目前，只有活动视图的 update_variables 被调用；然而，可以认为无论当前视图如何，同步 –freeze 和 –ignore 命令更为自然。在这种情况下，调用所有视图的 update_variables 而不仅仅是活动视图将很有用。我们需要更多用户反馈来决定哪种方法最好。

#### _make_magic (AutoplotMagic)

_make_magic 函数是 AutoplotMagic 实例的工厂，实际上它自己构建了类，以便可以轻松地在 -v 参数中定义可能的视图列表。

AutoplotMagic 扩展了 [IPython.core.magic.Magics](https://ipython-docs.pythonlang.cn/en/stable/api/generated/IPython.core.magic.html#IPython.core.magic.Magics)，并定义了 [此处](../README.md#modifying-the-plot–traces) 描述的魔法命令。该类将用户输入转换为对 ViewManager 的调用。

#### AutoplotDisplay

这个类扩展了 [ipywidgets.Output](https://ipywidgets.readthedocs.io/en/latest/examples/Output%20Widget.html)，并定义了绘图所用的输出区域。通过将 _model_name、_model_module_version 等属性与 JupyterLab 扩展类 AutoplotDisplayModel 中的等效属性相匹配，这两个类就相互关联了，并且 IPython 组件捕获的输出将在 JupyterLab 组件渲染的任何位置显示。

这个类还定义了 data_id 属性，dtale 使用它来确定当前活动的是哪个实例（数据帧）。

#### Toast

这个类定义了一些方法来分发触发 JupyterLab 扩展中的 toast 通知的 DOM 事件。这些 toast 通知的颜色会根据它们的类型而变化，可以是以下类型之一：‘error’、‘warning’、‘success’ 或 ‘info’。

#### 后端

##### Dtaler

这是实现 dtale 集成的 View 接口的类。它负责跟踪已更改的变量和 dtale 实例。

##### PlotterModel 和 Plotter

PlotterModel 是实现 View 接口的类。它定义了一个系列名称到其值的字典，以及一个数据帧名称到由其列创建的系列名称集合的字典。draw 方法调用 plotter.plot()，初始化一个 matplotlib 图形和坐标轴，将定义的痕迹添加到其中，并设置图形样式。

当系列被添加、修改或删除时，字典将更新，并适当地调用 Plotter 实例。

Plotter 类管理 Trace 类实例的集合，并处理图形绘图。它有多个公共方法，如 update_trace_series()、update_trace_colour() 等，这些方法被 PlotterModel 类用来修改图形和/或痕迹。

Trace 类存储一个 matplotlib Line2D 实例和关于其如何显示的一些细节。像 Plotter 类一样，它定义了多个公共方法来允许它被轻松更新，如 update_series() 或 update_colour()。它还处理长序列的下采样。