Main Content

makedist

创建概率分布对象

说明

示例

pd = makedist(distname) 使用默认参数值为分布 distname 创建一个概率分布对象。

示例

pd = makedist(distname,Name,Value) 使用一个或多个由名称-值对组参数指定的分布参数值创建一个概率分布对象。

list = makedist 返回一个包含 makedist 可以创建的概率分布列表的元胞数组 list

makedist -reset 通过搜索名为 prob 的包中包含的文件的路径并实现从 ProbabilityDistribution 派生的类来重置分布列表。在定义自定义分布函数后可使用此语法。有关详细信息,请参阅 Define Custom Distributions Using the Distribution Fitter App

示例

全部折叠

使用默认参数值创建一个正态分布对象,这些参数值对应于标准正态分布的参数。

pd = makedist('Normal')
pd = 
  NormalDistribution

  Normal distribution
       mu = 0
    sigma = 1

您可以使用 pd 的对象函数来计算分布并生成随机数。显示支持的对象函数。

methods(pd)
Methods for class prob.NormalDistribution:

cdf        gather     icdf       iqr        mean       median     negloglik  paramci    pdf        plot       proflik    random     std        truncate   var        

例如,使用 iqr 函数计算分布的四分位差。

r = iqr(pd)
r = 1.3490

使用默认参数值创建一个 gamma 分布对象。

pd = makedist('Gamma')
pd = 
  GammaDistribution

  Gamma distribution
    a = 1
    b = 1

计算 gamma 分布的均值。

mean = mean(pd)
mean = 1

创建一个参数值 mu = 75sigma = 10 的正态分布对象。

pd = makedist('Normal','mu',75,'sigma',10)
pd = 
  NormalDistribution

  Normal distribution
       mu = 75
    sigma = 10

使用参数值 a = 3 和默认值 b = 1 创建一个 gamma 分布对象。

pd = makedist('Gamma','a',3)
pd = 
  GammaDistribution

  Gamma distribution
    a = 3
    b = 1

输入参数

全部折叠

分布名称,指定为下列字符向量或字符串标量之一。distname 指定的分布决定返回的概率分布对象的类型。

分布名称描述分布对象
'Beta'beta 分布BetaDistribution
'Binomial'二项分布BinomialDistribution
'BirnbaumSaunders'伯恩鲍姆-桑德斯分布BirnbaumSaundersDistribution
'Burr'伯尔分布BurrDistribution
'Exponential'指数分布ExponentialDistribution
'ExtremeValue'极值分布ExtremeValueDistribution
'Gamma'gamma 分布GammaDistribution
'GeneralizedExtremeValue'广义极值分布GeneralizedExtremeValueDistribution
'GeneralizedPareto'广义帕累托分布GeneralizedParetoDistribution
'HalfNormal'半正态分布HalfNormalDistribution
'InverseGaussian'逆高斯分布InverseGaussianDistribution
'Logistic'逻辑分布LogisticDistribution
'Loglogistic'对数逻辑分布LoglogisticDistribution
'Lognormal'对数正态分布LognormalDistribution
'Loguniform'对数均匀分布LoguniformDistribution
'Multinomial'多项分布MultinomialDistribution
'Nakagami'Nakagami 分布NakagamiDistribution
'NegativeBinomial'负二项分布NegativeBinomialDistribution
'Normal'正态分布NormalDistribution
'PiecewiseLinear'分段线性分布PiecewiseLinearDistribution
'Poisson'泊松分布PoissonDistribution
'Rayleigh'瑞利分布RayleighDistribution
'Rician'莱斯分布RicianDistribution
'Stable'稳定分布StableDistribution
'tLocationScale't 位置尺度分布tLocationScaleDistribution
'Triangular'三角分布TriangularDistribution
'Uniform'均匀分布UniformDistribution
'Weibull'威布尔分布WeibullDistribution

名称-值参数

将可选的参数对组指定为 Name1=Value1,...,NameN=ValueN,其中 Name 是参数名称,Value 是对应的值。名称-值参数必须出现在其他参数后,但参数对组的顺序无关紧要。

