主要内容

histogram2

二元直方图的阴谋

描述

二元直方图是一种酒吧情节为数值数据组数据为二维垃圾箱。在您创建一个Histogram2直方图的对象,您可以修改方面通过改变其属性值。这是特别有用的快速修改箱子的属性或更改显示。

创建

描述

例子

histogram2 (X, Y)创建一个二元直方图的情节XY。的histogram2函数使用一个自动装箱算法返回垃圾箱均匀区域,选择封面元素的范围XY并揭示底层的形状分布。histogram2显示了垃圾箱等三维矩形酒吧,每个酒吧的高度指示元素的数量。

例子

histogram2 (X, Y,nbins)指定的垃圾箱使用直方图的每个维度。

例子

histogram2 (X, Y,Xedges,Yedges)指定垃圾箱的边缘在每个维度使用向量XedgesYedges

histogram2 (“XBinEdges”,Xedges“YBinEdges”,Yedges“BinCounts”,计数)手动指定容器的数量。histogram2情节指定本装箱数量,不做任何数据。

例子

histogram2 (___,名称,值)与一个或多个指定附加选项名称,值对参数使用任何以前的语法。例如,您可以指定“BinWidth”和一个双元素向量调整箱子的宽度在每个维度,或“归一化”使用有效的选项(“数”,“概率”,“countdensity”,“pdf”,“cumcount”,或“提供”)使用不同类型的正常化。一个属性列表,看到Histogram2属性

histogram2 (斧头,___)情节到指定的轴斧头而不是到当前轴(gca)。的选项斧头可以先于任何输入参数组合的以前的语法。

例子

h= histogram2 (___)返回一个Histogram2对象。使用这种检查和调整二元直方图的属性。一个属性列表,看到Histogram2属性

输入参数

全部展开

数据分发在垃圾箱中,指定为独立的参数向量,矩阵或多维数组。XY必须是相同的大小。如果XY不是矢量,然后呢histogram2把他们当作一个列向量,X (:)Y (:),情节一个直方图。

对应的元素XY指定xy二维数据点的坐标,[X (k), Y (k)]。的数据类型XY可以不同,但histogram2这些输入合并到一个连接N——- - - - - -2矩阵的主要数据类型。

histogram2忽略所有值。同样的,histogram2忽略了值,除非本边缘显式地指定作为一个本边缘。虽然,,价值观通常不是策划,他们仍然包含在归一化计算,包括数据元素的总数,等“概率”

请注意

如果XY包含整数类型的int64uint64更大比flintmax,那么建议您显式地指定直方图本边缘。histogram2使用双精度自动垃圾箱的输入数据,缺乏精度整数数字大于flintmax

数据类型:||int8|int16|int32|int64|uint8|uint16|uint32|uint64|逻辑

每个维度的箱子数量,指定为一个积极的标量整数或双元素向量的正整数。如果你不指定nbins,然后histogram2自动计算有多少箱子使用基于中的值XY

  • 如果nbins是一个标量,然后呢histogram2使用每个维度中,许多垃圾箱。

  • 如果nbins是一个矢量,然后呢nbins (1)指定的箱数x尺寸和nbins (2)指定的箱数y维度。

例子:histogram2 (X, Y, 20)使用每个维度中20箱。

例子:histogram2 (X, Y, 20 [10])使用10箱x维度和20箱y维度。

本的边缘x维度,指定为一个向量。Xedges (1)是第一个边缘的第一本吗x维度,Xedges(结束)是最后一本的外缘。

的值[X (k), Y (k)]是在(i, j)th本如果Xedges(我)X (k)<Xedges (i + 1)Yedges (j)Y (k)<Yedges (j + 1)。每个维度还包括过去的最后一个箱子(外部)优势。例如,[X (k), Y (k)]落入本在最后一行Xedges (end-1)X (k)Xedges(结束)Yedges(我)Y (k)<Yedges (i + 1)

数据类型:||int8|int16|int32|int64|uint8|uint16|uint32|uint64|逻辑

本的边缘y维度,指定为一个向量。Yedges (1)是第一个边缘的第一本吗y维度,Yedges(结束)是最后一本的外缘。

