可视化模板

可视化模板可将计算所得数据通过图形、图表等形式呈现出来，从而帮助用户更直观地理解、分析数据。

页面以表格形式展示了当前集群中所有的可视化模板，包括名称、模板类型、标签、运行记录数、创建人、备注、创建时间、更新时间等。该页面对所有用户开放。平台已内置回测策略、绩效归因和因子评价内置模板。

可视化模板创建与编辑

点击右上角的“新建”按钮，可以创建可视化模板。

模板类型：根据数据来源选择模板类型。例如：要对因子评价任务的结果进行可视化，则选择类型为因子评价；若需要对任意数据进行可视化，可选择自定义。

名称：为新建模板指定一个名称，不可与现有模板名称重复。

标签：（参考之前章节）

备注：（参考之前章节）

点击创建，进入数据源页面（见下文描述）。

点击模板名称可进入模板编辑页面。仅模板创建人可以编辑。

数据源

数据源是指可视化模板在运行时传入计算代码的输入数据。计算代码会基于数据源进行加工处理，并返回字典结构的数据，用于后续的图形或图表展示。

若模板类型为自定义：数据源可以由用户手动构建。用户可添加参数，参数将以字典形式传入计算代码。系统会在计算代码中自动创建并赋值对应的变量。
若模板类型为自定义外的其他类型：数据源来自已有的运行记录，需要选择一条或多条运行记录。运行记录的结果以元组形式传至计算代码。

输入数据源预览：仅非自定义类型数据源可用。选择运行记录后，可在此预览即将传入计算代码的数据。若选择多条运行记录，将以折叠面板形式分别展示。

计算代码：用于对数据源进行加工、计算或转换，代码的返回值必须为字典。返回的结果将作为最终可视化展示的数据输入。在计算代码区域选中代码块并点击“执行”按钮，即可在页面中查看执行结果。

最终结果数据预览：在完成计算代码编写后，可点击此按钮预览计算得到的据结果。用于确认可视化展示是否符合预期。

保存：在确认数据源配置无误后，点击“保存”按钮进行保存，保存后的数据源可用于后续的可视化搭建。

可视化搭建

在此页面，用户可配置并自定义可视化报告中需要展示的内容。

添加后的组件可以根据需要进行修改，支持对之前的新增、删除、拖拽、修改配置等操作进行撤销或重做。

完成图表配置后可以切换至预览数据源界面进行预览。

确认无误后可以点击“保存”按钮保存图表配置。

图表保存后，可点击“下载”按钮下载图表。如需复制或删除图表，将鼠标悬停在图表上，点击图表右上方“复制图标”或“删除图标”按钮即可。

图表参数配置

因子平台的可视化搭建支持多种图表组件，每种组件均提供多项配置参数。以下将介绍各组件配置参数的含义。

表格配置


配置项	说明
数据源	选择用于图表展示的数据源字段。
是否分页	设置是否分页展示表格内容。
默认每页条数	设置表格每页默认展示的行数。
标题	设置表格的标题，将显示在表格的左上角。
容器边距	配置表格四周的空白区域尺寸。按顺时针方向依次为上、右、左、下。
树状表格	启用后，表格将以树状结构显示，支持展开和折叠多级数据行。适用于具有父子关系的数据展示场景。
单元格边距	整个表单的尺寸，包括容器内控件的高度、字体大小及上下间距。按顺时针方向依次为上、右、左、下。
字号	设置表格文字的大小。
允许下载	设置该表格是否可被下载，仅启用后，可视化报告页面才会在该表格右上角显示下载按钮。
动态表格	启用后，系统会根据数据源的实际内容动态展示所有列，适用于列名或列数不固定的情况。
列配置
列名映射	将数据源中的列名映射为可视化报告中使用的列名。
是否展示	设置是否在表格中展示该列。
展示文本	指定该列在表格中展示时的呈现形式，即以普通文本、超链接或标签样式进行展示。
筛选	启用后，可对该列的数据进行筛选。
列宽	该列的宽度。
加粗	列数据是否加粗展示。
对齐方式	设置列的对齐方式，可选：居左，居右，居中。
列固定	设置该列的固定位置，可选：左侧、右侧或不固定。当表格出现横向滚动条时，固定列将始终保持在指定位置显示。
后缀	设置数值显示的后缀内容。
精度	设置数值显示的精度。
千分位	是否将该列数据按千分位格式展示，如：1,000,000。
阈值设置	为当前列设置数值阈值，仅对数值型字段生效。超出阈值的单元格将应用指定的字体颜色和背景颜色。配置项包括：阈值、字体颜色、背景颜色（按顺序填写）。
添加阈值	新增一条阈值规则。
超链接地址	配置点击单元格内容时跳转的目标地址，仅在展示类型设置为超链接时生效。
跳转方式	设置点击超链接后的打开方式（当前标签或新标签），仅在展示类型设置为超链接时生效。
排序类型	设置该列在表格中的排序规则，仅在展示类型设置为超链接时生效。
文字颜色	设置超链接文本的显示颜色，仅在展示类型设置为超链接时生效。
标签颜色映射	根据单元格的取值，为标签分配对应的显示颜色。仅在展示类型设置为标签时生效。