在 R2021a 之前,使用逗号分隔每个名称和值,并用引号将 Name 引起来。

示例: makedist('Normal','mu',10) 指定参数 mu 等于 10、参数 sigma 等于默认值 1 的正态分布。

beta 分布

全部折叠

beta 分布的第一个形状参数,指定为正标量值。仅当 distname'Beta' 时,此参数才有效。

示例: 'a',3

数据类型: single | double

beta 分布的第二个形状参数,指定为正标量值。仅当 distname'Beta' 时,此参数才有效。

示例: 'b',5

数据类型: single | double

二项分布

全部折叠

二项分布的试验次数,指定为正整数值。仅当 distname'Binomial' 时,此参数才有效。

示例: 'N',25

数据类型: single | double

二项分布的任一单个试验的成功概率,指定为范围 [0,1] 内的一个标量值。仅当 distname'Binomial' 时,此参数才有效。

示例: 'p',0.25

数据类型: single | double

伯恩鲍姆-桑德斯分布

全部折叠

伯恩鲍姆-桑德斯分布的尺度参数,指定为正标量值。仅当 distname'BirnbaumSaunders' 时,此参数才有效。

示例: 'beta',2

数据类型: single | double

伯恩鲍姆-桑德斯分布的形状参数,指定为正标量值。仅当 distname'BirnbaumSaunders' 时,此参数才有效。

示例: 'gamma',0.5

数据类型: single | double

伯尔分布

全部折叠

伯尔分布的尺度参数,指定为正标量值。仅当 distname'Burr' 时,此参数才有效。

示例: 'alpha',2

数据类型: single | double

伯尔分布的第一个形状参数,指定为正标量值。仅当 distname'Burr' 时,此参数才有效。

示例: 'c',2

数据类型: single | double

伯尔分布的第二个形状参数,指定为正标量值。仅当 distname'Burr' 时,此参数才有效。

示例: 'k',5

数据类型: single | double

指数分布

全部折叠

指数分布的均值,指定为正标量值。仅当 distname'Exponential' 时,此参数才有效。

示例: 'mu',5

数据类型: single | double

极值分布

全部折叠

极值分布的位置参数,指定为标量值。仅当 distname'ExtremeValue' 时,此参数才有效。

示例: 'mu',-2

数据类型: single | double

极值分布的尺度参数,指定为非负标量值。仅当 distname'ExtremeValue' 时,此参数才有效。

示例: 'sigma',2

数据类型: single | double

gamma 分布

全部折叠

gamma 分布的形状参数,指定为正标量值。仅当 distname'Gamma' 时,此参数才有效。

示例: 'a',2

数据类型: single | double

gamma 分布的尺度参数,指定为非负标量值。仅当 distname'Gamma' 时,此参数才有效。

示例: 'b',0

数据类型: single | double

广义极值分布

全部折叠

广义极值分布的形状参数,指定为标量值。仅当 distname'GeneralizedExtremeValue' 时,此参数才有效。

示例: 'k',0

数据类型: single | double

广义极值分布的尺度参数,指定为非负标量值。仅当 distname'GeneralizedExtremeValue' 时,此参数才有效。

示例: 'sigma',2

数据类型: single | double

广义极值分布的位置参数,指定为标量值。仅当 distname'GeneralizedExtremeValue' 时,此参数才有效。

示例: 'mu',1

数据类型: single | double

广义帕累托分布

全部折叠

广义帕累托分布的形状参数,指定为标量值。仅当 distname'GeneralizedPareto' 时,此参数才有效。

示例: 'k',0

数据类型: single | double

广义帕累托分布的尺度参数,指定为非负标量值。仅当 distname'GeneralizedPareto' 时,此参数才有效。

示例: 'sigma',2

数据类型: single | double

广义帕累托分布的位置(阈值)参数,指定为标量值。仅当 distname'GeneralizedPareto' 时,此参数才有效。

示例: 'theta',2

数据类型: single | double

