ExtremeValueDistribution

Objeto de distribución de probabilidad de valores extremos

Descripción

Un objeto ExtremeValueDistribution consta de parámetros, una descripción del modelo y datos de muestra de una distribución de probabilidad de valores extremos.

La distribución de valores extremos es apropiada para la modelización del valor más pequeño de una distribución cuyas colas decrecen exponencialmente más rápido; por ejemplo, la distribución normal. También puede modelar el valor más grande de una distribución, como la distribución normal y la distribución exponencial, usando el valor negativo de los valores originales.

La distribución de valores extremos utiliza los siguientes parámetros.

Parámetro	Descripción	Soporte
mu	Parámetro de localización	$$-\infty <\mu <\infty$$
sigma	Parámetro de escala	$$\sigma \ge 0$$

Creación

Hay varias formas de crear un objeto de distribución de probabilidad ExtremeValueDistribution:

• Crear una distribución con valores de parámetros especificados usando makedist.

• Ajustar una distribución a datos usando fitdist.

• Ajustar una distribución a datos de forma interactiva usando la app Distribution Fitter.

Propiedades

Parámetros de la distribución

mu — Parámetro de localización

valor de escalar

Parámetro de localización de la distribución de valores extremos, especificado como un valor de escalar.

Tipos de datos: single | double

sigma — Parámetro de escala

valor de escalar no negativo

Parámetro de escala de la distribución de valores extremos, especificado como un valor de escalar no negativo.

Tipos de datos: single | double

Características de la distribución

IsTruncated — Indicador lógico de la distribución truncada

Solo lectura: 0 | 1

Esta propiedad o parámetro es de solo lectura.

El indicador lógico de distribución truncada, especificado como un valor lógico. Si IsTruncated es igual a 0, no se trata de una distribución truncada. Si IsTruncated es igual a 1, se trata de una distribución truncada.

Tipos de datos: logical

NumParameters — Número de parámetros

Solo lectura: valor entero positivo

Esta propiedad o parámetro es de solo lectura.

El número de parámetros de la distribución de probabilidad, especificado como un valor entero positivo.

Tipos de datos: double

ParameterCovariance — Matriz de covarianzas de las estimaciones de los parámetros

Solo lectura: matriz de valores de escalar

Esta propiedad o parámetro es de solo lectura.

La matriz de covarianzas de las estimaciones de los parámetros, especificada como una matriz de p por p, en la que p es el número de parámetros de la distribución. El elemento (i, j) es la covarianza entre las estimaciones del parámetro número i y el parámetro número j. El elemento (i, i) es la varianza estimada del parámetro número i. Si el parámetro i es fijo en lugar de una estimación obtenida ajustando la distribución a los datos, entonces los elementos (i, i) de la matriz de covarianzas son 0.

Tipos de datos: double

ParameterIsFixed — Indicador lógico de los parámetros fijos

Solo lectura: arreglo de valores lógicos

Esta propiedad o parámetro es de solo lectura.

El indicador lógico de los parámetros fijos, especificado como un arreglo de valores lógicos. Si 0, el parámetro correspondiente en el arreglo ParameterNames no es fijo. Si 1, el parámetro correspondiente del arreglo ParameterNames es fijo.

Tipos de datos: logical

ParameterValues — Valores de los parámetros de la distribución

Solo lectura: vector de valores de escalar

Esta propiedad o parámetro es de solo lectura.

Los valores de los parámetros de la distribución, especificados como un vector de valores de escalar.

Tipos de datos: single | double

Truncation — Intervalo de truncamiento

Solo lectura: vector de valores de escalar

Esta propiedad o parámetro es de solo lectura.

El intervalo de truncamiento de la distribución de probabilidad, especificado como un vector de valores de escalar que contiene los límites inferior y superior de truncamiento.

Tipos de datos: single | double

Otras propiedades del objeto

DistributionName — Nombre de la distribución de probabilidad

Solo lectura: vector de caracteres

Esta propiedad o parámetro es de solo lectura.

El nombre de la distribución de probabilidad, especificado como un vector de caracteres.

