📊

Histogram

Sinks

El bloque Histogram acumula los valores escalares entrantes a lo largo de la simulación y representa su distribución de frecuencias en forma de histograma de barras. Los valores se agrupan en un número fijo de intervalos (bins) de igual anchura que abarcan un rango definido por el usuario, ofreciendo una vista panorámica inmediata del carácter estadístico de una señal.

Este bloque resulta idóneo para el análisis de ruido, la inspección de resultados en simulaciones de Monte Carlo y la monitorización de control de calidad cuando la forma de la distribución —y no la forma de onda temporal— constituye la magnitud de interés.

Entradas y Salidas

Direction	ID	Label	Tipo	Status
→ In	`in`	Input	array	Required

Parámetros

Parámetros	Label	Tipo	Por defecto	Descripción
`rangeMode`	Range	select	`auto`	Auto fits the axis to the data; Manual uses the Min/Max below.
`minValue`	Min Value	number	`-5`	Lower bound (Manual range only).
`maxValue`	Max Value	number	`5`	Upper bound (Manual range only).
`binMode`	Binning	select	`count`	How bins are sized: a fixed number, a fixed step width, or auto.
`bins`	Bin count	number	`20`	Number of bins (Bin count mode).
`binWidth`	Bin width	number	`1`	Width/step of each bin (Fixed width mode).

Ejemplos de Uso

Análisis del ruido de un sensor

NoiseSensor → Histogram

Conecte la salida de un sensor con ruido directamente al bloque Histogram para observar si el ruido es aproximadamente gaussiano y medir su dispersión.

Distribución de salida de Monte Carlo

RandomSource → Plant → Histogram

Excite la planta con una fuente de entrada aleatoria; el bloque Histogram mostrará la distribución de salida resultante a lo largo de la simulación.

Observaciones y Buenas Prácticas

Bloque sumidero (sink): Histogram no posee puertos de salida. Es un nodo de visualización terminal y no alimenta cálculos aguas abajo.
Entrada escalar: El puerto de entrada acepta una señal numérica escalar. Cada paso de simulación aporta una muestra a la distribución acumulada.
Acumulación: A diferencia de los bloques de visualización instantánea, el histograma acumula todas las muestras desde el inicio de la simulación. La distribución se torna más estable a medida que aumenta la duración de la ejecución.
Saturación de extremos: Las muestras fuera de [minValue, maxValue] se contabilizan en los intervalos límite y no se descartan. Ajuste el rango si la distribución parece excesivamente recortada.

Bloques Relacionados

BarChart: Muestra valores individuales por elemento de una señal vectorial en vez de una distribución estadística.
ScatterPlot: Grafica pares de valores escalares para revelar la correlación entre dos señales.
uPlotDisplay: Monitoriza la forma de onda en serie temporal de una señal durante toda la simulación.