的值[X (k), Y (k)]是在(i, j)th本如果Xedges(我)X (k)<Xedges (i + 1)Yedges (j)Y (k)<Yedges (j + 1)。每个维度还包括过去的最后一个箱子(外部)优势。例如,[X (k), Y (k)]落入本在最后一行Xedges (end-1)X (k)Xedges(结束)Yedges(我)Y (k)<Yedges (i + 1)

数据类型:||int8|int16|int32|int64|uint8|uint16|uint32|uint64|逻辑

本数量,指定为一个矩阵。使用该输入通过本计数histogram2当本数量分别进行计算,你不希望histogram2做任何数据装箱。

计数必须是一个矩阵的大小[长度(XBinEdges) 1 (YBinEdges) 1]所以它指定本计数为每个垃圾箱。

例子:histogram2 (XBinEdges, 1:1, YBinEdges, 2:2, BinCounts, (1 2 3 4;5 6 7 8])

坐标轴对象。如果你不指定一个坐标轴,那么histogram2函数使用当前轴(gca)。

名称-值对的观点

指定可选的逗号分隔条名称,值参数。的名字参数名称和吗价值相应的价值。的名字必须出现在引号。您可以指定几个名称和值对参数在任何顺序Name1, Value1,…,的家

例子:histogram2 (X, Y, BinWidth, 10 [5])

这里列出的属性是唯一的一个子集。一个完整的列表,请参阅Histogram2属性

装箱算法,在这个表指定为一个值。

价值 描述
“汽车”

默认的“汽车”算法选择本宽度的数据范围,揭示潜在分布的形状。

“斯科特。”