Tipos de datos: char

InputData — Datos utilizados en el ajuste de la distribución

Solo lectura: estructura

Esta propiedad o parámetro es de solo lectura.

Los datos utilizados en el ajuste de la distribución, especificados como una estructura que contiene los siguientes elementos:

• data: El vector de datos utilizado en el ajuste de la distribución.

• cens: El vector que desea censurar. Esta propiedad debe quedar en blanco si no desea especificar ninguno.

• freq: El vector de frecuencia. Esta propiedad debe quedar en blanco si no desea especificar ninguno.

Tipos de datos: struct

ParameterDescription — Descripciones de los parámetros de la distribución

Solo lectura: arreglo de celdas de vectores de caracteres

Esta propiedad o parámetro es de solo lectura.

Las descripciones de los parámetros de la distribución, especificadas como un arreglo de celdas de vectores de caracteres. Cada celda contiene una breve descripción de uno de los parámetros de la distribución.

Tipos de datos: char

ParameterNames — Nombres de los parámetros de la distribución

Solo lectura: arreglo de celdas de vectores de caracteres

Esta propiedad o parámetro es de solo lectura.

Los nombres de los parámetros de la distribución, especificados como un arreglo de celdas de vectores de caracteres.

Tipos de datos: char

Funciones del objeto

cdf	Función de distribución acumulativa
gather	Gather properties of Statistics and Machine Learning Toolbox object from GPU
icdf	Función de distribución acumulativa inversa
iqr	Interquartile range of probability distribution
mean	Media de la distribución de probabilidad
median	Median of probability distribution
negloglik	Negative loglikelihood of probability distribution
paramci	Intervalos de confianza para los parámetros de la distribución de probabilidad
pdf	Función de densidad de probabilidad
plot	Plot probability distribution object
proflik	Profile likelihood function for probability distribution
random	Números aleatorios
std	Desviación estándar de la distribución de probabilidad
truncate	Truncar objeto de distribución de probabilidad
var	Varianza de la distribución de probabilidad

Ejemplos

Crear un objeto de distribución de valores extremos usando parámetros predeterminados

Cree un objeto de distribución de valores extremos usando los valores predeterminados de los parámetros.

pd = makedist('ExtremeValue')

pd = 
  ExtremeValueDistribution

  Extreme Value distribution
       mu = 0
    sigma = 1

Crear un objeto de distribución de valores extremos usando parámetros especificados

Cree un objeto de distribución de valores extremos especificando los valores de los parámetros.

pd = makedist('ExtremeValue','mu',-1,'sigma',2)

pd = 
  ExtremeValueDistribution

  Extreme Value distribution
       mu = -1
    sigma =  2

Calcule la desviación estándar de la distribución.

s = std(pd)

s = 
2.5651

Capacidades ampliadas

Generación de código C/C++

Genere código C y C++ mediante MATLAB® Coder™.

Notas y limitaciones de uso:

• Debe crear un objeto de distribución de probabilidad ajustando una distribución de probabilidad a datos de muestra a partir de la función fitdist. Para ver las notas y limitaciones de uso de fitdist, consulte Generación de código de fitdist.

• Estas funciones de objeto son compatibles con la generación de código: cdf, icdf, iqr, mean, median, pdf, std, truncate y var.

Para obtener más información sobre la generación de código, consulte Introduction to Code Generation y Code Generation for Probability Distribution Objects.

Arreglos GPU

Acelere código mediante la ejecución en una unidad de procesamiento gráfico (GPU) mediante Parallel Computing Toolbox™.

Notas y limitaciones de uso:

• ExtremeValueDistribution puede ser un objeto de distribución de probabilidad ajustado mediante fitdist con argumentos de entrada de arreglos de GPU.

• La funciones del objeto ExtremeValueDistribution son totalmente compatibles con los arreglos de GPU.

Para obtener más información, consulte Run MATLAB Functions on a GPU (Parallel Computing Toolbox).

Historial de versiones

Introducido en R2013a

Consulte también

makedist | fitdist | Distribution Fitter

Temas

• Extreme Value Distribution