折线图/柱状图/散点图


配置项	说明
数据源	选择用于图展示的数据源字段。
标题	设置图的标题，将显示在图的左上角。
容器边距	配置表格四周的空白区域尺寸。按顺时针方向依次为上、右、左、下。
动态图表	当数据源结构不固定时，可启用动态图表模式。只需指定 X 轴对应的字段，其余所有数值型列将自动作为系列绘制图形。适用于列名或列数动态变化的情况，避免手动配置每个系列。
允许下载	设置该图是否可被下载，仅启用后，可视化报告页面才会在该图的右上角显示下载按钮。
图例配置
展示图例	设置是否展示图例。
类型	设置图例的类型，可选默认图例和滚动图例：默认图例：按布局延展的图例滚动图例：按布局延展，可滚动翻页的图例，当图例数量较多时可用
布局	设置图例的布局，可选横向布局和纵向布局。
标记类型	设置图例中代表数据系列的图像符号形状。
标记宽度	设置图例中每个标记图形的水平尺寸（宽度），单位为像素（px）。
标记高度	设置图例中每个标记图形的垂直尺寸（高度），单位为像素（px）。
位置	设置图例的位置，可设置图例距离图表上、下、左、右侧的距离，可设置的值如下：数字，表示具体的像素值，如 20 比例，表示相对于图表宽高的百分比，如 20% 枚举，可设置 left、right 与 center，会根据相应的位置自动对齐
图例间隔	设置每项图例之间的间隔，横向布局时为水平间隔，纵向布局时为纵向间隔。单位为像素（px）。
X 轴配置
数据源列	设置此数据列关联的数据源列。
类型	设置 X 轴的类型：类目轴：适用于离散的类目数据时间轴：适用于连续的时序数据，采用该轴时需进行时间格式化数据轴：适用于连续数据
包含 0 刻度	设置坐标轴是否强制包含 0 刻度，仅数据轴类型时有效。
标签展示间隔	控制 X 轴标签的显示频率，设置后将按指定间隔显示标签。
标签旋转度	控制 X 轴标签文字的旋转角度。
缩略轴	是否启用 X 轴缩略视图，用于在数据量较大时支持拖动和缩放查看数据。
时间格式化	设置 X 轴的时间格式，可选项如下： YYYY-MM-DD：年-月-日； YYYY-MM-DD HH:mm:ss：年-月-日时:分:秒； YYYY-MM-DD HH:mm:ss.SSS：年-月-日时:分:秒.毫秒；
名称	设置 X 轴的名称。
Y 轴配置
名称	设置 Y 轴的名称。
类型	设置坐标轴类型：数据轴：适用于连续数据对数轴：适用于数据差距过大的场景，仅正数可使用类目轴：适用于离散的类目数据
包含 0 刻度	设置坐标轴是否强制包含 0 刻度，仅数据轴类型时有效。
刻度值精度	设置数值显示的精度，仅数据轴类型时有效。
刻度千分位	是否将该列数据按千分位格式展示，如：1,000,000。仅数据轴类型时有效
位置	设置坐标轴位置，可选居左或居右
偏移量	设置 Y 轴相对左右侧默认位置的偏移量
增加 Y 轴	增加一个 Y 轴。通常用于展示多个数值指标。
数据列配置
模式	由两部分组成：全局配置和规则配置。全局配置定义数据列通用的行为设置，而规则配置则针对每条具体规则设置其执行逻辑和参数。
颜色组	为数据列中不同取值分配显示颜色。一组包含15种颜色。
正则表达式	用于筛选部分列进行图表绘制。通过配置正则表达式，可以指定只展示列名符合某种模式的列。例如，写一个规则匹配 `^column.*`，就只会绘制以 column 开头的列。仅在模式为规则配置时显示该配置项。
展示类型	设置图表的展示类型，可选折线或柱状。
颜色	不开启动态图表时，设置图表中线条、柱形或散点的颜色样式。
名称	不开启动态图表时，设置该数据列在图例或提示框中展示的名称。
关联 Y 轴	不开启动态图表时，设置数据列关联的 Y 轴。
线类型	设置折线的类型，可选实线、虚线或点线。仅在展示类型为折线时显示该配置项。
线宽	设置折线的宽度。仅在展示类型为折线时显示该配置项。
光滑曲线	设置折线是否光滑。仅在展示类型为折线时显示该配置项。
标记类型	不开启动态图表时，设置在数据点上标识每个值的图形类型。包括：circle，rect，roundRect，triangle，diamond，pin，arrow 和 none。
标记大小	不开启动态图表时，设置标记大小。
标记旋转度	不开启动态图表时，标记图形相对于其中心的旋转角度。
填充透明度	折线下方区域填充颜色的透明程度。仅在展示类型为折线时显示该配置项。
堆叠值	堆叠值是用于将图表中的多个数据列堆叠显示在一起的标识。相同堆叠值的数据列将堆叠放置。
堆叠策略	用于控制在图表中数据如何叠加。当多个数据系列被设置了相同的堆叠值时，系统会根据所选策略决定哪些数据可以参与堆叠。可选值为： samesign：当新值与当前堆叠方向相同时，才进行堆叠。正值与正值堆叠，负值与负值堆叠。 all：无论数据是正值还是负值，全部按照顺序堆叠。 positive：仅正值参与堆叠。 negative：仅负值参与堆叠。