半正态分布

全部折叠

半正态分布的位置参数,指定为标量值。仅当 distname'HalfNormal' 时,此参数才有效。

示例: 'mu',1

数据类型: single | double

半正态分布的尺度参数,指定为非负标量值。仅当 distname'HalfNormal' 时,此参数才有效。

示例: 'sigma',2

数据类型: single | double

逆高斯分布

全部折叠

逆高斯分布的尺度参数,指定为正标量值。仅当 distname'InverseGaussian' 时,此参数才有效。

示例: 'mu',2

数据类型: single | double

逆高斯分布的形状参数,指定为正标量值。仅当 distname'InverseGaussian' 时,此参数才有效。

示例: 'lambda',4

数据类型: single | double

逻辑分布

全部折叠

逻辑分布的均值,指定为标量值。仅当 distname'Logistic' 时,此参数才有效。

示例: 'mu',2

数据类型: single | double

逻辑分布的尺度参数,指定为非负标量值。仅当 distname'Logistic' 时,此参数才有效。

示例: 'sigma',4

数据类型: single | double

对数逻辑分布

全部折叠

对数逻辑分布的对数值的均值,指定为标量值。仅当 distname'Loglogistic' 时,此参数才有效。

示例: 'mu',2

数据类型: single | double

对数逻辑分布的对数值的尺度参数,指定为正标量值。仅当 distname'Loglogistic' 时,此参数才有效。

示例: 'sigma',4

数据类型: single | double

对数正态分布

全部折叠

对数正态分布的对数值的均值,指定为标量值。仅当 distname'Lognormal' 时,此参数才有效。

示例: 'mu',2

数据类型: single | double

对数正态分布的对数值的标准差,指定为非负标量值。仅当 distname'Lognormal' 时,此参数才有效。

示例: 'sigma',2

数据类型: single | double

对数均匀分布

全部折叠

对数均匀分布的下限,指定为非负标量值。仅当 distname'Loguniform' 时,此参数才有效。

示例: 'Lower',2

数据类型: single | double

对数均匀分布的上限,指定为大于 Lower 的标量值。仅当 distname'Loguniform' 时,此参数才有效。

示例: 'Upper',6

数据类型: single | double

多项分布

全部折叠

多项分布的结果概率,指定为范围 [0,1] 内的标量值组成的向量。概率总和为 1,对应于结果 [1, 2, ..., k],其中 k 是概率向量中元素的数量。仅当 distname'Multinomial' 时,此参数才有效。

示例: 'Probabilities',[0.1 0.2 0.5 0.2] 分别给出结果为 1、2、3 或 4 的概率。

数据类型: single | double

Nakagami 分布

全部折叠

Nakagami 分布的形状参数,指定为正标量值。仅当 distname'Nakagami' 时,此参数才有效。

示例: 'mu',5

数据类型: single | double

Nakagami 分布的尺度参数,指定为正标量值。仅当 distname'Nakagami' 时,此参数才有效。

示例: 'omega',5

数据类型: single | double

负二项分布

全部折叠

负二项分布的成功次数,指定为正标量值。仅当 distname'NegativeBinomial' 时,此参数才有效。

示例: 'R',5

数据类型: single | double

负二项分布的任一单个试验的成功概率,指定为范围 (0,1] 内的一个标量值。仅当 distname'NegativeBinomial' 时,此参数才有效。

示例: 'P',0.1

数据类型: single | double

正态分布

全部折叠

正态分布的均值,指定为标量值。仅当 distname'Normal' 时,此参数才有效。

示例: 'mu',2

数据类型: single | double

正态分布的标准差,指定为非负标量值。仅当 distname'Normal' 时,此参数才有效。

示例: 'sigma',2

数据类型: single | double

分段线性分布

全部折叠

分段线性分布中累积分布函数 (cdf) 更改斜率处的数据值,指定为标量值组成的单调递增向量。仅当 distname'PiecewiseLinear' 时,此参数才有效。

示例: 'x',[1 2 3]

数据类型: single | double

