# scatter
散点图
函数库: TyPlot
# 语法
scatter(x,y)
scatter(x,y,s)
scatter(x,y,s,c)
scatter(___,Key=Value)
scatter(ax,___)
s = scatter(___)
# 说明
scatter(X,Y) 在向量 x 和 y 指定的位置创建一个包含圆形的散点图。该类型的图形也称为气泡图。示例
scatter(X,Y,s) 指定圆大小。要绘制大小相等的圆圈，请将 s 指定为标量。要绘制大小不等的圆，请将 s 指定为长度等于 x 和 y 的长度的向量。示例
scatter(X,Y,s,c) 指定圆颜色。要以相同的颜色绘制所有圆圈，请将 c 指定为颜色名称或 RGB 三元组。要使用不同的颜色，请将 c 指定为向量或由 RGB 三元组组成的三列矩阵。示例
scatter(___,Key=Value) 使用一个或多个名称-值对组参数修改散点图。有关属性列表，请参见 scatter 属性。例如，"linewidth=2"将标记轮廓宽度设置为2磅。示例
scatter(ax,___) 将在 ax 指定的坐标区中，而不是在当前坐标区中绘制图形。选项 ax 可以位于前面的语法中的任何输入参数组合之前。示例
s=scatter(___)返回 Scatter 对象。在创建散点图后，以后可使用 s 对其进行修改，请参见 scatter 属性。示例
# 示例
创建散点图
创建 x 为 0 和 3π 之间的 200 个等间距值。创建 y 为带随机干扰的余弦值。然后，创建一个散点图。
using TyPlot
x = LinRange(0, 3 * pi, 200)
y = cos.(x) + rand(200)
scatter(x, y)
改变圆圈大小
使用大小不同的圆圈创建一个散点图。以平方磅为单位指定大小。
using TyPlot
x = LinRange(0, 3 * pi, 200)
y = cos.(x) + rand(200)
s = LinRange(1, 100, 200)
scatter(x, y; s=s)
x、y 和 s 中的相应元素确定每个圆圈的位置和大小。要按照相同的面积绘制所有圆圈，请将 s 指定为数值标量。
改变圆圈颜色
创建一个散点图并改变圆圈的颜色。
using TyPlot
x = LinRange(0, 3 * pi, 200)
y = cos.(x) + rand(200)
c = LinRange(1, 10, length(x))
s = scatter(x, y; c=c)
x、y 和 c 中的相应元素确定每个圆形的位置和颜色。scatter 函数将 c 中的元素映射到当前颜色图中的元素。
填充标记
创建一个散点图并填充标记。scatter 使用标记边的颜色填充每个标记。
using TyPlot
x = LinRange(0, 3 * pi, 200)
y = cos.(x) + rand(200)
s = 25
c = LinRange(1, 10, length(x))
scatter(x, y, s, c; filled=true)
指定标记符号
创建向量 x 和 y，作为带随机干扰的正弦和余弦值。然后，创建一个散点图，并使用面积为 140 平方磅的菱形标记。
using TyPlot
theta = LinRange(0, 2 * pi, 150)
x = sin.(theta) + 0.75 .* rand(150)
y = cos.(theta) + 0.75 .* rand(150)
s = 140
scatter(x, y, s; marker="d")
更改标记颜色和线条宽度
创建向量 x 和 y，作为带随机干扰的正弦和余弦值。创建一个散点图并设置标记边颜色、标记面颜色和线条宽度。
using TyPlot
theta = LinRange(0, 2 * pi, 300)
x = sin.(theta) + 0.75 .* rand(300)
y = cos.(theta) + 0.75 .* rand(300)
s = 40
scatter(x, y, s; linewidths=1.5, markeredgecolor=[0 0.5 0.5], markerfacecolor=[0 0.7 0.7])
指定目标坐标区和标记类型
调用 subplot 函数以创建一个 2×1 分块图布局和一个坐标区对象 ax1 和 ax2 。将在每个坐标区中绘制散点数据。在底部散点图中，指定使用实心菱形标记。
using TyPlot
x = LinRange(0, 3 * pi, 200)
y = cos.(x) + rand(200)
ax1 = subplot(2, 1, 1)
scatter(ax1, x, y)
ax2 = subplot(2, 1, 2)
scatter(ax2, x, y; filled=true, marker="d")
创建并修改散点序列
创建一个散点图并返回散点序列对象 s。
using TyPlot
theta = LinRange(0, 1, 500);
x = exp.(theta) .* sin.(100 * theta);
y = exp.(theta) .* cos.(100 * theta);
s = scatter(x, y)
在创建散点序列后，使用 s 查询并设置其属性。将线宽设置为 0.6 磅。将标记边颜色设置为蓝色。使用 RGB 三元组颜色设置标记面。
s.set_linewidth(0.6)
s.set_edgecolor("b");
s.set_facecolor([0 0.5 0.5])
plt_update()
# 输入参数
x - x 值向量
x 值，指定为向量。x 和 y 必须是长度相等的向量。
数据类型： Int16 | Int32 | Int64 | Float16 | Float32 | Float64 | DateTime
y - y 值向量
y 值，指定为向量。x 和 y 必须是长度相等的向量。
数据类型： Int16 | Int32 | Int64 | Float16 | Float32 | Float64 | DateTime
s - 标记面积36 （默认） | 数值标量 | 行或列向量 | []
以平方磅为单位的标记面积，指定为下列形式之一：
- 数值标量 - 以相同的大小绘制所有标记；
- 行或列向量 - 使每个标记具有不同的大小。x、y 和 s 中的相应元素确定每个标记的位置和面积。s 的长度必须等于 x 和 y 的长度。
标记面积的单位为平方磅。
示例： 50
示例： [36 25 25 17 46]
c - 标记颜色[0,0,1] （默认） | RGB 三元组 | 由 RGB 三元组组成的三列矩阵 | 向量 | "r" | "g" | "b" | ...
标记颜色，指定为下列形式之一：
- RGB 三元组或颜色名称 - 使用相同的颜色绘制所有标记；
- 由 RGB 三元组组成的三列矩阵 - 对每个标记使用不同的颜色。矩阵的每行为对应标记指定一种 RGB 三元组颜色。行数必须等于 x 和 y 的长度；
- 向量 - 对每个标记使用不同的颜色，并以线性方式将 c 中的值映射到当前颜色图中的颜色。c 的长度必须等于 x 和 y 的长度。要更改坐标区的颜色图，请使用 colormap 函数。
如果散点图中有三个点，并且您希望这些颜色成为颜色图的索引，请以三元素列向量的形式指定 c。
RGB 三元组是包含三个元素的行向量，其元素分别指定颜色中红、绿、蓝分量的强度。强度值必须位于 [0,1] 范围内，例如 [0.4, 0.6, 0.7]。此外，还可以按名称指定一些常见的颜色。下表列出长和短颜色名称选项以及对应的 RGB 三元组值。
| 选项 | 说明 | 对应的 RGB 三元组 |
|---|---|---|
| "red" 或 "r" | 红色 | [1,0,0] |
| "green" 或 "g" | 绿色 | [0,1,0] |
| "blue" 或 "b" | 蓝色 | [0,0,1] |
| "yellow" 或 "y" | 黄色 | [1,1,0] |
| "magenta" 或 "m" | 品红色 | [1,0,1] |
| "cyan" 或 "c" | 青蓝色 | [0,1,1] |
| "white" 或 "w" | 白色 | [1,1,1] |
| "black" 或 "k" | 黑色 | [0,0,0] |
示例： "k"
示例： [0,0,0]
ax - 目标坐标区Axes 对象 | PolarAxes 对象
目标坐标区，指定为 Axes 对象、PolarAxes 对象。如果不指定坐标区或当前坐标区是笛卡尔坐标区，scatter 函数将使用当前坐标区。要在极坐标区上绘图，请指定 PolarAxes 对象作为第一个输入参数，或者使用 polarscatter 函数。
# 名称-值对组参数
指定可选的、以逗号分隔的 Key=Value 对组参数。Key 为参数名称，Value 为对应的值。您可采用任意顺序指定多个名称-值对组参数，如 Key1=Value1,...,KeyN=ValueN 所示。
示例： markerfacecolor="red" 将标记面颜色设置为红色。
此处列出的 Scatter 对象属性只是其中的一部分。有关完整列表，请参见 scatter 属性。
label - 图例nothing（默认） | 字符串 | 数值
label 图例，默认 nothing，使用默认数据 data1 标记图形对象。如果设置了图例则以图例内容标记图形对象。
marker - 标记类型"o" （默认） | "+" | "*" | "." | "x" | ...
标记类型，指定为下表中列出的值之一。
| 值 | 说明 |
|---|---|
| "o" | 圆圈 |
| "+" | 加号 |
| "*" | 星号 |
| "." | 点 |
| "x" | 叉号 |
| "_" | 水平线条 |
| "|" | 垂直线条 |
| "square" 或 "s" | 方形 |
| "diamond" 或 "d" | 菱形 |
| "^" | 上三角 |
| "v" | 下三角 |
| ">" | 右三角 |
| "<" | 左三角 |
| "pentagram" 或 "p" | 五角星（五角形） |
| "hexagram" 或 "h" | 六角星（六角形） |
| "none" | 无标记 |
filled - 用于填充标记内部的选项true | 默认为false
用于填充标记内部的选项，指定为 "filled"。此选项和具有一个面的标记（例如，"o" 或 "square"）一起使用。没有面而只有边的标记无法填充，如 "+"、"*"、"." 和 "x"。
s - 标记面积36 （默认） | 数值标量 | 行或列向量 | []
以平方磅为单位的标记面积，指定为下列形式之一：
- 数值标量 - 以相同的大小绘制所有标记；
- 行或列向量 - 使每个标记具有不同的大小。x、y 和 s 中的相应元素确定每个标记的位置和面积。s 的长度必须等于 x 和 y 的长度。
标记面积的单位为平方磅。
示例： 50
示例： [36 25 25 17 46]
c - 标记颜色[0,0,1] （默认） | RGB 三元组 | 由 RGB 三元组组成的三列矩阵 | 向量 | "r" | "g" | "b" | ...
标记颜色，指定为下列形式之一：
- RGB 三元组或颜色名称 - 使用相同的颜色绘制所有标记；
- 由 RGB 三元组组成的三列矩阵 - 对每个标记使用不同的颜色。矩阵的每行为对应标记指定一种 RGB 三元组颜色。行数必须等于 x 和 y 的长度；
- 向量 - 对每个标记使用不同的颜色，并以线性方式将 c 中的值映射到当前颜色图中的颜色。c 的长度必须等于 x 和 y 的长度。要更改坐标区的颜色图，请使用 colormap 函数。
如果散点图中有三个点，并且您希望这些颜色成为颜色图的索引，请以三元素列向量的形式指定 c。
RGB 三元组是包含三个元素的行向量，其元素分别指定颜色中红、绿、蓝分量的强度。强度值必须位于 [0,1] 范围内，例如 [0.4, 0.6, 0.7]。此外，还可以按名称指定一些常见的颜色。下表列出长和短颜色名称选项以及对应的 RGB 三元组值。
| 选项 | 说明 | 对应的 RGB 三元组 |
|---|---|---|
| "red" 或 "r" | 红色 | [1,0,0] |
| "green" 或 "g" | 绿色 | [0,1,0] |
| "blue" 或 "b" | 蓝色 | [0,0,1] |
| "yellow" 或 "y" | 黄色 | [1,1,0] |
| "magenta" 或 "m" | 品红色 | [1,0,1] |
| "cyan" 或 "c" | 青蓝色 | [0,1,1] |
| "white" 或 "w" | 白色 | [1,1,1] |
| "black" 或 "k" | 黑色 | [0,0,0] |
示例： "k"
示例： [0,0,0]
markeredgecolor - 标记轮廓颜色RGB 三元组 | 十六进制颜色代码 | "r" | "g" | "b" |
标记轮廓颜色，指定为 RGB 三元组、十六进制颜色代码、颜色名称或短名称。
对于自定义颜色，请指定 RGB 三元组或十六进制颜色代码。
- RGB 三元组是包含三个元素的行向量，其元素分别指定颜色中红、绿、蓝分量的强度。强度值必须位于 [0,1] 范围内，例如 [0.4, 0.6, 0.7]；
- 十六进制颜色代码是字符向量或字符串标量，以井号 (#) 开头，后跟三个或六个十六进制数字，范围可以是 0 到 F。 这些值不区分大小写。因此，颜色代码 "#FF8800" 与 "#ff8800"、"#F80" 与 "#f80" 是等效的。
此外，还可以按名称指定一些常见的颜色。下表列出了命名颜色选项、等效 RGB 三元组和十六进制颜色代码。
| 颜色名称 | 短名称 | RGB 三元组 | 十六进制颜色代码 | 外观 |
|---|---|---|---|---|
| "red" | "r" | [1, 0, 0] | "#FF0000" |  |
| "green" | 不适用 | [0, 0.5019607843137255, 0] | "#008000" |  |
| 不适用 | "g" | [0, 0.5, 0] | "#007F00" | |
| 不适用 | 不适用 | [0, 1, 0] | "#00FF00" |  |
| "blue" | "b" | [0, 0, 1] | "#0000FF" |  |
| "cyan" | 不适用 | [0, 1, 1] | "#00FFFF" |  |
| 不适用 | "c" | [0, 0.75, 0.75] | "#00BFBF" |  |
| "magenta" | 不适用 | [1, 0, 1] | "#FF00FF" |  |
| 不适用 | "m" | [0.75, 0, 0.75] | "#BF00BF" |  |
| "yellow" | 不适用 | [1, 1, 0] | "#FFFF00" |  |
| 不适用 | "y" | [0.75, 0.75, 0] | "#BFBF00" |  |
| "black" | "k" | [0, 0, 0] | "#000000" |  |
| "white" | "w" | [1, 1, 1] | "#FFFFFF" |  |
| "none" | 不适用 | 不适用 | 不适用 | 无颜色 |
以下是 Syslab 在许多类型的绘图中使用的默认颜色的 RGB 三元组和十六进制颜色代码。
| RGB 三元组 | 十六进制颜色代码 | 外观 |
|---|---|---|
| [0, 0.4470, 0.7410] | "#0072BD" |  |
| [0.8500, 0.3250, 0.0980] | "#D95319" |  |
| [0.9290, 0.6940, 0.1250] | "#EDB120" |  |
| [0.4940, 0.1840, 0.5560] | "#7E2F8E" |  |
| [0.4660, 0.6740, 0.1880] | "#77AC30" |  |
| [0.3010, 0.7450, 0.9330] | "#4DBEEE" |  |
| [0.6350, 0.0780, 0.1840] | "#A2142F" |  |
示例： [0.5,0.5,0.5]
示例： "blue"
示例： "#D2F9A7"
markerfacecolor - 标记填充颜色"none" （默认）| RGB 三元组 | 十六进制颜色代码 | "r" | "g" | "b" | ...
标记填充颜色，指定为 RGB 三元组、十六进制颜色代码、颜色名称或短名称。
对于自定义颜色，请指定 RGB 三元组或十六进制颜色代码。
- RGB 三元组是包含三个元素的行向量，其元素分别指定颜色中红、绿、蓝分量的强度。强度值必须位于 [0,1] 范围内，例如 [0.4, 0.6, 0.7]；
- 十六进制颜色代码是字符向量或字符串标量，以井号 (#) 开头，后跟三个或六个十六进制数字，范围可以是 0 到 F。 这些值不区分大小写。因此，颜色代码 "#FF8800" 与 "#ff8800"、"#F80" 与 "#f80" 是等效的。
此外，还可以按名称指定一些常见的颜色。下表列出了命名颜色选项、等效 RGB 三元组和十六进制颜色代码。
| 颜色名称 | 短名称 | RGB 三元组 | 十六进制颜色代码 | 外观 |
|---|---|---|---|---|
| "red" | "r" | [1, 0, 0] | "#FF0000" | |
| "green" | 不适用 | [0, 0.5019607843137255, 0] | "#008000" | |
| 不适用 | "g" | [0, 0.5, 0] | "#007F00" | |
| 不适用 | 不适用 | [0, 1, 0] | "#00FF00" | |
| "blue" | "b" | [0, 0, 1] | "#0000FF" | |
| "cyan" | 不适用 | [0, 1, 1] | "#00FFFF" | |
| 不适用 | "c" | [0, 0.75, 0.75] | "#00BFBF" | |
| "magenta" | 不适用 | [1, 0, 1] | "#FF00FF" | |
| 不适用 | "m" | [0.75, 0, 0.75] | "#BF00BF" | |
| "yellow" | 不适用 | [1, 1, 0] | "#FFFF00" | |
| 不适用 | "y" | [0.75, 0.75, 0] | "#BFBF00" | |
| "black" | "k" | [0, 0, 0] | "#000000" | |
| "white" | "w" | [1, 1, 1] | "#FFFFFF" | |
| "none" | 不适用 | 不适用 | 不适用 | 无颜色 |
以下是 Syslab 在许多类型的绘图中使用的默认颜色的 RGB 三元组和十六进制颜色代码。
| RGB 三元组 | 十六进制颜色代码 | 外观 |
|---|---|---|
| [0, 0.4470, 0.7410] | "#0072BD" | |
| [0.8500, 0.3250, 0.0980] | "#D95319" | |
| [0.9290, 0.6940, 0.1250] | "#EDB120" | |
| [0.4940, 0.1840, 0.5560] | "#7E2F8E" | |
| [0.4660, 0.6740, 0.1880] | "#77AC30" | |
| [0.3010, 0.7450, 0.9330] | "#4DBEEE" | |
| [0.6350, 0.0780, 0.1840] | "#A2142F" | |
示例： [0.3,0.2,0.1]
示例： "green"
示例： "#D2F9A7"
linewidth - 标记边的宽度0.5 （默认） | 正值
标记边的宽度，指定为一个正值（以磅为单位）。
示例： 0.75
# 输出参数
s - Scatter 对象Scatter 对象
Scatter 对象。这些是唯一标识符，可以用来查询和修改特定图形散点的属性。有关属性列表，请参见 scatter 属性。
示例： 使用 plt_get 函数获取散点属性：
plt_get(h,"linewidth") 获取图形散点对象标记边的宽度；
plt_get(h,"markeredgecolor") 获取图形散点对象的轮廓颜色。
示例： 使用 plt_set 函数设置散点属性：
plt_set(h,"linewidth",3) 设置图形散点对象标记边的宽度；
plt_set(h,"markeredgecolor","r") 设置图形散点对象的轮廓颜色。
# 另请参阅
# 函数
gca | hold | legend | loglog | scatter3 | title | xlabel | xlim | ylabel | ylim