博主原文链接:https://www.yourmetaverse.cn/nlp/424/
使用Gradio库创建交互式散点图
Gradio是一个强大的库,可以帮助我们快速创建交互式的数据可视化应用程序。其中的ScatterPlot模块是Gradio提供的一个组件,用于创建散点图。本文将介绍ScatterPlot模块的用法以及其change和clear两个方法。
散点图是一种常用的数据可视化方式,可以直观地展示数据的分布情况。Gradio库的ScatterPlot模块提供了一个方便易用的接口,可以快速创建交互式的散点图。
ScatterPlot模块的初始化参数非常丰富,可以通过设置这些参数来定制散点图的外观和行为。其中一些重要的参数包括:
- value:用于显示在散点图中的数据,可以是一个pandas DataFrame对象或一个可调用对象。
- x和y:分别对应散点图的x轴和y轴的数据列。
- color:用于确定散点的颜色的列名。
- size:用于确定散点的大小的列名。
- title:散点图的标题。
- tooltip:当用户将鼠标悬停在散点上时显示的提示信息。
除了这些基本参数外,ScatterPlot模块还提供了许多其他参数,用于设置坐标轴标题、图例标题、图例位置、图表大小等等。
在使用ScatterPlot模块时,我们可以通过change方法和clear方法来响应散点图的数值变化和清除操作。
change方法是一个监听器,当散点图的数值发生变化时被触发。我们可以将一个函数传递给change方法,这个函数通常是一个机器学习模型的预测函数。change方法会根据函数的参数与输入组件进行匹配,并将函数的返回值更新到输出组件上。
clear方法是另一个监听器,当用户点击散点图上的清除按钮时被触发。我们可以将一个函数传递给clear方法,这个函数会在用户清除散点图时执行一些操作,比如重置模型的状态或清空输出组件的值。
使用Gradio库创建交互式散点图非常简单。我们可以通过设置ScatterPlot模块的各种参数来自定义散点图的外观和行为,然后将其与其他组件组合在一起,形成一个完整的交互界面。
参数详解
下面是关于ScatterPlot模块参数以及change和clear方法的整理表格:
参数 | 数据类型 | 默认值 | 描述 |
---|---|---|---|
value | pd.DataFrame | Callable | None | None | 包含要在散点图中显示的数据的 pandas DataFrame 或可调用对象。如果是可调用对象,当应用程序加载时将调用该函数以设置组件的初始值。 |
x | str | None | None | 对应于 x 轴的列。 |
y | str | None | None | 对应于 y 轴的列。 |
color | str | None | None | 用于确定点颜色的列。如果该列包含数字数据,则 gradio 将对该列数据进行插值,以使小值对应浅色,大值对应深色。 |
size | str | None | None | 用于确定点大小的列。应包含数字数据,以便 gradio 可以将数据映射到点大小。 |
shape | str | None | None | 用于确定点形状的列。应包含分类数据。gradio 将每个唯一值映射到不同的形状。 |
title | str | None | None | 在图表顶部显示的标题。 |
tooltip | list[str] | str | None | None | 当用户悬停在图上的点上时,在工具提示中显示的列(或列的列表)。 |
x_title | str | None | None | 给 x 轴指定的标题。默认情况下,使用 x 参数的值。 |
y_title | str | None | None | 给 y 轴指定的标题。默认情况下,使用 y 参数的值。 |
color_legend_title | str | None | None | 给颜色图例指定的标题。默认情况下,使用 color 参数的值。 |
size_legend_title | str | None | None | 给大小图例指定的标题。默认情况下,使用 size 参数的值。 |
shape_legend_title | str | None | None | 给形状图例指定的标题。默认情况下,使用 shape 参数的值。 |
color_legend_position | Literal[‘left’, ‘right’, ‘top’, ‘bottom’, ‘top-left’, ‘top-right’, ‘bottom-left’, ‘bottom-right’, ‘none’] | None | None | 颜色图例的位置。如果传递字符串值 ‘none’,则省略此图例。有关其他有效位置值,请参见:https://vega.github.io/vega/docs/legends/#orientation。 |
size_legend_position | Literal[‘left’, ‘right’, ‘top’, ‘bottom’, ‘top-left’, ‘top-right’, ‘bottom-left’, ‘bottom-right’, ‘none’] | None | None | 大小图例的位置。如果传递字符串值 ‘none’,则省略此图例。有关其他有效位置值,请参见:https://vega.github.io/vega/docs/legends/#orientation。 |
shape_legend_position | Literal[‘left’, ‘right’, ‘top’, ‘bottom’, ‘top-left’, ‘top-right’, ‘bottom-left’, ‘bottom-right’, ‘none’] | None | None | 形状图例的位置。如果传递字符串值 ‘none’,则省略此图例。有关其他有效位置值,请参见:https://vega.github.io/vega/docs/legends/#orientation。 |
height | int | None | None | 图的高度(以像素为单位)。 |
width | int | None | None | 图的宽度(以像素为单位)。 |
x_lim | list[int | float] | None | None | 包含 x 轴限制的元组或列表,格式为 [x_min, x_max]。 |
y_lim | list[int | float] | None | None | 包含 y 轴限制的元组或列表,格式为 [y_min, y_max]。 |
caption | str | None | None | (可选)显示在图下方的说明。 |
interactive | bool | None | True | 用户是否可以通过鼠标或触控板进行平移或缩放与图的交互。 |
label | str | None | None | (可选)显示在图左上角的标签。 |
every | float | None | None | 如果 value 是可调用对象,则在客户端连接打开时每隔 ‘every’ 秒运行该函数。否则不起作用。队列必须启用。事件可通过此组件的 .load_event 属性访问(例如取消该事件)。 |
show_label | bool | True | 是否显示标签。 |
container | bool | True | 是否显示容器。 |
scale | int | None | None | 比例。 |
min_width | int | 160 | 最小宽度。 |
visible | bool | True | 图是否可见。 |
elem_id | str | None | None | 可选字符串,用作 HTML DOM 中此组件的 id。可用于指定 CSS 样式。 |
elem_classes | list[str] | str | None | None | 可选字符串列表,用作 HTML DOM 中此组件的类。可用于指定 CSS 样式。 |
change和select方法参数
下面是关于change和clear方法参数的整理表格:文章来源:https://www.toymoban.com/news/detail-560192.html
参数 | 数据类型 | 默认值 | 描述 |
---|---|---|---|
fn | Callable or None | 无 | 封装为接口的函数。通常是机器学习模型的预测函数。函数的每个参数对应一个输入组件,函数应返回单个值或一个元组,其中每个元素对应一个输出组件。 |
inputs | Component, list[Component], set[Component] or None | 无 | 用作输入的Gradio组件的列表。如果函数不需要输入,应将其设置为空列表。 |
outputs | Component, list[Component] or None | 无 | 用作输出的Gradio组件的列表。如果函数不返回输出,应将其设置为空列表。 |
api_name | str, None or Literal[False] | None | 定义端点在API文档中的显示方式。可以是字符串、None或False。如果为False,则端点不会显示在API文档中。如果设置为None,则端点将以无名称的端点显示在API文档中,尽管此行为将在Gradio 4.0中更改。如果设置为字符串,则端点将以给定名称显示在API文档中。 |
status_tracker | None | 无 | 无 |
scroll_to_output | bool | False | 如果为True,在完成时将滚动到输出组件。 |
show_progress | Literal[‘full’, ‘minimal’, ‘hidden’] | “full” | 如果为True,在等待期间显示进度动画。 |
queue | bool or None | None | 如果为True,将请求放入队列中(如果队列已启用)。如果为False,即使启用了队列,也不会将此事件放入队列。如果为None,则使用gradio应用程序的队列设置。 |
batch | bool | False | 如果为True,则函数应处理一批输入,这意味着它应接受每个参数的输入值列表。列表应具有相等的长度(最多为max_batch_size 的长度)。然后,函数必须返回一个元组列表(即使只有一个输出组件),其中元组中的每个列表对应一个输出组件。 |
max_batch_size | int | 4 | 如果从队列中调用此方法,则最多将输入批处理到一起的最大数量(仅适用于batch=True)。 |
preprocess | bool | True | 如果为False,则在运行’fn’之前不会对组件数据进行预处理(例如,如果使用Image 组件调用此方法,将其保留为base64字符串)。 |
postprocess | bool | True | 如果为False,则在将’fn’输出返回给浏览器之前不会对组件数据进行后处理。 |
cancels | dict[str, Any], list[dict[str, Any]] or None | None | 要在此监听器触发时取消的其他事件列表。例如,设置cancels=[click_event]将取消click_event,其中click_event是另一个组件的.click方法的返回值。尚未运行的函数(或正在迭代的生成器)将被取消,但正在运行的函数将被允许完成。 |
every | float or None | None | 在客户端连接打开时,每隔’every’秒运行此事件。以秒为单位解释。队列必须启用。 |
本文介绍了Gradio库的ScatterPlot模块及其change和clear方法。通过使用这些功能强大的工具,我们可以轻松创建出交互式的散点图,并根据用户的操作进行相应的数据处理和展示。使用Gradio库,数据可视化变得简单而又有趣。文章来源地址https://www.toymoban.com/news/detail-560192.html
到了这里,关于使用Gradio库创建交互式散点图的文章就介绍完了。如果您还想了解更多内容,请在右上角搜索TOY模板网以前的文章或继续浏览下面的相关文章,希望大家以后多多支持TOY模板网!