分段线性分布中 x 的每个值处的 cdf 值,指定为标量值组成的单调递增向量,从 0 开始,到 1 结束。仅当 distname'PiecewiseLinear' 时,此参数才有效。

示例: 'Fx',[0.2 0.5 1]

数据类型: single | double

泊松分布

全部折叠

泊松分布的均值,指定为非负标量值。仅当 distname'Poisson' 时,此参数才有效。

示例: 'lambda',5

数据类型: single | double

瑞利分布

全部折叠

定义瑞利分布的参数,指定为正标量值。仅当 distname'Rayleigh' 时,此参数才有效。

示例: 'B',3

数据类型: single | double

莱斯分布

全部折叠

莱斯分布的非中心参数,指定为非负标量值。仅当 distname'Rician' 时,此参数才有效。

示例: 's',0

数据类型: single | double

莱斯分布的尺度参数,指定为正标量值。仅当 distname'Rician' 时,此参数才有效。

示例: 'sigma',2

数据类型: single | double

稳定分布

全部折叠

稳定分布的第一个形状参数,指定为范围 (0,2] 中的标量值。仅当 distname'Stable' 时,此参数才有效。

示例: 'alpha',1

数据类型: single | double

稳定分布的第二个形状参数,指定为范围 [–1,1] 内的标量值。仅当 distname'Stable' 时,此参数才有效。

示例: 'beta',0.5

数据类型: single | double

稳定分布的尺度参数,指定为范围 (0,∞) 内的标量值。仅当 distname'Stable' 时,此参数才有效。

示例: 'gam',2

数据类型: single | double

稳定分布的位置参数,指定为标量值。仅当 distname'Stable' 时,此参数才有效。

示例: 'delta',5

数据类型: single | double

t 位置尺度分布

全部折叠

t 位置尺度分布的位置参数,指定为标量值。仅当 distname'tLocationScale' 时,此参数才有效。

示例: 'mu',-2

数据类型: single | double

t 位置尺度分布的尺度参数,指定为正标量值。仅当 distname'tLocationScale' 时,此参数才有效。

示例: 'sigma',2

数据类型: single | double

t 位置尺度分布的自由度,指定为正标量值。仅当 distname'tLocationScale' 时,此参数才有效。

示例: 'nu',20

数据类型: single | double

三角分布

全部折叠

三角分布的下限,指定为标量值。仅当 distname'Triangular' 时,此参数才有效。

示例: 'A',-2

数据类型: single | double

三角分布的峰值位置,指定为大于或等于 A 的标量值。仅当 distname'Triangular' 时,此参数才有效。

示例: 'B',1

数据类型: single | double

三角分布的上限,指定为大于或等于 B 的标量值。仅当 distname'Triangular' 时,此参数才有效。

示例: 'C',5

数据类型: single | double

均匀分布

全部折叠

均匀分布的下限,指定为标量值。仅当 distname'Uniform' 时,此参数才有效。

示例: 'Lower',-4

数据类型: single | double

均匀分布的上限,指定为大于 Lower 的标量值。仅当 distname'Uniform' 时,此参数才有效。

示例: 'Upper',2

数据类型: single | double

威布尔分布

全部折叠

威布尔分布的尺度参数,指定为正标量值。仅当 distname'Weibull' 时,此参数才有效。

示例: 'A',2

数据类型: single | double

威布尔分布的形状参数,指定为正标量值。仅当 distname'Weibull' 时,此参数才有效。

示例: 'B',5

数据类型: single | double

输出参数

全部折叠

概率分布,以 distname 指定类型的概率分布对象形式返回。

makedist 可以创建的概率分布的列表,以字符向量元胞数组形式返回。

替代功能

App

分布拟合器打开一个图形用户界面,以便您从工作区导入数据,并以交互方式对该数据进行概率分布拟合。然后,您可以将分布作为概率分布对象保存到工作区。使用 distributionFitter 打开分布拟合器,或点击 App 选项卡上的“分布拟合器”。

版本历史记录

在 R2013a 中推出