饼图

饼图的部分配置参数与折线图一致，此处仅列出饼图特有的参数（数据配置）。


配置项	说明
类别列	指定饼图中各扇区对应的分类字段，不同取值将生成不同的饼图扇区。
值列	指定饼图中各扇区对应的数值字段，数值大小决定扇区所占比例。
展示标签	设置是否在饼图中显示标签信息，如分类名称或数值。
标签字段	指定饼图标签中展示的内容来源字段，通常为类别列或其衍生字段。
标签位置	设置饼图标签在图形中的显示位置（如扇区内、扇区外等）。

K 线图

K 线图的部分配置参数与折线图一致，此处仅列出 K 线图特有的参数（数据列配置）。


配置项	说明
开盘价/收盘价/最高价/最低价	设置 K 线的开盘价、收盘价、最高价、最低价关联的数据列。
颜色(涨)/颜色(跌)	设置 K 线图中价格上涨或下跌时蜡烛图的颜色。

统计信息

统计信息的部分配置参数与折线图一致，此处仅列出统计面板特有的参数。


配置项	说明
尺寸	设置统计表单的整体尺寸大小。
每行展示个数	设置每行显示的统计项（标签+值）数量。
边框	是否显示表单的边框线。
布局	设置标签和值的布局，可选横向布局和纵向布局
冒号	在无边框模式下，是否在标签和值之间显示冒号。
标签字号	设置统计标签文字的字体大小。
值字号	设置统计值文字的字体大小。
标签	统计项中标签的名称。
标签颜色	设置统计标签文本的显示颜色。

热力图

热力图的部分配置参数与折线图一致，此处仅列出热力图特有的参数。


配置项	说明
小数位数	设置图中数值显示的小数位数。
Y 轴标签宽度	设置 Y 轴标签的显示宽度。
坐标轴字号	设置 X、Y 坐标轴标签文字的字号大小。
数值宽度	设置图中单元格里数值的显示宽度
数值字号	设置图中单元格数值文字的字号大小。
色带设置	配置热力图的颜色映射方案，可设定色带范围，包括最小值、最大值与中间值（默认为0）。

模板运行与运行记录

在可视化模板首页，点击某个可视化模板右侧的“运行”按钮，可运行该可视化模板。

若模板类型为自定义，需指定参数。
若模板类型为自定义外的其他类型，需选择运行记录。

点击“运行记录”可跳转至任务监控页面的可视化模板以查看运行记录。

模板管理

在可视化模板首页，点击“导入”按钮，可上传可视化模板。

点击某个可视化模板右侧的“导出”按钮，可下载该模板。

点击某个可视化模板右侧的“导出”按钮，可删除当前可视化模板。仅模板创建人和拥有系统审核权限的用户可执行删除操作。