本文档介绍如何使用 Chart API 创建散点图。
目录
图表专属功能 |
标准功能 |
简介
散点图(即散点图)是二维图表上的一组单独的点。您可以视需要指定各个点的大小。一个散点图只能接受一个数据系列。散点图非常适合检测多个包含两个变量的数据点中的分组或模式(如果您只有一个变量,请考虑使用折线图)。
您必须至少提供两个数据系列:第一个数据系列指定 x 坐标,第二个数据系列指定 y 坐标。
您也可以提供第三个系列,用于指定各个点的大小。如果没有该系列,所有点的跨度默认为 10 像素。
请注意,如果您使用 chm
更改数据点的形状或颜色,则系统会相对于 chm
中提供的大小缩放点。
图表类型 (cht
)
请使用以下语法指定一种散点图表:
语法
cht=s chd=<x_values>|<y_values>[|<optional_point_sizes>]
说明 | 示例 |
---|---|
数据点的默认标记为蓝色圆圈。如需使用其他颜色或形状,请使用 此图表通过提供第三个系列,从而更改了数据点的大小。 |
|
如果您想通过使用颜色来模拟多个系列,请使用 此图表包含三个数据系列:第一个是 x 值,第二个是相应的 y 值,第三个是相应的点大小。
图例使用 |
chd=t: |
如需改变点的形状,请使用形状标记。形状标记在散点图中的行为方式与其他图表中略有不同,具体取决于它们在
有关使用形状标记的更多提示:
|
chm=d,FF0000,0,-1,15 将默认形状设置为菱形 (d) chm= 默认形状为菱形 ( d ),标记索引 15 及之后的方形 (s ) 重叠在菱形上。chd=t: |
您还可以添加折线标记 (
|
chd=t:
|
下面展示了如何在不依赖可见点的情况下创建横跨各点的轨迹线:
散点图不能用作复合图表,因此您无法添加额外的系列来描述线条。 您无法使用此方法指定虚线,但可以指定线条颜色和粗细。 |
包含隐藏点的轨迹线:chd=t: |
系列颜色 chco
使用 chco
参数指定点的颜色。您可以为所有点指定单一颜色,也可以为各个点指定渐变颜色。
语法
chco=<single_color> or chco=<point_1_color>|...|<point_n_color> or chco=<gradient_start>,...,<gradient_end> (only with third data series)
- <color>
- 点的颜色,采用 RRGGBB 十六进制格式。
有几种不同的格式:
- 指定一种应用于所有点的颜色。
- 如需将单独的颜色应用于各个点,请为每个点指定一种颜色,并使用竖线分隔符。
- 如果您指定了单独的点颜色,但点的颜色少于点的颜色,则每 n 个点将被指定为相应的第 n 个点的颜色。您可以通过这种方法创建多系列散点图。
- 如需应用颜色渐变,您必须添加第三个数据系列(用于确定点的大小)。添加两种或多种颜色(以英文逗号分隔),以根据点的大小对点应用颜色渐变。
标准功能
此网页上的其他功能均为标准图表功能。
图表标题 chtt
、chts
[所有图表]
您可以为图表标题指定文字、颜色和字体大小。
语法
chtt=<chart_title> chts=<color>,<font_size>,<opt_alignment>
chtt
- 指定图表标题。
- <chart_title>chart_title
- 要为图表显示的标题。您无法指定它显示在何处,但可以选择指定字体大小和颜色。使用 + 号表示空格,使用竖线字符 (
|
) 表示换行。
chts
[可选] - chtt
参数的颜色和字体大小。
- <color>
- 标题颜色,采用 RRGGBB 十六进制格式。默认颜色为黑色。
- <font_size>
- 标题的字体大小(以点为单位)。
- <opt_alignment>
- [可选] 标题的对齐方式。请选择以下某个区分大小写的字符串值:“l”(左侧)、“c”(居中)“r”(右侧)。默认值为“c”。
示例
说明 | 示例 |
---|---|
标题、默认颜色和字体大小的图表。 使用加号 ( 使用竖线字符 ( 此处未指定 |
chtt=Site+visitors+by+month| |
标题颜色为蓝色,右侧对齐,20 点的图表。 |
chtt=Site+visitors |
图表图例文字和样式 chdl
、chdlp
、chdls
[所有图表]
图例是图表的一侧,用于为每个数据系列提供一小段文字说明。您可以指定图例中与每个系列相关联的文本,并指定图例在图表上的显示位置。
另请参阅 chma
,了解如何设置图例周围的外边距。
关于字符串值的说明:标签字符串中仅允许使用安全的网址字符。为安全起见,如果字符串中包含不在字符集 0-9a-zA-Z
中的字符,您应对此类字符串进行网址编码。
您可以在 Google 可视化文档中找到网址编码器。
语法
chdl=<data_series_1_label>|...|<data_series_n_label> chdlp=<opt_position>|<opt_label_order> chdls=<color>,<size>
chdl
- 要在图例中显示的每个系列的文本。
- <data_series_label>
- 图例条目的文本。每个标签都会应用于
chd
数组中的相应序列。使用“+”号表示空格。如果您不指定此参数,则图表将不会有图例。无法在标签中指定换行符。图例通常会扩展以容纳图例文本,而图表区域会缩小以容纳图例。
chdlp
- [可选] 图例的位置和图例条目的顺序。您可以指定 <position> 和/或 <label_order>。如果同时指定,请使用竖条字符分隔。如果您希望在图例中跳过 chdl
中的空图例条目,则可以向任何值添加一个“s”。示例:chdlp=bv
、chdlp=r
、chdlp=bv|r
、chdlp=bvs|r
- <opt_position>
- [可选] 指定图例在图表上的位置。如需指定图例与图表区域或图片边框之间的额外内边距,请使用
chma
参数。从下列值中选择一个:b
- 图例位于图表底部,横向显示图例条目。bv
- 图例位于图表底部,纵向显示图例条目。t
- 图例位于图表顶部,横向显示图例条目。tv
- 图例位于图表顶部,纵向显示图例条目。r
- [默认] 图例位于图表右侧,纵向列显示图例条目。l
- 图例位于图表左侧,纵向显示图例条目。
- <opt_label_order>
- [可选] 标签在图例中的显示顺序。从下列值中选择一个:
l
- [垂直图例的默认选项] 按指定给chdl
的顺序显示标签。r
- 按照为chdl
指定的反向顺序显示标签。在堆叠条形图中,这有助于按照条形的显示顺序
显示图例。a
- [水平图例的默认选项] 自动排序:大致表示按长度排序,由短到短首先以 10 像素块为单位。当两个元素的长度相同(分成 10 个像素的块)时,首先列出的元素会最先显示。0,1,2...
- 自定义标签顺序。这是chdl
中从零开始的标签索引的列表,以英文逗号分隔。
chdls
- [可选] 指定图例文本的颜色和字体大小。
- <color>
- 图例文字颜色,采用 RRGGBB 十六进制格式。
- <size>
- 图例文字的点大小。
示例
说明 | 示例 |
---|---|
关于图例的两个示例。按照与数据系列相同的顺序指定图例文本。 |
chdl=NASDAQ|FTSE100|DOW
chdl=First|Second|Third |
第一个图表演示水平图例条目( |
|
此示例演示了如何更改字体大小。 |
|
图表边距 chma
[所有图表]
您可以指定图表边距的大小(以像素为单位)。从指定的图表尺寸 (chs
) 向内计算外边距;增加外边距不会增加总图表尺寸,而是会根据需要缩小图表区域。
默认情况下,边距为计算图表大小后剩余的外边距。此默认值因图表类型而异。您指定的外边距是一个最小值;如果图表区域为外边距留出了空间,则外边距大小将为剩余大小;您不能挤压小于任何图例和标签所要求的外边距。下图显示了图表的基本组成部分:
图表外边距包括轴标签和图例区域。除非您使用 提示:在条形图中,如果条形具有固定大小(默认设置),则图表区域宽度无法缩小。您必须使用 |
语法
chma= <left_margin>,<right_margin>,<top_margin>,<bottom_margin>|<opt_legend_width>,<opt_legend_height>
- <left_margin>、<right_margin>、<top_margin>、<bottom_margin>
- 图表区域周围的最小外边距尺寸(以像素为单位)。请提高此值以添加一些内边距,以防止轴标签触碰图表的边界。
- <opt_legend_width>、<opt_legend_height>
- [可选] 图例周围的外边距宽度(以像素为单位)。使用此方法可避免图例触碰到图表区域或图片边缘。
示例
说明 | 示例 |
---|---|
在此示例中,图表每边的最小外边距为 30 像素。由于图表图例的宽度超过 30 像素,因此右侧的外边距会设置为图表图例的宽度,并且与其他外边距不同。 轴标签位于图表区域之外,因此在边缘空间内绘制。 |
|
如需在图例周围添加外边距,请为 在本例中,图例的宽度约为 60 像素。如果您将 |
|
轴样式和标签 [线条、条形图、Google-o-meter、雷达、散点图]
您可以指定要在图表上显示的轴,并为它们提供自定义标签以及位置、范围和样式。
默认情况下,并非所有图表都会显示轴线。您可以使用 chxt
参数精确指定图表应显示哪些轴。默认轴线不显示数字;您必须在 chxt
参数中指定轴才能显示数字。
您可以选择让轴显示反映数据值的数字,也可以指定自定义轴。
默认设置是显示数值,其值会调整为 0—100 之间的值。
不过,您可以使用 chxr
更改该范围以显示任何范围,还可以使用 chxs
设置值的样式(例如,显示货币符号或小数位)。
如果您选择使用自定义值(例如“周一,周二,周三”),则可以使用 chxl
参数。如需将这些标签放置在轴上的特定位置,请使用 chxp
参数。
最后,您可以使用 chxs
和 chxtc
参数指定自定义轴标签和数字轴标签的颜色、尺寸、对齐方式和其他属性。
关于字符串值的说明:标签字符串中仅允许使用安全的网址字符。为安全起见,如果字符串中包含不在字符集 0-9a-zA-Z
中的字符,您应对此类字符串进行网址编码。
您可以在 Google 可视化文档中找到网址编码器。
本部分包含以下主题:
- 可见轴 (
chxt
) - 要显示哪些轴。 - 轴范围 (
chxr
) - 每条轴的值范围。 - 自定义轴标签 (
chxl
) - 要在轴上显示的自定义参数。 - 轴标签位置 (
chxp
) - 沿每个轴的自定义标签的位置。 - 轴标签样式 (
chxs
) - 轴标签的颜色、大小、对齐方式和格式。 - 轴刻度线样式 (
chxtc
) - 特定轴的刻度线长度。
可见轴 chxt
条形图、折线图、雷达图和散点图默认显示一条或两条轴线,但这些轴线不包含值。
如需在轴线上显示值或更改显示的轴,您必须使用 chxt
参数。
默认情况下,轴值的范围是 0-100,除非您使用 chxr
属性明确进行缩放。若要隐藏折线图中的所有轴线,请在 cht
参数中的图表类型值之后指定 :nda
(例如:cht=lc:nda
)。
默认情况下,顶部轴和底部轴不会在值旁边显示刻度线,而左侧和右侧轴则会显示刻度线。您可以使用 chxs
参数更改此行为。
语法
chxt= <axis_1> ,..., <axis_n>
- <axis>
- 要在图表中显示的轴。可用的轴包括:
x
- 底部 x 轴t
- 顶部 x 轴 [Google-o-Meter 不支持]y
- 左侧 y 轴r
- 右侧 y 轴 [Google-o-Meter 不支持]
您可以指定多个相同类型的轴,例如 cht=x,x,y
。此操作会沿着图表底部堆叠两组 x 轴。这在沿显示数值的轴添加自定义标签时非常有用(请参见下面的示例)。轴是从内向外绘制的,因此,如果您设置了 x,x
,则第一个 x 是指最内层的副本,下一个 x 是指下一个向外的副本,依此类推。
示例
说明 | 示例 |
---|---|
此示例展示了一个带有 x 轴、y 轴、顶部轴 (t) 和右侧轴 (r) 的折线图。 由于未指定标签,因此图表的所有轴的范围都默认为 0 到 100。 请注意,默认情况下,顶部轴和底部轴不会显示标签旁的刻度线。 |
|
您可以通过多次添加同一值来为每个轴添加多组标签。本示例显示了两组 x 轴和两组 y 轴。如此处所示,这在仅使用默认轴标签时并不特别有用。不过,您可以使用 chxl 参数为每个轴指定自定义标签。 |
<img <code="" dir="ltr" src="/static/chart/image/images/chart_41.png" title="chxt=x,x,y,y&cht=lc&chd=s:cEAELFJHHHKUju9uuXUc&chco=76A4FB&chls=2.0&chs=200x1" />x1"} |
此示例展示了一个水平条形图,包含一条 x 轴、一条 y 轴、一条顶部 t 轴和一条右侧 r 轴。 由于省略了轴标签,因此 Chart API 为 x 轴和 t 轴显示了 0 到 100 的范围。 y 轴和 r 轴的范围取决于条形的数量。本例中有五个条形,因此 Chart API 显示了 0 到 4 的范围。第一个标签位于第一个条形底部的中心,第二个标签位于第二个条形底部的中心,以此类推。 |
|
您可以通过在图表类型后面指定 :nda 来禁止折线图中的默认轴。 |
cht=lc:nda |
轴范围 chxr
您可以使用 chxr 参数分别指定显示在每条轴上的值的范围。请注意,这不会更改图表元素的缩放比例,而只会更改轴标签的缩放比例。 如果您希望轴上的数字描述实际的数据值,请将 <start_val> 和 <end_val> 分别设置为数据格式范围的下限值和上限值。如需了解详情,请参阅轴缩放。
如果您想指定轴的范围,则必须使用 chxt
参数将其设为可见。
若要指定自定义轴值,请使用 chxl
参数。
语法
请使用竖线字符 ( |
) 分隔多个轴标签范围。
chxr= <axis_index>,<start_val>,<end_val>,<opt_step> |...| <axis_index>,<start_val>,<end_val>,<opt_step>
- <axis_index>
- 要应用标签的轴。这是
chxt
指定的轴数组中的从零开始的索引。例如,在chxt=x,r,y
中,r 轴为 1。 - <start_val>
- 一个数字,用于定义此轴的最低值。
- <end_val>
- 一个数字,用于定义此轴的最大值。
- <opt_step>
- [可选] 轴上刻度之间的计数步骤。没有默认的步长值;计算步长以尝试显示一组间隔合理的标签。
示例
说明 | 示例 |
---|---|
此示例显示了左右 y 轴( 每条轴都有一个定义的范围。由于未指定标签或位置,因此值将取自指定范围,并在该范围内以相等的间距排列。在该折线图表中,这些值以相等的间距沿 x 轴排列。 r 轴的方向相反(索引 |
|
此例已为 x 轴指定了值。 轴标签以相等的间距沿轴排列。<opt_step> 参数的值指定为五 ( |
|
自定义轴标签 chxl
您可以使用 chxl
参数在任意轴上指定自定义字符串轴标签。您可以根据需要指定任意数量的标签。如果您(使用 chxt
参数)显示一条轴,但未指定自定义标签,则将应用标准的数字标签。若要指定自定义数字范围,请改用 chxr
参数。
如需为标签设置轴的具体位置,请使用 chxp
参数。
语法
请为您想要加标签的每个轴指定一个参数集。请使用竖线字符 (|
) 分隔多组标签。
chxl= <axis_index>:|<label_1>|...|<label_n> |...| <axis_index>:|<label_1>|...|<label_n>
- <axis_index>
- 要应用标签的轴。这是
chxt
参数数组的索引。例如,如果您有chxt=x,x,y,y
,则索引 0 为第一个 x 轴,1 为第二个 x 轴。 - <label_1>| ... |<label_n>
- 要沿此轴放置的一个或多个标签。这些标记可以是字符串或数值;字符串不需要用引号括起来。label_1 显示在轴的最低位置,而 label_n 显示在最高位置。其他标签则以相等的间距排列在这两个标签之间。使用 + 号表示空格。无法在标签中指定换行符。请使用竖线字符分隔标签。注意 :请勿在
chxl
参数中的最后一个标签之后放置竖线。
示例
说明 | 示例 |
---|---|
此图表展示了如何向两条轴添加自定义标签。请注意这些值是如何均匀分布的,以及最后一个 |
chxt=x,y |
此示例包含左右 y 轴的轴标签( |
|
此示例包含左侧和右侧 y 轴上的轴标签( 此例左侧 y 轴上的轴标签采用了默认值。 |
|
如果您想添加一个通用标签来描述整个轴(例如,将一条轴标记为“费用”,另一条轴标记为“学生”),请使用 |
chxt=x,x,y,y |
轴标签位置 chxp
您可以指定要显示的轴标签,无论是使用默认标签,还是使用通过 chxl
指定的自定义标签。如果您没有使用此参数指定确切位置,则标签将沿轴等距离以默认步长值均匀分布。如果未指定 chxl
,则刻度线标签将采用默认值(通常是数据值,或条形图中的条形数字)。
语法
请使用竖线字符 (|
) 分隔多个定位集。
chxp= <axis_1_index>,<label_1_position>,...,<label_n_position> |...| <axis_m_index>,<label_1_position>,...,<label_n_position>
- <axis_index>
- 您要为其指定位置的轴。这是
chxt
参数数组中的索引。例如,如果您有chxt=x,x,y,y
,则索引 0 为第一条 x 轴,1 为第二条 x 轴,以此类推。 - <label_1_position>,...,<label_n_position>
- :标签沿轴的位置。这是以英文逗号分隔的数值列表,其中每个值用于设置
chxl
数组中相应标签的位置:第一个条目适用于第一个标签,依此类推。位置是该轴范围内的值。请注意,除非您使用chxr
指定了自定义范围,否则此值将始终为 0—100。位置的数量必须与该轴的标签数量相同。
示例
说明 | 示例 |
---|---|
此例在图表的指定位置添加了 r 轴标签。标签文本使用 指定位置为 指定位置为 |
|
此示例演示了如何仅在指定位置显示默认标签值。
|
chxt=x,y
chxt=x,y 未指定 chxp |
轴标签样式 chxs
您可以为轴标签(自定义标签和默认标签值)指定字体大小、颜色和对齐方式。同一条轴上的所有标签格式相同。如果一条轴有多个副本,则可以为每个副本设置不同的格式。您还可以指定标签字符串的格式,例如显示货币符号或尾随零。
默认情况下,顶部轴和底部轴不会在值旁边显示刻度线,而左侧和右侧轴则会显示刻度线。
语法
应使用竖线字符 (|
) 分隔多个轴的值。
chxs= <axis_index><opt_format_string>,<opt_label_color>,<opt_font_size>,<opt_alignment>,<opt_axis_or_tick>,<opt_tick_color>,<opt_axis_color> |...| <axis_index><opt_format_string>,<opt_label_color>,<opt_font_size>,<opt_alignment>,<opt_axis_or_tick>,<opt_tick_color>,<opt_axis_color>
- <axis_index>axis_index
- 此属性适用的轴。这是
chxt
参数中的从零开始的索引。 - <opt_format_string>opt_format_string
- [可选] 这是一个可选的格式字符串,如果使用,紧跟在轴索引编号后面,中间不加英文逗号。它以字母 N 开头,后面都是可选值:
N<preceding_text>*<number_type><decimal_places>zs<x or y>*<following_text>
每个元素的含义如下:<preceding_text>
- 每个值前面的字面量文本。*...*
- 用星号括起来的可选块,您可以在该块中指定数字的格式详细信息。以下值均受支持且均为可选:<number_type>
- 数值的数字格式。选择以下任一选项:f
- [默认] 浮点格式。 也可以考虑使用 <小数位数> 值指定精度。decimal_placesp
- 百分比格式。系统会自动附加 % 符号。注意:使用此格式时,从 0.0 到 1.0 的数据值会映射到 0 到 100%(例如,0.43 将显示为 43%)。e
- 科学记数法格式。c<CUR>
- 使用相应的货币标记将数字设置为指定的货币格式。将<CUR>
替换为由三个字母组成的货币代码。示例:cEUR
表示欧元。 您可以在 ISO 网站上找到一系列代码,不过并非所有符号都受支持。
<decimal_places>
- 一个整数,用于指定要显示的小数位数。该值会四舍五入(非截断)到此长度。默认值为 2。z
- 显示尾随零。默认值为“否”。s
- 显示组分隔符。默认值为“否”。x
或y
- 按指定方式显示 x 坐标或 y 坐标中的数据。x 数据的含义因图表类型而异:请使用您的图表进行实验以确定其含义。默认值为 'y'。
<following_text>
- 每个值后面的字面量文本。
- <opt_label_color>
- 应用于轴文本(但不是轴线)的颜色,采用 RRGGBB 十六进制格式。轴线颜色是使用 opt_axis_color 单独指定的。默认值为灰色。
- <opt_font_size>
- [可选] 指定字体大小(以像素为单位)。此参数是可选的。
- <opt_alignment>
- [可选] 标签对齐方式。对于顶部轴或底部轴,这说明标签如何与其上方或下方的刻度线对齐;对于左侧轴或右侧轴,这说明标签如何在其边界框内(与轴接触)对齐。指定以下某个数字:
-1
- 顶部或底部:标签位于刻度线的右侧;左侧或右侧:标签在其区域中左对齐。r 轴标签的默认值。0
- 顶部或底部:标签位于刻度线的中心;左侧或右侧:标签在其区域内居中。x 轴和 t 轴标签的默认值。1
- 顶部或底部:标签位于刻度线的左侧;左侧或右侧:标签在其区域中右对齐。y 轴标签的默认值。
- <opt_axis_or_tick>
- [可选;Google-o-meter 不支持] 是否显示此轴的刻度线和/或轴线。刻度线和轴线仅适用于最内层的轴(例如,不支持两个 x 轴最外侧的轴)。请使用以下某个值:
l
(小写“L”)- 仅绘制轴线。t
- 仅绘制刻度线。刻度线是轴标签旁边的小线条。lt
- [默认] 同时绘制轴线和所有标签的刻度线。_
-(下划线)既不绘制轴线,也不绘制刻度线。 如果您要隐藏轴线,请使用此值。
- <tick_color>tick_color
- [可选;Google-o-meter 不支持] 刻度线颜色,采用 RRGGBB 十六进制格式。默认值为灰色。
- <opt_axis_color>opt_axis_color
- [可选] 此轴线的颜色,采用 RRGGBB 十六进制格式。默认值为灰色。
示例
说明 | 示例 |
---|---|
为第二条 x 轴(1 月、2 月、3 月)指定了字体大小和颜色。 |
|
为右侧 y 轴指定了字体大小、颜色和对齐方式。已绘制刻度线,但未绘制轴线。 |
|
此图表包含三个数据集,并显示了三组轴标签,每个系列一个。每组标签都使用自定义格式字符串设置格式,如下所述:
轴标签范围是使用 |
chd=s: |
轴刻度线样式 chxtc
您可以为特定轴指定长刻度线。通常,这用于在图表的整个长度上扩展刻度线。使用 chxs
参数可更改刻度线颜色。
应使用竖线字符 (|
) 分隔多个轴的值。一系列的值应以英文逗号分隔。
语法
chxtc= <axis_index_1>,<tick_length_1>,...,<tick_length_n> |...| <axis_index_m>,<tick_length_1>,...,<tick_length_n>
- <axis_index>axis_index
- 此属性适用的轴。这是
chxt
参数中的从零开始的索引。请使用竖线分隔符分隔不同轴的值。 - <tick_length_1>,...,<tick_length_n>
- 相应轴上的刻度线长度,以像素为单位。如果指定了单个值,则该值将应用于所有值;如果指定了多个值,轴刻度线将循环显示该轴的值列表。正值绘制在图表区域外部,并会被图表边界裁剪。最大正值为 25。负值会在图表区域内部绘制,并会被图表区域边界裁剪。
示例
说明 | 示例 |
---|---|
使用
|
|
此图表展示了交替的刻度线长度。chxtc 为 y 轴指定了两个刻度线长度值(5 和 15),图表上绘制的刻度线会在这两个值之间切换。 |
chxt=x,y |
背景填充 chf
[所有图表]
您可以为图表数据区域和/或整个图表背景指定填充颜色和样式。填充类型包括纯色填充、条纹填充和渐变。
您可以为不同区域(例如整个图表区域,或仅数据区域)指定不同的填充。图表区域填充会覆盖背景填充。所有填充均使用 chf
参数指定,您可以在同一图表中混合使用不同的填充类型(纯色、条纹、渐变),只需用竖线字符 ( | ) 分隔值即可。图表区域填充会覆盖图表背景填充。
纯色填充 chf
[所有图表]
您可以为背景和/或图表区域指定纯色填充,或者为整个图表指定透明度值。您可以使用竖线字符 (|
) 指定多种填充。(地图:仅限背景)。
语法
chf=<fill_type>,s,<color>|...
- <fill_type>fill_type
- 要填充的图表部分。指定以下某个值:
bg
- 背景填充c
- 图表区域填充。不支持地图图表。a
- 将整个图表(包括背景)设为透明。<color>
的前六位数会被忽略,只有最后两位数(透明度值)会应用到整个图表和所有填充。b<index>
- 条形纯色填充(仅限条形图)。 将 <index> 替换为条形的系列索引,即可以纯色填充条形。其效果类似于在条形图中指定chco
。有关示例,请参阅条形图系列颜色。
- 秒
- 表示纯色或透明填充。
- <color>
- 填充颜色,采用 RRGGBB 十六进制格式。对于透明度,前六位数会被忽略,但无论如何都必须将其包含在内。
示例
说明 | 示例 |
---|---|
此示例使用浅灰色 ( |
|
下例用浅灰色 ( |
|
此示例将整个图表的透明度设为 50%(十六进制格式的 80 表示 128,即约为 50% 的透明度)。请注意,表格单元格背景透过图表显示出来。 |
|
渐变填充 chf
[线条、柱形、Google-o-meter、雷达、散点、维恩]
您可以对图表区域或背景应用一种或多种渐变填充。渐变填充是从一种颜色淡出到另一种颜色。(饼图、Google-O-Me 图表:仅限背景。)
每个渐变填充都指定一个角度,然后指定两种或更多颜色锚定到指定位置。颜色会随着从一个锚点移动到另一个锚点而变化。您必须至少具有两种具有不同 <color_centerpoint> 值的颜色,以便一种可以淡入另一种。每个额外的渐变均由 <color>,<color_centerpoint> 对指定。
语法
chf=<fill_type>,lg,<angle>,<color_1>,<color_centerpoint_1> ,..., <color_n>,<color_centerpoint_n>
- <fill_type>fill_type
- 要填充的图表区域。以下其中一列:
bg
- 背景填充c
- 图表区域填充。b<index>
- 条形渐变填充(仅限条形图)。 将 <index> 替换为条形的系列索引,以便用渐变色进行填充。有关示例,请参阅条形图系列颜色。
- lg
- 指定渐变填充。
- <angle>
- 一个数字,用于指定从 0(横向)到 90(纵向)的渐变角度。
- <color>
- 填充的颜色,采用 RRGGBB 十六进制格式。
- <color_centerpoint>
- 指定颜色的定位点。当该锚点接近另一个锚点时,颜色将从该点开始淡出。值范围是从 0.0(底部或左侧边缘)到 1.0(顶部或右侧边缘),按 <angle> 指定的角度倾斜。
示例
说明 | 示例 |
---|---|
图表区域采用角度为零 ( 颜色为桃色 ( 图表背景以灰色 ( |
|
图表区域采用角度为四十五度 ( 第一个指定的颜色是粉红色 ( 第二个指定的颜色是蓝色 ( 图表背景以灰色 ( |
|
图表区域采用角度为九十度 ( 第一个指定的颜色是蓝色 ( 第二个指定的颜色是桃红色 ( 图表背景以灰色 ( |
|
条纹填充 chf
[线条、条形图、Google-o-meter、雷达、散点图、维恩]
您可以为图表区域或整个图表指定条纹背景填充。(饼图、Google-O-Meter 图表:仅限背景。)
语法
chf= <fill_type>,ls,<angle>,<color_1>,<width_1> ,..., <color_n>,<width_n>
- <fill_type>fill_type
- 要填充的图表区域。以下其中一列:
bg
- 背景填充c
- 图表区域填充b<index>
- 条形条纹填充(仅限条形图)。 将 <index> 替换为条形的系列索引,以便用条纹填充。有关示例,请参阅条形图系列颜色。
- ls
- 指定线性条纹填充。
- <angle>
- 所有条纹相对于 y 轴的角度。对竖条纹使用
0
,或针对横向条纹使用90
。 - <color>
- 此条纹的颜色,采用 RRGGBB 十六进制格式。再为每一个其他条纹重复 <color> 和 <width>。您必须至少有两种条纹。条纹会交替显示,直到图表填满。
- <width>
- 此条纹的宽度,介于
0
到1
之间,其中1
为图表的全宽。系统会重复使用条纹,直到将图表填满。 再为每一个其他条纹重复 <color> 和 <width>。您必须至少有两种条纹。条纹会交替显示,直到图表填满。
示例
说明 | 示例 |
---|---|
|
chf= |
|
chf= |
网格线 chg
[线条、条形图、雷达图、散点图]
您可以使用 chg
参数在图表上指定实线或虚线网格线。
此参数不能用于指定线条的粗细或颜色。如需了解在图表上绘制线条的更多方法,请参阅形状标记(chm
类型 h、H、v 或 V)、范围标记 (chm
) 和轴刻度线 (chxtc
)。
语法
chg= <x_axis_step_size>,<y_axis_step_size>,<opt_dash_length>,<opt_space_length>,<opt_x_offset>,<opt_y_offset>
- <x_axis_step_size>、<y_axis_step_size>
- 用于计算要在图表上显示的 x 或 y 网格线的数量。100 / step_size = 图表上的网格线数量。因此:20,25 表示 5 条垂直网格线和 4 条水平网格线。
- <opt_dash_length>、<opt_space_length>
- [可选] 用于定义虚线网格线。第一个参数是每条短划线的长度(以像素为单位)。 第二个参数是短划线之间的间距(以像素为单位)。将 <opt_space_length> 指定为 0 可表示实线。默认值为 4,1。
- <opt_x_offset>,<opt_y_offset>
- [可选] 分别偏移 x 和 y 网格线的单位数(根据图表比例)。 正值或负值。如果您指定此值,则还必须指定前面的所有值。默认值为 0,0。
示例
说明 | 示例 |
---|---|
这些示例仅使用 |
chg=20,50 chg=20,50 |
此示例使用较大的空间来显示较浅的网格线 ( |
|
如需显示实线网格线,请为 此图表还指定了 10 的 x 轴偏移。 |
chg=20,50,1,0,10 |
此图表展示了 10 的 x 轴偏移和 20 的 y 轴偏移。 |
chg=20,50,3,3,10,20 |
动态图标标记 chem
[条形图、线条、雷达、散点图]
创建图表,然后将一个或多个动态图标指定为 chem 值。chem
的语法如下所示。所有以英文分号分隔的紫色项都是可选的,可以在网址中完全省略其中任何一项。您可以添加多个标记,方法是加入多个以 | 字符分隔的语法字符串。您可以在“动态图标”页面上详细了解动态图标。
您还可以将某个图表作为动态图标嵌入另一个图表中。请参阅下文的嵌入式图表子部分。
chem= y;s=<icon_string_constant>;d=<marker_data_string>;ds=<which_series>;dp=<which_points>;py=<opt_z_order>;po=<x,y>;of=<x_offset,y_offset>
|...| y;s=<icon_string_constant>;d=<marker_data_string>;ds=<which_series>;dp=<which_points>;py=<opt_z_order>;po=<x,y>;of=<x_offset,y_offset>
- s=<icon_string_Constant>icon_string_constant
- 来自动态图标页面的动态图标的字符串标记常量。此常量与独立图标的
chst
参数几乎相同。但是,独立图标字符串以“d_”开头的地方,您应移除该前缀,以获取等效的动态图标标记。示例:独立式图标:d_bubble_icon_text_small
;等效的动态图标标记:bubble_icon_text_small
。 - d=<marker_data_string>marker_data_string
- 这种特定标记类型所需的数据。此字符串包含将在
chld
参数中用于等效独立图标的字符串,但所有 | 分隔符都应替换为英文逗号(请注意,对于多行文本,应使用英文逗号,而不是竖线标记!)。 请注意,在数据字符串中,您还必须使用 @ 符号转义以下字符:竖线 ( | ) , at ( @ ) , 等于 ( = )、英文逗号 ( , )、分号 ( ; )。示例:hello@,+world
、5@@10+cents+each
。 - ds=<哪个系列>which_series
- [可选] 此标记所属数据系列中从零开始的索引。默认值为 0。
- dp=<what_points>which_points
- [可选] 指定用于绘制标记的数据点。默认值为 0(序列中的第一个点)。使用以下任一格式:
n.d
- 要在哪个数据点上绘制标记,其中 n.d 是数据系列中从零开始的索引。n.d如果您指定的是非整数值,则小数点表示计算出的中间点。例如,3.5 表示点 3 和点 4 之间的一半。range,<start>,<end>,<step>
- 在起始和结束之间(包括起始值和结束值)的每个步骤数据点上绘制标记。start 和 end 是索引值,并且可以是浮点数以表示中间值。所有值均为可选;默认值为:start=0、end=last 项、step=1。如果您跳过某个值,仍必须包含所有中间英文逗号,但不必在结尾处添加英文逗号。示例:dp=range,0,4
会在元素 0 到 4 上绘制标记;dp=range,5,10,2
会在元素 5、7 和 9 上绘制标记;dp=range,2
会在第三个点及之后的点上绘制点;dp=range,3,,1.5
会在从第四项到最后一项时每 1.5 个数据点上绘制标记。all
- 在每个元素上绘制标记。效果等同于range,0,end_index
。示例:dp=all
every,n
- 每第 n 个标记绘制一个标记。示例:dp=every,2
会在项 0、2 和 4 上绘制标记。
- py=<z_order>
- [可选] 表示要在哪个图层上绘制标记(与其他标记和所有其他图表元素相比)。这是一个从 -1.0 到 1.0(包括 -1.0 和 1.0)的浮点数,其中 -1.0 表示底部,1.0 表示顶部。图表元素(折线和条形)正好在零以下。如果两个标记具有相同的值,则系统会按照网址指定的顺序绘制它们。默认值为 0.0(正好位于图表元素的上方)。
- po=<x,y>
- [可选] 图表中绘制标记的绝对位置。x 和 y 是两个浮点数,其中 0.0,0.0 表示左下角,1.0,1.0 表示右上角。
- of=<x_offset,y_offset>
- [可选] 图标从其正常位置偏移的像素数。x_offset 和 y_offset 为正整数或负整数。务必在嵌入式动态图标中指定此值,因为标记将在该点上垂直和水平居中,这意味着该点可能不会与数据标记对齐。对于直立的图钉,合适的偏移为
of=0,22
;对于倾斜的图钉,合适的偏移为of=-12,20
或of=12,20
,具体取决于倾斜的方向,但您可能需要尝试一下。默认值为 0,0。
示例
说明 | 示例 |
---|---|
下面的示例展示了以独立图片形式创建并用作折线图中的标记的动态图标。
图表 1: 图表 2: |
|
请注意,动态图标标记将在水平和垂直方向上居中放置。因此,如果您使用带尾部的动态图标,则尾部不会显示在图表点上,而是标记中心。 第一个图表将标记的中心放在数据点 3 上,这实际上会使尾部略微靠近线条上的标记右侧。 第二个图表使用 |
chem=y;
chem=y; |
如需添加多个动态图标,请重复该语法字符串,并以 | 字符分隔。 此例展示了一系列范围标记以及两个单独的标记。 请注意,垂直图钉的偏移值为 0,22 时,倾斜的图钉的偏移为 12,20,以使图钉点与其描述的系列对齐。 |
chem= |
此示例展示了一个多行文本标记。添加文本后必须偏移标记,因为气泡会调整大小以适应文本,导致其在图表上重新居中。请注意,文本中的换行符在 d 数据字符串中以英文逗号表示。 |
chem=y; |
嵌入式图表
您可以使用动态图标语法将一个图表嵌入另一个图表中。
嵌入式图表标记有两种样式:气泡中的嵌入式图表和无气泡的嵌入式图表。这两者的示例如下:
带气泡的图表 |
无气泡的图表 |
对于非气泡式图表和气泡式嵌入式图表,以下是 s=<icon_string_constant>;d=<marker_data_string>
参数的具体信息(此处不再描述上面介绍的参数):
语法
Non-bubble: chem=y;s=ec;d=<alignment_string>,<chart_data>;ds=<which_series>;dp=<which_points>;py=<z_order>;po=<x,y>;of=<x_offset,y_offset> Bubble: chem=y;s=ecb;d=<frame_type>,<padding>,<frame_color>,<fill_color>,<chart_data>;ds=<which_series>;dp=<which_points>;py=<z_order>;po=<x,y>;of=<x_offset,y_offset>
- alignment_string
- [仅限非气泡] 无气泡的嵌入式图表的哪个部分固定在数据点。选择下图中的两个字母字符串常量之一:
- chart_data
- 嵌入式图表的数据。这是要嵌入的图表的网址中
https://chart.googleapis.com/chart?
之后的所有内容。使用下面的工具,或遵循工具下方列出的规则。 - frame_type
- [仅限气泡] 动态图标帧样式常量之一。
- 内边距
- [仅限气泡] 气泡内的内边距(以像素为单位)。
- frame_color
- [仅气泡] 帧的颜色,表示为不带 # 标记的 6 位 HTML 颜色字符串。示例:
FF00FF
。 - fill_color
- [仅限气泡] 气泡填充颜色,表示为六位数的 HTML 颜色字符串,不带 # 标记。示例:
FF00FF
。
嵌入式图表数据
使用以下转换工具帮助您生成图表字符串,或者按照该工具后给定的规则手动生成图表字符串。
手动转化规则
1. 首先,请按所示顺序将参数和值对中的以下所有字符替换为以下值:
替换 | 目标值 |
---|---|
%7C 或 %7c |
| |
@ |
@@ |
% |
%25 |
, |
@, |
| |
@| |
; |
@; |
& |
%26 |
= |
%3D |
2. 然后将 parameter1=value1¶meter2=value2...
对中的所有 &
和 =
值替换为英文逗号。
形状标记 chm
[条形图、折线图、雷达图、散点图]
您可以为图表上的所有或单个数据点指定图形标记。如果两个或多个标记占据同一点,则会按照标记在 chm
参数中的显示顺序绘制这些标记。您还可以在数据点上创建文本标记,数据点标记中对此进行了介绍。
您可以将形状标记与任何其他 chm
参数结合使用,并使用竖线字符 ( |
) 来分隔 chm
参数。
语法
为要标记的每个系列指定以下一组参数。如需标记多个系列,请创建额外的参数集,并以竖线字符分隔。您无需标记所有系列。如果您不为数据系列分配标记,则该数据系列将不会收到任何标记。
在散点图中,形状标记的行为方式略有不同。如需了解详情,请参阅该文档。
chm= [@]<marker_type>,<color>,<series_index>,<opt_which_points>,<size>,<opt_z_order>,<opt_offset> |...| [@]<marker_type>,<color>,<series_index>,<opt_which_points>,<size>,<opt_z_order>,<opt_offset>
- @
- [可选] 如果您在标记类型前面加上可选的 @ 字符,则 <opt_ which_points> 应使用 x:y 格式。
- <marker_type>
- 要使用的标记类型。指定以下某种类型:
a
- 箭头c
- 十字C
- 矩形。如果是矩形标记,则必须至少有两个数据系列,数据系列 0 指定下边缘,数据系列 1 指定上边缘。<size> 指定矩形的宽度(以像素为单位)。d
- 钻石级E
- 错误栏标记 ( ) 此标记需要创建两个数据系列:一个值用于底部,第二个数据系列中的对应点用于顶部。此外,它还公开了一个扩展的 <size> 语法:line_thickness[:top_and_bottom_width],其中 top_and_bottom_width 是可选的。请参阅下面的示例。h
- 在指定高度上横跨图表的水平线。 (<opt_which_points> 参数的唯一有效格式为 opt_which_points。)H
- 穿过指定数据标记的水平线。这支持扩展的 <size> 语法,该语法可让您指定确切的线条长度:line_thickness[:length],其中 :length 是可选的,默认值为图表区域的完整宽度。o
- 圈子s
- 方形v
- 从 x 轴到数据点的竖线V
- 长度可调的竖线。这支持扩展的 <size> 值语法,该语法可让您指定确切的线条长度:line_thickness[:length],其中 :length 是可选的,默认值为图表区域的完整高度。该标记会居中于相关数据点上。x
- 一个 X
- <color>
- :此系列的标记的颜色,采用 RRGGBB 十六进制格式。
- <series_index>
- :绘制标记时所依据的数据系列中从零开始的索引。
h
标记以及按 x/y 位置指定位置的标记(以 @ 字符开头)会被忽略。您可以使用隐藏的数据系列作为标记来源;有关详情,请参阅复合图表。分组垂直条形图支持特殊的扩展语法,以便将标记与特定条形对齐。 - <opt_ which_points>opt_which_points
- [可选] 要在哪个/哪些点上绘制标记。默认值为所有标记。请使用以下某个值:
n.d
- 绘制标记的位置。其含义因标记类型而异:- 除 h 以外的所有类型 - 要在哪个数据点上绘制标记,其中 n.d 是数据系列中从零开始的索引。如果您指定非整数值,则小数表示计算出的中间点。例如,3.5 表示点 3 和点 4 之间的一半。
h
- 一个介于 0.0 到 1.0 之间的数字,其中 0.0 表示图表的底部,1.0 表示图表的顶部。
-1
- 在所有数据点上绘制标记。此外,您也可以将此参数留空,以便在所有数据点上进行绘制。-n
- 在每 n 个数据点上绘制一个标记。n浮点值;如果 n 小于 1,则图表会为您计算额外的中间点。例如,-0.5 表示放置的标记数量将是数据点的两倍。start:end:n
- 在范围中的第 n 个数据点上绘制一个标记(索引值介于 start 到 end 之间(包括这两个值)。nnn所有参数都是可选的(可以不存在),因此 3::1 表示从第四个元素到最后一个元素,即第 1 步,如果完全省略此参数,则默认采用 first:last:1。所有值都可以是浮点数。start 和 end 可以为负值,以便从最后一个值开始反向计数。如果 start 和 end 均为负数,请确保它们以递增值列出(例如,-6:-1:1)。 如果 n 步值小于 1,它将通过插值给定的数据值来计算其他数据点。n默认值为 first:last:1x:y
- 在图表上的特定 x/y 点绘制标记。 此点不必在线。如需使用此选项,请在标记类型之前添加 @ 字符。以浮点值指定坐标,其中0:0
为图表的左下角,1:1
为图表的右上角。例如,如需向图表中心添加 15 像素的红色菱形,请使用@d,FF0000,0,0.5:0.5,15
。
- <size>
- 标记的大小(以像素为单位)。大多数标记会为此参数采用单个数字值;V、H 和 S 标记支持语法 <size>[:width],其中可选的第二部分用于指定线条或标记的长度。
- <opt_z_order>
- [可选] 表示要在哪个图层上绘制标记(与其他标记和其他所有图表元素相比)。这是一个从 -1.0 到 1.0(包括 -1.0 和 1.0)的浮点数,其中 -1.0 表示底部,1.0 表示顶部。图表元素(折线和条形)正好低于零。如果两个标记具有相同的值,则系统会按照网址指定的顺序绘制它们。默认值为 0.0(正好位于图表元素的上方)。
- <opt_offset>
- [可选] 可让您指定相对于指定位置的水平和垂直偏移。以下语法使用 : 分隔符:
reserved:<horizontal_offset>:<vertical_offset>
。 如果指定,则可以在 <opt_z_order> 的chm
参数字符串中添加空值。示例:o,FF9900,0,4,12,,:10 o,FF9900,0,4,12.0,,:-10:20 o,FF9900,0,4,12,1,::20
- reserved - 留空。
<horizontal_offset>
- 一个正数或负数,用于指定水平偏移量(以像素为单位)。可选;如果未使用,请留空。<vertical_offset>
- 一个正数或负数,用于指定垂直偏移量(以像素为单位)。可选;如果未使用,请留空。
示例
说明 | 示例 |
---|---|
下面列举了几个形状和线条标记的示例。
|
chm= |
下例对一个数据系列使用菱形,对另一个数据系列使用圆形。 如果两个或多个标记占据同一点,则会按照标记在 |
chm= |
此折线图的每秒数据点上带有一个标记(-2 表示每隔一个点)。 |
chd=t: |
此折线图使用的标记数量是数据点的两倍(-0.5 表示每半个点)。 | chd=t: |
以下示例展示了如何使用 h 和 v 标记创建自定义颜色和粗细的网格线。将 z-order 值(最后一个值)设置为 -1,以便在数据线下方绘制网格线。 |
chm= |
此例向折线图表添加了纵向填充线:
|
chm= |
此示例使用确切坐标向图表添加了箭头和文本标记。第一个标记 D 是条形下方的轨迹线。第二个标记是箭头,第三个标记是箭头文本。 | chm= |
固定在特定数据点上的水平线 (H ) 可用于显示相对值,或强调图表上数据值的高度。 |
chm=H,FF0000,0,18,1 |
此图表演示的标记可以在 <size> 参数中指定线段粗细和长度。
|
title="cht=lc&chd=s:2gounjqLaCf,jqLaCf2goun&chco=008000,00008033&chls=2.0,4.0,1.0&chs=250x150&chm=H,990066,1,2,5,30"chm= |
文本和数据值标记 chm
[条形图、折线图、雷达图、散点图]
您可以使用自定义文本或该点的格式化版本数据为图表上的特定点加标签。
您可以使用竖线字符 ( |
) 组合任何 chm
标记来分隔 chm
参数集。
关于字符串值的说明:标签字符串中仅允许使用安全的网址字符。为安全起见,如果字符串中包含不在字符集 0-9a-zA-Z
中的字符,您应对此类字符串进行网址编码。
您可以在 Google 可视化文档中找到网址编码器。
语法
为要标记的每个系列指定以下一组参数。如需标记多个系列,请创建其他参数集,并以竖线字符分隔。您无需标记所有系列。如果您不为数据系列分配标记,则该数据系列将不会收到任何标记。
chm= <marker_type>,<color>,<series_index>,<opt_which_points>,<size>,<opt_z_order>,<opt_placement> |...| <marker_type>,<color>,<series_index>,<opt_which_points>,<size>,<opt_z_order>,<opt_placement>
- <marker_type>
- 要使用的标记类型。您可以从以下类型中进行选择:
f<text>
- 包含文本的标记。指定字符“f”,后跟自定义网址编码文本。如需对文本标记中的英文逗号进行转义,请在英文逗号前面加上 \ 标记。示例:fHello\,+World!
t<text>
- 简单的文本标记。指定字符“t”,后跟自定义网址编码文本。如需对文本标记中的英文逗号进行转义,请在英文逗号前面加上 \ 标记。示例:tHello\,+World!
A<text>
- 注释标记。这与标志标记类似,但标记会协调其位置,以免重叠。<opt_which_points> 的唯一有效格式是 opt_which_points,用于表示系列中点的索引。N<formatting_string>
- 此点的数据值,格式可选。如果您不使用chds
参数(自定义缩放),则它会提供精确的编码值;如果将该参数与任何格式类型搭配使用,则该值将缩放到您指定的范围。 请参阅下面的带有数字标记的chds
示例。在堆叠条形图中使用此标记时,如果您为 <series_index> 指定 -1,则会得到一个标记,用于显示此堆叠条形中所有值的总和。series_index格式字符串语法如下:
<preceding_text>*<number_type><decimal_places>zs<x or y>*<following_text>
.
所有这些元素都是可选的。每个元素的含义如下:<preceding_text>
- 每个值前面的文本。*...*
- 用星号括起来的可选块,您可以在该块中指定数字的格式详细信息。以下值均受支持且均为可选:<number_type>
- 数值的数字格式。选择以下任一选项:f
- [默认] 浮点格式。 也可以考虑使用 <小数位数> 值指定精度。decimal_placesp
- 百分比格式。系统会自动附加 % 符号。注意:使用此格式时,0.0 - 1.0 之间的数据值将映射到 0 - 100%(例如,0.43 将显示为 43%)。e
- 科学记数法格式。c<CUR>
- 使用相应的货币标记将数字设置为指定的货币格式。 将<CUR>
替换为由三个字母组成的货币代码。示例:cEUR
表示欧元。您可以在 ISO 网站上找到一系列代码,不过并非所有符号都受支持。
<decimal_places>
- 一个整数,用于指定要显示的小数位数。该值会四舍五入(非截断)到此长度。默认值为 2。z
- 显示尾随零。默认值为 no。s
- 显示组分隔符。默认值为“否”。x
或y
- 按指定方式显示 x 坐标或 y 坐标中的数据。x 数据的含义因图表类型而异:请使用您的图表进行实验以确定其含义。默认值为 'y'。
<following_text>
- 每个值后面的文本。
- <color>
- :此集合的标记的颜色,采用 RRGGBB 十六进制格式。
- <series_index>
- :绘制标记时所依据的数据系列中从零开始的索引。如果这是堆叠条形图且标记类型为 N(数据点值),您可以指定 -1,以为每个条形堆叠创建求和值标记。请参阅下文中的示例。
- <opt_ which_points>opt_which_points
- [可选] 要在哪个/哪些点上绘制标记。默认值为所有标记。请使用以下某个值:
n.d
- 要在哪个数据点上绘制标记,其中 n.d 是数据系列中从零开始的索引。n.d如果您指定非整数值,则小数表示计算出的中间点。例如,3.5 表示点 3 和点 4 之间的一半。-1
- 在所有数据点上绘制标记。此外,您也可以将此参数留空,以便在所有数据点上进行绘制。-n
- 在每 n 个数据点上绘制一个标记。nstart:end:n
- 在范围中的第 n 个数据点上绘制一个标记,索引值介于 start 到 end 之间(包括这两个值)。nnn所有参数都是可选的(可以不存在),因此 3::1 表示从第四个元素到最后一个元素,即第 1 步,如果完全省略此参数,则默认采用 first:last:1。所有值都可以是浮点数。start 和 end 可以为负值,以便从最后一个值开始反向计数。如果 start 和 end 均为负数,请务必以递增值列出(例如,-6:-1:1)。如果 n 步值小于 1,它将通过插值给定的数据值来计算其他数据点。n默认值为 first:last:1x:y
- [不支持 N 型标记] 在图表上的特定 x/y 点绘制标记。此点不必在线。如需使用此选项,请在标记类型之前添加 @ 字符 (@
)。以浮点值指定坐标,其中0:0
为图表的左下角,0.5:0.5
为图表的中心,1:1
为图表的右上角。例如,如需在图表中心添加一个 15 像素的红色菱形,请使用@d,FF0000,0,0.5:0.5,15
。
- <size>
- 标记的大小(以像素为单位)。如果这是包含第三个数据系列(用于指定点大小)的散点图,则此值将根据数据范围进行缩放。因此,如果数据范围为 0—100 且 <size> 为 30,则数据值 100 表示宽度为 30 像素,数据值 50 表示宽度为 15 像素,依此类推。
- <opt_z_order>
- [可选] 表示要在哪个图层上绘制标记(与其他标记和其他所有图表元素相比)。这是一个从 -1.0 到 1.0(包括 -1.0 和 1.0)的浮点数,其中 -1.0 表示底部,1.0 表示顶部。图表元素(折线和条形)正好低于零。如果两个标记的值相同,就会按照网址指定的顺序绘制它们。默认值为 0.0(正好位于图表元素的上方)。
- <opt_placement>
- [可选] 其他展示位置详情,用于说明此标记相对于数据点的放置位置。您可以指定水平和/或垂直相对定位以及偏移量。展示位置语法是一个带有 : 分隔符的字符串,如此处所示。所有元素均为可选:
<horizontal_and_vertical_justification>:<horizontal_offset>:<vertical_offset>
。 如果指定,则可以在 <opt_z_order> 的chm
参数字符串中添加空值。示例:N,000000,0,1,10,,b
、N,000000,0,1,10,,lv
和N,000000,0,1,10,,r::10
。- horizontal_and_vertical_justification
- 标记的定位点。这与对齐方式相反,因此左侧锚点实际上会将标记放在数据点的右侧。您可以从以下列表中选择一个水平和/或垂直对齐器:
- 水平放置:“l”“h”或“r”- 水平锚定,靠左、居中或右锚定。默认值为“l”。
- 垂直放置:“b”“v”“t”- 垂直底部、中间或顶部锚定。默认值为“b”。
- 条形相对位置 [仅限条形图]:“s”“c”“e”- 条形的底部、中心或顶部。对于堆叠图表,此数值是相对于每个系列的条形部分而言的,而非整个条形。如果给定的系列索引为 -1(堆叠总计),表示相对于整个条形。该值可以与垂直展示位置值结合使用:例如“be”或“vs”。 默认值为“e”。
- horizontal_offset
- 此标记的水平偏移量,以像素为单位。默认值为 0。
- vertical_offset
- 此标记的垂直偏移量,以像素为单位。非条形图默认值:15;条形图表默认值:2。
说明 | 示例 | |
---|---|---|
下面是一个条形图上的值标签示例。 第一个图表 ( 第二个图表 ( |
|
|
您可以使用 此示例展示了一个图表,其中包含简单编码值 46、39、29、30、43、41。简单编码范围为 0—61。 |
chd=s:underp |
|
下面的图表示例在最低点带有文本标签,并在最高点带有标志标签。 |
|
|
此示例展示了一个堆叠图表,其中包含各个系列的值以及系列的总计值。要显示堆叠的系列值,我们必须使用“c”定位选项;否则,顶部条形的值会与每个条形顶部的总和值重叠。 | chm= |
|
关于垂直和水平放置方式的更多演示。此示例演示了条形图的锚点值的各种组合(使用 s、c 和 e 表示垂直放置)。请注意,右侧锚点将标记向左移动,顶部锚点将标记向下移动,反之亦然。红点表示每个条形的底部、中心和顶部。 该数字是数据值,对每个条形使用不同的定位值进行固定。 | chm= |
|
注释标记会自动调整标签位置,以免重叠。第一个 chm 值用于线条填充,以下值均为注解标记。 |
chm=B,C5D4B5BB,0,0,0 |
|
另一个注释标记示例,展示了瑞士各城市的海拔。 |
范围标记 chm
[条形图、K 线图、折线图、雷达图、散点图]
您可以为背景填充的横向或纵向条带着色,以突出显示图表的特定区域。
您可以使用竖线字符 ( |
) 组合任何 chm
标记来分隔 chm
参数集。
语法
为要绘制的每个频段指定以下一组参数。如需绘制多个频段,请创建其他参数集,并以竖线字符分隔。范围是按指定顺序绘制的,因此绘制的最后一个范围将绘制在先前的范围之上。
chm= <direction>,<color>,0,<start_point>,<end_point> |...| <direction>,<color>,0,<start_point>,<end_point>
- <direction>
- 指定水平或垂直阴影。
r
表示水平范围,R
表示垂直范围。 - <color>
- 范围颜色,采用 RRGGBB 格式的十六进制数字。
- 0
- 预留 - 必须为零。
- <start_point>
- 范围的起始位置。
- 对于水平范围标记,这是 y 轴上的位置,其中
0.00
是图表的底部,1.00
是图表的顶部。 - 对于垂直范围标记,这是 x 轴上的位置,其中
0.00
表示图表的左侧,1.00
表示图表的右侧。
- <end_point>
- 范围的结束位置。
- 对于水平范围标记,这是 y 轴上的位置,其中
0.00
是图表的底部,1.00
是图表的顶部。 - 对于垂直范围标记,这是 x 轴上的位置,其中
0.00
表示图表的左侧,1.00
表示图表的右侧。
示例
说明 | 示例 |
---|---|
范围标记可以是一条细线,也可以是一条颜色条。
|
|
本例显示了垂直范围标记。第一个标记是红线 ( |
|
标记是按指定顺序绘制的。在本例中,您可以看到红色垂直标记在浅蓝色水平标记之前绘制。 |
chm= |
下面的折线图示例使用范围标记在图表的零位线、中点线和顶部绘制了穿过图表的模糊水平线。 |
|
线条标记 chm=D
[条形图、K 线图、折线图、雷达图、散点图]
您可以在图表中添加一条用于跟踪数据的线条。最常用于复合图表。
要添加多行代码(或将其与任何其他 chm
标记结合使用),请使用竖线 (|
) 分隔符分隔 chm 参数集。您不能使用此参数制作虚线标记。
语法
chm= D,<color>,<series_index>,<which_points>,<width>,<opt_z_order>
- D
- 表示这是一个线条标记。
- <color>
- 线条的颜色,采用 RRGGBB 十六进制格式。
- <series_index>
- 用于绘制线条的数据系列的索引。第一个数据系列的数据系列索引为
0
,第二个数据系列的数据系列索引为1
,依此类推。 - <what_points>which_points
- 要用系列中的哪些点来绘制线条。请使用以下某个值:
0
- 使用系列中的所有点。start:end
- 使用系列中特定的点范围(从起始值到结束值,含从零开始的索引)。您还可以使用浮点值指定中间点,或将 start 或 end 留空以分别表示第一个或最后一个数据点。start 和 end 可以为负数,作为最后一个值的反向索引。如果 start 和 end 均为负数,请务必以递增值(例如 -6:-1)写出。
- <size>
- 线条的宽度(以像素为单位)。
- <opt_z_order>
- [可选] 表示要在哪个图层上绘制标记(与其他标记和其他所有图表元素相比)。这是一个从 -1.0 到 1.0(包括 -1.0 和 1.0)的浮点数,其中 -1.0 表示底部,1.0 表示顶部。图表元素(折线和条形)正好低于零。如果两个标记的值相同,就会按照网址指定的顺序绘制它们。默认值为 0.0(正好位于图表元素的上方)。
示例
说明 | 示例 |
---|---|
此示例展示了如何在条形图上绘制标记线。
Z 轴顺序设置为 |
chm=D,0033FF,0,0,5,1 |
此条形图为同一个条形图,但为折线额外提供了一个数据系列。这是一个复合图表的示例。
复合图表的绘制方式是:向 如需了解详情,请参阅复合图表。 |
chm=D,0033FF,1,0,5,1 |
数据函数 chfd
[所有chd
图表]
您可以使用 muParser 函数语法指定一个自定义函数来针对图表数据运行。函数中使用的数据可出自以下两个来源:
- 来自
chd
的数据系列 - 数据是从chd
中的指定系列中提取的。 chfd
参数本身中声明的一系列值 - 您可以声明任意数据范围的起始值、停止值和步进值。
请务必注意,在任何情况下,您都必须将输出分配给 chd
中的现有序列;该序列将被函数输出结果覆盖。系统仅在所有函数均处理完毕后才会渲染图表,因此,如果您分配多个函数要输出到同一数据系列,这些函数将按给定顺序运行,但图表上只会绘制最终函数的输出。请注意,您可以链接函数,以便一个函数可以接受上一个函数输出的系列作为输入。
如需为函数行分配颜色或 chm
标记,请为函数系列索引分配颜色或标记。请注意,在函数处理数据后,系统会根据数据放置标记。
语法
chfd= <output_series_index>,<function_data>,<function_string> |...| <output_series_index>,<function_data>,<function_string>
- <output_series_indexoutput_series_index>
chd
中数据系列(函数输出将写入的位置)的从零开始的索引。任何现有数据都将被函数输出完全覆盖。如果某个系列未用作函数的输入,则最佳实践是为该系列分配一个虚拟值。- <function_data>
- 绘制的变量和数据。数据可以来自您定义的范围,也可以来自某个
chd
数据系列。您可以为每个函数指定多个变量,使用 ;(分号)分隔符分隔多个变量。请注意,如果您为单个函数定义了多个变量,并且这些变量的点数不同,则该函数会在到达第一个端点时停止。例如,如果某个函数同时定义了 x=1—5 step 1 和 y=1—10 step 1,则该函数会在到达第五个点时结束。
<variable_name>,<input_series_index>
或
<variable_name>,<start>,<end>,<step>
- variable_name - 变量的任意字符串名称。 在 function_string 定义的函数中使用此字符串。
- input_series_index - 要用作输入数据的
chd
数据系列的索引。 - start - 范围的起始数值。
- end - 范围的结束数值。
- step - 从 start 到 end 的数值步进值。正值或负值均可,但不可为零。
x,0,100,1
声明了一个名为x
且值为 0、1、2 ... 100 的变量。x,0,100,1;r,0,3.1,.1
声明相同的x
变量以及一个名为r
且值为 0、0.1、0.2、...、3.0、3.1 的变量。x,0
声明了一个名为 x 的变量,该变量使用第一个chd
系列中的数据。这些变量将供 function_string 使用。 除非您在 function_string 中指定这些参数,否则系统不会将其绘制在图表上。阶值越小,图表越平滑。 - <function_string>function_string
- 您的函数,使用 muParser 语法编写。该函数会应用于 variable_data 中指定的变量和数据。
您只能引用此本地函数集中声明的变量,而不能引用另一个以管道形式表示的
chfd
参数集中的变量。不支持 Summary muParser 函数(min、maxsum、avg)。重要提示:请务必在函数中使用%2B
,而不是+
!
示例
说明 | 示例 |
---|---|
简单的正弦波。需要注意以下几点:
|
cht=lc |
此行使用 chd 参数中的数据。 |
chd=t:5,10 |
函数线和非函数线的组合。 请注意颜色是通过系列颜色参数 请注意函数输出中标记的放置;数据点是根据 start、end 和 step 计算得出的,因此,如果您的范围是 0—11 step 0.1,则点 0 为 0,点 1 为 0.1,以此类推,直到点 110,其值为 11。 |
chd=t: |
如需在二维空间中定义函数,请使用
|
cht=lxy |
试着点击这些图片,在图表园地中将其打开并玩一玩;您一定会爱上它! |