斯科特的规则是最优如果数据共同接近正态分布。这条规则是适合大多数其他发行版,。它使用一个本的大小[3.5 *性病(X(:)) *元素个数(X) ^(1/4), 3.5 *性病(Y(:)) *元素个数(Y) ^ (1/4)

“fd”

Freedman-Diaconis规则对数据中离群值不敏感,,可能更适合数据和重尾分布。它使用一个本的大小[2 *差(X(:)) *元素个数(X) ^(1/4), 2 *差(Y(:)) *元素个数(Y) ^ (1/4),在那里位差四分位范围。

“整数”

整数与整数数据规则是有用的,因为它创造了垃圾箱集中在对整数。它使用一个本的宽度为每个维度和地方本边缘介于1整数。

为了避免意外地创建太多的垃圾箱,您可以使用这个规则来创建一个限制1024箱(210)。如果数据范围尺寸大于1024,然后整规则使用广泛的垃圾箱。

histogram2并不总是选择使用这些箱子的数量准确的公式。有时垃圾箱的数量略有调整,这样本边落在“好”的数字。

请注意

如果你设置NumBins,XBinEdges,YBinEdges,BinWidth,XBinLimits,或YBinLimits属性,那么BinMethod属性设置为“手动”

例子:histogram2 (X, Y,“BinMethod”、“整数”)创建一个二维直方图的垃圾箱集中在对整数。

箱子的宽度在每个维度,指定为一个双元素向量的正整数,[xWidth yWidth]

如果您指定BinWidth,然后histogram2最多可以使用1024箱(210在每个维度)。如果指定的宽度需要更多的垃圾箱,然后histogram2使用一个大本宽度对应于容器的最大数量。

例子:histogram2 (X, Y, BinWidth, 10 [5])使用箱子大小5x尺寸和大小10y维度。

直方图显示风格,指定为“bar3”“瓦”。指定“瓦”显示柱状图作为一个矩形阵列的瓷砖颜色的衣服来显示本值。

的默认值“bar3”使用3 d显示直方图酒吧。

例子:histogram2 (X, Y,“DisplayStyle”、“瓷砖”)块瓷砖的直方图作为一个矩形数组。

透明度的直方图条边缘,指定为一个标量值之间01包容性。的值1意味着完全不透明,0意味着完全透明的(看不见的)。

例子:histogram2 (X, Y, EdgeAlpha, 0.5)创建一个二元直方图有半透明栏边的情节。

直方图边缘颜色,指定这些值之一:

  • “没有”——边缘并不吸引。

  • “汽车”——每条边的颜色是自动选择的。

  • RGB值、十六进制颜色代码或颜色名称——边缘使用指定的颜色。

    RGB三胞胎和十六进制颜色代码可用于指定自定义颜色。

    • 一个RGB值三元素行向量的元素指定强度的红色,绿色和蓝色的组件的颜色。强度必须在范围内[0,1];例如,(0.4 0.6 0.7)

    • 十六进制颜色代码是一个特征向量或一个字符串标量,始于一个散列符号(#)后面跟着三个月或六个十六进制数字,它的范围可以从0F。的值是不区分大小写的。因此,颜色代码“# FF8800”,“# ff8800”,“# F80”,“# f80”是等价的。

    或者,您可以指定一些常见颜色的名字。此表列出了命名颜色选项,相当于RGB三胞胎,十六进制颜色代码。

    颜色名称 短名称 RGB值 十六进制颜色代码 外观
    “红色” “r” (1 0 0) “# FF0000”

    “绿色” ‘g’ (0 1 0) “# 00 ff00”

    “蓝” “b” (0 0 1) “# 0000 ff”

    “青色” “c” (0 1 1) “# 00飞行符”

    “红色” “米” (1 0 1) “#就”

    “黄色” “y” (1 1 0) “# FFFF00”

    “黑” “k” (0 0 0) # 000000的

    “白色” ' w ' (1 1 1) “# FFFFFF”

    这是默认颜色的RGB三胞胎和十六进制颜色编码MATLAB®使用在许多类型的情节。

    RGB值 十六进制颜色代码 外观
    [0 0.4470 - 0.7410) “# 0072 bd”

    (0.8500 0.3250 0.0980) “# D95319”

    (0.9290 0.6940 0.1250) “# EDB120”

    (0.4940 0.1840 0.5560) “# 7 e2f8e”

    (0.4660 0.6740 0.1880) “# 77 ac30”

    (0.3010 0.7450 0.9330) “# 4 dbeee”

    (0.6350 0.0780 0.1840) “# A2142F”

例子:histogram2 (X, Y,‘EdgeColor’,‘r’)创建一个三维直方图图红酒吧的边缘。

透明的直方图酒吧、指定为一个标量值之间01包容性。histogram2使用相同的透明的直方图。的值1意味着完全不透明,0意味着完全透明的(看不见的)。

例子:histogram2 (X, Y, FaceAlpha, 0.5)创建一个二维直方图的情节与半透明的酒吧。

直方图条颜色,指定这些值之一:

  • “没有”——酒吧不是填满。

  • “平”——酒吧的颜色随高度。酒吧有不同的高度有不同的颜色。图的颜色选择或轴colormap。

  • “汽车”——酒吧颜色自动选择(默认)。

  • RGB值、十六进制颜色代码或颜色名称——酒吧充满了指定的颜色。

    RGB三胞胎和十六进制颜色代码可用于指定自定义颜色。

    • 一个RGB值三元素行向量的元素指定强度的红色,绿色和蓝色的组件的颜色。强度必须在范围内[0,1];例如,(0.4 0.6 0.7)

    • 十六进制颜色代码是一个特征向量或一个字符串标量,始于一个散列符号(#)后面跟着三个月或六个十六进制数字,它的范围可以从0F。的值是不区分大小写的。因此,颜色代码“# FF8800”,“# ff8800”,“# F80”,“# f80”是等价的。

    或者,您可以指定一些常见颜色的名字。此表列出了命名颜色选项,相当于RGB三胞胎,十六进制颜色代码。

    颜色名称 短名称 RGB值 十六进制颜色代码 外观
    “红色” “r” (1 0 0) “# FF0000”

    “绿色” ‘g’ (0 1 0) “# 00 ff00”

    “蓝” “b” (0 0 1) “# 0000 ff”

    “青色” “c” (0 1 1) “# 00飞行符”

    “红色” “米” (1 0 1) “#就”

    “黄色” “y” (1 1 0) “# FFFF00”

    “黑” “k” (0 0 0) # 000000的

    “白色” ' w ' (1 1 1) “# FFFFFF”

    这是默认颜色的RGB三胞胎和十六进制颜色编码MATLAB使用在许多类型的情节。

    RGB值 十六进制颜色代码 外观
    [0 0.4470 - 0.7410) “# 0072 bd”

    (0.8500 0.3250 0.0980) “# D95319”

    (0.9290 0.6940 0.1250) “# EDB120”

    (0.4940 0.1840 0.5560) “# 7 e2f8e”

    (0.4660 0.6740 0.1880) “# 77 ac30”

    (0.3010 0.7450 0.9330) “# 4 dbeee”

    (0.6350 0.0780 0.1840) “# A2142F”

如果您指定DisplayStyle作为“楼梯”,然后histogram2不使用FaceColor财产。

例子:histogram2 (X, Y,‘FaceColor’,‘g’)创建一个三维直方图情节与绿色的酒吧。

灯光效果在直方图酒吧、指定为这个表中的值之一。

价值 描述
“点燃”

直方图条显示pseudo-lighting效果,双方的酒吧使用深色相对于顶部。酒吧是不受其他光源的轴。

这是默认值时DisplayStyle“bar3”

“平”

直方图条不自动点亮。在其他光物体的存在,在酒吧里灯光效果是一致的。

“没有”

直方图酒吧是不会自动点亮,灯光不影响直方图酒吧。

FaceLighting只能“没有”DisplayStyle“瓦”

例子:histogram2 (X, Y,‘FaceLighting’,‘没有’)直方图的酒吧关闭照明。

线的风格,指定为这个表中列出的选项之一。

线条样式 描述 产生的线
“- - -” 实线

“——” 虚线

“:” 虚线

“-”。 Dash-dotted线

“没有” 没有线 没有线

酒吧轮廓宽度,单位指定为一个积极的价值点。一个点= 1/72英寸。

例子:1.5

数据类型:||int8|int16|int32|int64|uint8|uint16|uint32|uint64

类型的正常化,指定为这个表中的值之一。对于每一个本:

  • v 是一本价值。

  • c 本是元素的数量。

  • 一个 = w x w y 每本的面积是计算使用吗xy本宽度。

  • N 在输入数据元素的数量。这个值可以大于分箱数据,如果数据包含值,或者一些数据在本限制之外。

价值 本值 笔记
“数”(默认)

v = c

  • 数或频率的观察。

  • 本值之和小于或等于元素个数(X)元素个数(y)。之和小于元素个数(X)元素个数(y)只有当一些输入数据不包括在垃圾桶中。

“countdensity”

v = c 一个

  • 数或频率扩展的本领域。

  • 每个酒吧的体积(高*区)本是观测的数量。酒吧数量之和小于或等于元素个数(X)元素个数(y)

“cumcount”

v = j = 1 c j

  • 累计计数。每本值的累积数量的观察每一个本,过去所有的垃圾箱xy维度。

  • 最后一栏的高度小于或等于元素个数(X)元素个数(Y)

“概率”

v = c N

  • 相对概率。

  • 栏的高度之和小于或等于1

“pdf”

v = c N 一个

  • 概率密度函数估计。

  • 每个酒吧的体积相对数量的观察。酒吧数量之和小于或等于1

“提供”

v = j = 1 c j N

  • 累计密度函数估计。

  • 每个栏的高度等于累积相对数量的观察每本和过去所有的垃圾箱xy维度。最后一栏的高度小于或等于1

例子:histogram2 (X, Y,“正常化”,“pdf”)情节的概率密度函数估计XY

切换显示的空箱子,指定为“关闭”“上”。默认值是“关闭”

例子:histogram2 (X, Y,“ShowEmptyBins”,“上”)打开显示空箱子。

本限制在x双元素向量维度,指定为一个,[xbmin, xbmax]。向量表示第一个和最后一个本的边缘x维度。

histogram2只图数据,属于本限制在内地,数据(数据(:1)> = xbmin &数据(:1)< = xbmax)

本限制的选择模式x维度,指定为“汽车”“手动”。默认值是“汽车”,所以本限制自动适应数据沿轴。

如果您显式地指定XBinLimitsXBinEdges,然后XBinLimitsMode设置自动“手动”。在这种情况下,指定XBinLimitsMode作为“汽车”重新调节本限制数据。

本限制在y双元素向量维度,指定为一个,[ybmin, ybmax]。向量表示第一个和最后一个本的边缘y维度。

histogram2只图数据,属于本限制在内地,数据(数据(:,2)> = ybmin &数据(:,2)< = ybmax)

本限制的选择模式y维度,指定为“汽车”“手动”。默认值是“汽车”,所以本限制自动适应数据沿轴。

如果您显式地指定YBinLimitsYBinEdges,然后YBinLimitsMode设置自动“手动”。在这种情况下,指定YBinLimitsMode作为“汽车”重新调节本限制数据。

输出参数

全部展开

二元直方图,作为一个对象返回。有关更多信息,请参见Histogram2属性

属性

Histogram2属性 Histogram2外观和行为

对象的功能

morebins 增加数量的直方图箱
fewerbins 减少数量的直方图箱

例子

全部折叠

生成10000对随机数并创建一个二维直方图。的histogram2函数自动选择一个合适的数量的垃圾箱覆盖的范围值xy并显示潜在的形状分布。

x = randn (10000 1);y = randn (10000 1);h = histogram2 (x, y)
h = Histogram2属性:数据:[10000 x2双]价值观:[25 x28双]NumBins: 25 [28] XBinEdges: [1 x26双]YBinEdges: [1 x29双]BinWidth:[0.3000 - 0.3000]正常化:“计数”FaceColor:“汽车”EdgeColor:(0.1500 0.1500 0.1500)显示所有属性
包含(“x”)ylabel (“y”)

图包含一个轴。轴包含histogram2类型的一个对象。该对象代表y和x。

当你指定一个输出参数histogram2函数,它返回一个histogram2对象。您可以使用此对象检查直方图的属性,如垃圾箱的数量或箱子的宽度。

在每个维度找到直方图箱的数量。

nXnY = h.NumBins
nXnY =1×225 28

情节1000对随机数的二元直方图分为25等距的垃圾箱,在每个维度使用5箱。

x = randn (1000 1);y = randn (1000 1);nbins = 5;h = histogram2 (x, y, nbins)

图包含一个轴。轴包含histogram2类型的一个对象。该对象代表y和x。

h = Histogram2属性:数据:[1000 x2双]价值观:[5 x5双]NumBins: 5 [5] XBinEdges: [4 -2.4000 -0.8000 0.8000 2.4000 4] YBinEdges: [4 -2.4000 -0.8000 0.8000 2.4000 4] BinWidth:[1.6000 - 1.6000]正常化:“计数”FaceColor:“汽车”EdgeColor:(0.1500 0.1500 0.1500)显示所有属性

发现结果本计数。

数量= h.Values
数=5×540 124 47 4 0 2 3 1 0 2 1 119 341 109 10 117 33 32 1 0 4 8 1 0

生成1000对随机数并创建一个二维直方图。

x = randn (1000 1);y = randn (1000 1);h = histogram2 (x, y)

图包含一个轴。轴包含histogram2类型的一个对象。该对象代表y和x。

h = Histogram2属性:数据:[1000 x2双]价值观:[15 x15双]NumBins: [15 15] XBinEdges:[1乘16双]YBinEdges:[1乘16双]BinWidth:[0.5000 - 0.5000]正常化:“计数”FaceColor:“汽车”EdgeColor:(0.1500 0.1500 0.1500)显示所有属性

使用morebins函数粗调整的箱数x维度。

nbins = morebins (h,“x”);nbins = morebins (h,“x”)

图包含一个轴。轴包含histogram2类型的一个对象。该对象代表y和x。

nbins =1×219日15

使用fewerbins函数来调整箱子的数量y维度。

nbins = fewerbins (h,“y”);nbins = fewerbins (h,“y”)

图包含一个轴。轴包含histogram2类型的一个对象。该对象代表y和x。

nbins =1×219日11

调整箱子的数量在细粒度级别通过显式地设置垃圾箱的数量。

h。NumBins = [20 10];

图包含一个轴。轴包含histogram2类型的一个对象。该对象代表y和x。

使用1000年创建一个二元直方图正态分布随机数在每个维度12箱。指定FaceColor作为“平”颜色直方图条的高度。

h = histogram2 (randn (1000 1), randn (1000 1), 12 (12),“FaceColor”,“平”);colorbar

图包含一个轴。轴包含histogram2类型的一个对象。

生成随机数据和情节二元平铺的直方图。显示指定的空箱子ShowEmptyBins作为“上”

x = 2 * randn (1000 1) + 2;y = 5 * randn (1000 1) + 3;h = histogram2 (x, y,“DisplayStyle”,“瓦”,“ShowEmptyBins”,“上”);

图包含一个轴。轴包含histogram2类型的一个对象。该对象代表y和x。

生成1000对随机数并创建一个二维直方图。指定本边用两个向量,无限宽箱边界的直方图来捕获所有异常值不满足 | x | < 2

x = randn (1000 1);y = randn (1000 1);Xedges =(负无穷2:0.4:2 Inf);Yedges =(负无穷2:0.4:2 Inf);h = histogram2 (x, y, Xedges Yedges)

图包含一个轴。轴包含histogram2类型的一个对象。该对象代表y和x。

h = Histogram2属性:数据:[1000 x2双]价值观:[12 x12双]NumBins: [12 12] XBinEdges:[1 * 13双]YBinEdges:[1 * 13双]BinWidth:非均匀的规范化:“计数”FaceColor:“汽车”EdgeColor:(0.1500 0.1500 0.1500)显示所有属性

当本边缘是无限的,histogram2显示每个异常本(直方图)的边界作为本旁边的宽度的两倍。

指定归一化财产“countdensity”删除包含异常值的垃圾箱。现在,体积每个本代表的频率观测的时间间隔。

h。N或malization =“countdensity”;

图包含一个轴。轴包含histogram2类型的一个对象。该对象代表y和x。

生成1000对随机数并创建一个二元直方图使用“概率”规范化。

x = randn (1000 1);y = randn (1000 1);h = histogram2 (x, y,“归一化”,“概率”)

图包含一个轴。轴包含histogram2类型的一个对象。该对象代表y和x。

h = Histogram2属性:数据:[1000 x2双]价值观:[15 x15双]NumBins: [15 15] XBinEdges:[1乘16双]YBinEdges:[1乘16双]BinWidth:[0.5000 - 0.5000]正常化:“概率”FaceColor:“汽车”EdgeColor:(0.1500 0.1500 0.1500)显示所有属性

计算总金额栏的高度。正常化,每个酒吧的高度等于选择一个观察,本区间内的概率,和所有的酒吧的高度之和为1。

S =总和(h.Values (:))
S = 1

生成1000对随机数并创建一个二维直方图。返回直方图调整对象的属性直方图没有重建整个阴谋。

x = randn (1000 1);y = randn (1000 1);h = histogram2 (x, y)

图包含一个轴。轴包含histogram2类型的一个对象。该对象代表y和x。

h = Histogram2属性:数据:[1000 x2双]价值观:[15 x15双]NumBins: [15 15] XBinEdges:[1乘16双]YBinEdges:[1乘16双]BinWidth:[0.5000 - 0.5000]正常化:“计数”FaceColor:“汽车”EdgeColor:(0.1500 0.1500 0.1500)显示所有属性

颜色直方图条的高度。

h。FaceColor =“平”;

图包含一个轴。轴包含histogram2类型的一个对象。该对象代表y和x。

改变箱子的数量在每个方向。

h。NumBins = [10 25];

图包含一个轴。轴包含histogram2类型的一个对象。该对象代表y和x。

显示直方图作为瓷砖阴谋。

h。DisplayStyle =“瓦”;视图(2)

图包含一个轴。轴包含histogram2类型的一个对象。该对象代表y和x。

使用savefig函数来拯救histogram2图。

histogram2 (randn (100 1), randn (100,1));savefig (“histogram2.fig”);关闭gcf

使用openfig加载直方图图回MATLAB。openfig图,还返回一个句柄h

h = openfig (“histogram2.fig”);

图包含一个轴。轴包含histogram2类型的一个对象。

使用findobj函数来定位正确的对象处理的图处理。这允许您继续操纵原始直方图对象用于生成图。

y = findobj (h,“类型”,“histogram2”)
y = Histogram2属性:数据:[100 x2双]价值观:[7 x6双]NumBins: 6 [7] XBinEdges: [3 2 1 0 1 2 3 4) YBinEdges: [3 2 1 0 1 2 3] BinWidth:[1]正常化:“计数”FaceColor:“汽车”EdgeColor:(0.1500 0.1500 0.1500)显示所有属性

提示

  • 直方图的土地使用histogram2在情节有一个上下文菜单编辑模式,使互动操作图窗口。例如,您可以使用上下文菜单交互改变箱子的数量,使多个柱状图,或改变显示的顺序。

扩展功能

介绍了R2015b