# scatter3
三维散点图
函数库: TyPlot
# 语法
scatter3(X,Y,Z)
scatter3(___,Key=Value)
scatter3(ax,___)
h = scatter3(___)
# 说明
scatter3(X,Y,Z) 在向量 X、Y 和 Z 指定的位置显示圆圈。示例
scatter3(___,Key=Value) 使用一个或多个名称-值对组参数修改散点图。有关属性列表，请参见 scatter 属性。示例
scatter3(ax,___) 将图形绘制到 ax 指定的坐标区中，而不是当前坐标区 (gca) 中。选项 ax 可以位于前面的语法中的任何输入参数组合之前。示例
h=scatter3(___) 返回 Scatter 对象。在创建散点图后，可使用 h 修改其属性，请参见 scatter 属性。示例
# 示例
创建三维散点图
导入 0-sphere(16).jl 文件，创建三维散点图。使用 sphere 定义向量 x、y 和 z。
using TyPlot
pkg_dir = pkgdir(TyPlot)
source_path = pkg_dir * "/examples/scatter3/0-sphere(16).jl"
include(source_path)
figure()
s = scatter3(x, y, z)
改变标记大小
导入 0-sphere(16).jl 文件，使用 sphere 定义向量 x、y 和 z。定义向量 s 可指定标记大小。创建一个三维散点图。
using TyPlot
pkg_dir = pkgdir(TyPlot)
source_path = pkg_dir * "/examples/scatter3/0-sphere(16).jl"
include(source_path)
figure()
scatter3(x,y,z,s=s)
plt_view(40, 35)
x、y、z 和 s 中的相应项确定每个标记的位置和大小。
改变标记颜色
导入 0-sphere(16).jl 文件，使用 sphere 定义向量 x、y 和 z。定义向量 s 和 c 以指定每个标记的大小和颜色。创建一个三维散点图。
using TyPlot
pkg_dir = pkgdir(TyPlot)
source_path = pkg_dir * "/examples/scatter3/0-sphere(16).jl"
include(source_path)
figure()
s = scatter3(x, y, z; s=s, c=c)
plt_view(40, 35)
x、y、z 和 c 中的相应项确定每个标记的位置和颜色。
填充标记
将向量 x 和 y 创建为带随机干扰的余弦和正弦值。
using TyPlot
z = LinRange(0, 4 * pi, 250);
x = 2 .* cos.(z) .+ rand(250);
y = 2 .* sin.(z) .+ rand(250);
创建一个三维散点图并填充标记。
scatter3(x, y, z, filled = true)
plt_view(-30, 10)
设置标记类型
初始化随机数生成器以使 rand 的输出可重复。将向量 x 和 y 定义为带随机干扰的余弦和正弦值。
using TyPlot
z = LinRange(0, 4 * pi, 250);
x = 2 .* cos.(z) .+ rand(250);
y = 2 .* sin.(z) .+ rand(250);
创建一个三维散点图并设置标记类型。
scatter3(x, y, z, marker = "*")
plt_view(-30, 10)
设置标记属性
初始化随机数生成器以使 rand 的输出可重复。将向量 x 和 y 定义为带随机干扰的余弦和正弦值。
using TyPlot
z = LinRange(0, 4 * pi, 250)
x = 2 .* cos.(z) .+ rand(250);
y = 2 .* sin.(z) .+ rand(250);
创建一个三维散点图并设置标记边颜色和标记面颜色。
scatter3(x, y, z, markeredgecolor = "k", markerfacecolor = [0 0.75 0.75])
plt_view(-30, 10)
指定三维散点图的坐标区
导入 0-seamount.jl 文件，调用 subplot 函数以创建一个 2×1 分块图布局和一个坐标区对象 ax1 和 ax2。加载 seamount 数据集以获取向量 x、y 和 z。然后通过将坐标区对象指定为 scatter3 的第一个参数，在坐标区中创建单独的散点图。
using TyPlot
pkg_dir = pkgdir(TyPlot)
source_path = pkg_dir * "/examples/scatter3/0-seamount.jl"
include(source_path)
ax1 = subplot(2, 1, 1; projection="3d")
scatter3(ax1, x, y, z; markerfacecolor=[0 0.75 0.75])
ax2 = subplot(2, 1, 2; projection="3d")
scatter3(ax2, x, y, z; marker="*")
使用句柄设置散点序列属性
导入 0-sphere(16).jl 文件，创建向量 x、y 和 z。创建向量 s 和 c 以指定每个标记的大小和颜色。创建一个三维散点图并返回散点序列对象。
using TyPlot
pkg_dir = pkgdir(TyPlot)
source_path = pkg_dir * "/examples/scatter3/0-sphere(16).jl"
include(source_path)
s = [s...]
figure()
s = scatter3(x, y, z; s=s, c=c)
使用 RGB 三元组颜色值设置标记面颜色。使用圆点表示法设置属性。
s.set_facecolor([0 0.5 0.5])
plt_update()
# 输入参数
X - x 值向量
x 值，指定为向量。X、Y 和 Z 必须是长度相等的向量。
数据类型： Int16 | Int32 | Int64 | Float16 | Float32 | Float64 | DateTime
Y - y 值向量
y 值，指定为向量。X、Y 和 Z 必须是长度相等的向量。
数据类型： Int16 | Int32 | Int64 | Float16 | Float32 | Float64 | DateTime
Z - z 值向量
z 值，指定为向量。X、Y 和 Z 必须是长度相等的向量。
数据类型： Int16 | Int32 | Int64 | Float16 | Float32 | Float64 | DateTime
ax - 坐标区对象坐标区对象
坐标区对象。如果未指定坐标区，则 scatter3 在当前坐标区中绘图。
# 名称-值对组参数
指定可选的、以逗号分隔的 Key=Value 对组参数。Key 为参数名称，Value 为对应的值。您可采用任意顺序指定多个名称-值对组参数，如 Key1=Value1,...,KeyN=ValueN 所示。
示例： markerfacecolor="red" 将标记面颜色设置为红色。
此处列出的 Scatter 对象属性只是其中的一部分。有关完整列表，请参见 scatter 属性。
s - 标记面积36 （默认） | 标量 | 向量 | nothing
标记面积，指定为标量、向量或者 nothing。S 中的值必须为正数。面积的单位是平方磅。
- 如果 S 为标量，则 scatter3 绘制具有指定面积的所有标记；
- 如果 S 为行或列向量，则 S 中的每个项指定相应标记的面积。S 的长度必须等于 X、Y 和 Z 的长度。X、Y、Z 和 S 中的相应项确定每个标记的位置和面积；
- 如果 S 为 nothing，将使用默认大小 36 平方磅。
示例： 50
示例： [36,25,25,17,46]
c - 标记颜色[0 0 1] （蓝色）（默认） | RGB 三元组 | 由 RGB 三元组组成的三列矩阵 | 向量 | "r" | "g" | "b" | ...
标记颜色，指定为 RGB 三元组、由 RGB 三元组组成的三列矩阵、向量或者下表中的颜色选项之一。
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] |
如果散点图中有三个点，并且您希望这些颜色成为颜色图的索引，请以三元素列向量的形式指定 C。
示例： "y"
示例： [1,2,3,4]
label - 图例nothing（默认） | 字符串 | 数值
label 图例，默认 nothing，使用默认数据 data1 标记图形对象。如果设置了图例则以图例内容标记图形对象。
marker - 标记"o" （默认） | "+" | "*" | "." | "x" | ...
标记，指定为下表中的标记之一。
| 值 | 说明 |
|---|---|
| "o" | 圆圈 |
| "+" | 加号 |
| "*" | 星号 |
| "." | 点 |
| "x" | 叉号 |
| "square" 或 "s" | 方形 |
| "diamond" 或 "d" | 菱形 |
| "^" | 上三角 |
| "v" | 下三角 |
| ">" | 右三角 |
| "<" | 左三角 |
| "pentagram" 或 "p" | 五角星（五角形） |
| "hexagram" 或 "h" | 六角星（六角形） |
| "none" | 无标记 |
linewidth - 标记边的宽度0.5 （默认） | 正值
标记边的宽度，指定为一个正值（以磅为单位）。
示例： 0.75
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" （默认）| auto" | | RGB 三元组 | 十六进制颜色代码 | "r" | "g" | "b" | ...
标记填充颜色，指定为 "auto"、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"
# 输出参数
h - Scatter 对象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") 设置图形散点对象的轮廓颜色。
# 旋转视角
使用 Syslab 旋转图形视角方法：将鼠标光标置于 Figure 窗口图形对象的空白处，按住鼠标左键，拖动鼠标可以旋转三维坐标轴的视角。
