Saltar navegación

Documentación de FlexPro 2025

BoxPlot

Determina los parámetros estadísticos para mostrar un box plot (diagrama de caja).

Sintaxis

BoxPlot(DataSet, [ Mode = PROCESS_COLUMNS ], [ JitterMode = BOXP_JITTER_NONE ] [ , Jitter = 0.25 ])

 

La sintaxis de la función BoxPlot consta de los siguientes elementos:

Parte

Descripción

DataSet

El conjunto de datos que se va a evaluar.

Las estructuras de datos permitidas son Serie de datos, Matriz de datos, Señal, Serie de señales y Lista. Se permiten todos los tipos de datos numéricos.

Mode

Especifica cómo deben procesarse las matrices de datos y las series de señales. Si omite el argumento, se realiza un cálculo columna por columna.

El argumento Mode puede tener los siguientes valores:

Constante

Significado

PROCESS_COLUMNS

Las matrices de datos y las series de señales se procesan columna por columna. El resultado son los parámetros estadísticos que generan una caja por cada columna.

PROCESS_ROWS

Las matrices de datos y las series de señales se procesan fila por fila. El resultado son los parámetros estadísticos que generan una caja por fila.

PROCESS_COMPLETE

Las matrices de datos y las series de señales se procesan como un todo. El resultado son los parámetros estadísticos que generan una caja para todo el conjunto de datos. Las listas solo pueden editarse si previamente pueden convertirse en series de señales.

Si el argumento es una lista, se toma su primer elemento. Si se trata de nuevo de una lista, se repite el proceso.

Se establece el valor predeterminado PROCESS_COLUMNS si no se especifica el argumento.

JitterMode

Especifica cómo se muestran los valores atípicos y los puntos interiores.

El argumento JitterMode puede tener los siguientes valores:

Constante

Significado

BOXP_JITTER_NONE

Los valores atípicos y los puntos interiores se muestran en una línea.

BOXP_JITTER_OVER

Los valores atípicos y los puntos interiores se distribuyen uniformemente encima del box plot.

BOXP_JITTER_BESIDE

Los valores atípicos y los puntos interiores se distribuyen uniformemente al lado del box plot.

Si el argumento es una lista, se toma su primer elemento. Si se trata de nuevo de una lista, se repite el proceso.

Se establece el valor predeterminado BOXP_JITTER_NONE si no se especifica el argumento.

Jitter

Especifica el ancho de la nube de puntos que se va a representar. El valor 0 significa que los valores se muestran en una línea. El valor 1 significa que los puntos de la primera serie de mediciones se muestran entre 0,5 y 1,5, si se dibujan encima de la caja, o que los puntos de la primera serie de mediciones se muestran entre 0 y 1, si se dibujan al lado de la caja.

Las estructuras de datos permitidas son Valor escalar. Se permiten todos los tipos de datos numéricos.

El valor debe ser mayor o igual que 0 y menor o igual que 1,0.

En los tipos de datos complejos se calcula un valor absoluto.

Si el argumento es una lista, se toma su primer elemento. Si se trata de nuevo de una lista, se repite el proceso.

Se establece el valor predeterminado 0,25 si no se especifica el argumento.

Notas

El box plot, también conocido como box and whisker plot o diagrama de caja, es un diagrama que permite visualizar claramente las medidas robustas más importantes de posición y dispersión. Se muestran el mínimo, el cuartil inferior, la mediana, el cuartil superior y el máximo. La función determina estos parámetros estadísticos y los devuelve en forma de lista.

El siguiente gráfico muestra un box plot:

La caja corresponde a la zona en la que se encuentra el 50 % medio de los datos. Por tanto, está limitada por los cuartiles superior e inferior. La longitud de la caja corresponde al rango intercuartílico (IQR). Es una medida de la dispersión de los datos, que viene determinada por la diferencia entre los cuartiles superior e inferior. La mediana también se muestra como una línea continua en la caja. Esta línea divide todo el diagrama en dos zonas, cada una de las cuales contiene el 50 % de los datos.

Los valores fuera de la caja se representan mediante bigotes (whisker). La longitud de los bigotes debe limitarse a un máximo de 1,5 × IQR. Sin embargo, el bigote no termina exactamente en esta longitud, sino en el valor de los datos que aún se encuentra dentro de este límite.

Las series de datos o señales proporcionan exactamente una caja. Para matrices o series de señales, el número de cajas corresponde al número de columnas o al número de filas, según el modo seleccionado. Con las listas, en cambio, los elementos de lista se consideran individualmente y el resultado son una o varias cajas.

La función devuelve los siguientes resultados en forma de lista:

Elemento de lista

Descripción

Q1

Cuartil inferior: El 25 % más pequeño de los valores de los datos es menor o igual que este valor característico.

Q2

Mediana: El 50 % más pequeño de los valores de los datos es menor o igual que este valor característico.

Q3

Cuartil superior: El 75 % más pequeño de los valores de los datos es inferior o igual que este valor característico.

IQR

Rango intercuartílico: El rango de valores en el que se encuentra el 50 % medio de los datos.

LowerWhisker

Posición del bigote inferior: Q1 - 1,5 × IQR. El valor no corresponde a este valor calculado, sino al valor medido que todavía está dentro de este límite.

UpperWhisker

Posición del bigote superior: Q3 + 1,5 × IQR. El valor no corresponde a este valor calculado, sino al valor medido que todavía está dentro de este límite.

InnerPoints

Puntos interiores: son todos los valores medidos que están dentro de los bigotes inferior y superior.

Outliers

Valores atípicos: son todos los valores medidos que están fuera de los bigotes.

Son posibles las siguientes formas de representación del diagrama de caja:

Box plot

Box plot con valores atípicos

Box plot con valores atípicos y puntos interiores

Box plot con visualización de fluctuaciones, valores atípicos y puntos interiores por encima de la caja

Diagrama de caja con visualización de fluctuaciones, valores atípicos y puntos interiores junto a la caja

Disponibilidad

FlexPro Basic, Professional, Developer Suite

Ejemplos

BoxPlot({2, 5, 7, 1, 3})

Proporciona una lista con los parámetros estadísticos para mostrar un diagrama de caja.

Véase también

Función ListToSeries

Función Quantile

Objeto de análisis Parámetro estadístico