📊

Histogram

Sinks

Le bloc Histogram accumule les valeurs scalaires entrantes au cours de la simulation et affiche leur distribution de fréquence sous la forme d'un histogramme à barres. Les valeurs sont réparties dans un nombre fixe de classes (bins) de même largeur couvrant une plage définie par l'utilisateur, offrant ainsi un aperçu immédiat des caractéristiques statistiques d'un signal.

Ce bloc est particulièrement adapté à l'analyse du bruit, à l'inspection des résultats de simulations de Monte-Carlo et au contrôle qualité lorsque la forme de la distribution — plutôt que la forme d'onde temporelle — constitue la grandeur d'intérêt.

Entrées & Sorties

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

Paramètres

Paramètres	Label	Type	Défaut	Description
`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).

Exemples d'Utilisation

Analyser le bruit d'un capteur

NoiseSensor → Histogram

Connectez la sortie d'un capteur bruité directement à l'histogramme pour vérifier si le bruit suit approximativement une loi normale (gaussienne) et pour mesurer sa dispersion.

Distribution de sortie Monte-Carlo

RandomSource → Plant → Histogram

Excitez le système avec une source aléatoire ; l'histogramme affiche la distribution des sorties résultantes sur toute la durée de la simulation.

Remarques & Bonnes Pratiques

Bloc puits (sink) : Le bloc Histogram n'a pas de ports de sortie. C'est un nœud d'affichage terminal qui n'alimente aucun calcul en aval.
Entrée scalaire : Le port d'entrée accepte un signal numérique scalaire. Chaque pas de simulation ajoute un échantillon à la distribution accumulée.
Accumulation : Contrairement aux blocs d'affichage instantané, l'histogramme accumule tous les échantillons depuis le début de la simulation. La distribution gagne en stabilité à mesure que la durée d'exécution augmente.
Saturation aux bornes : Les échantillons en dehors de [minValue, maxValue] sont comptabilisés dans les classes limites et ne sont pas éliminés. Ajustez l'intervalle si la distribution apparaît fortement tronquée.

Composants Associés

BarChart : Affiche les valeurs par élément d'un signal vectoriel plutôt qu'une distribution statistique.
ScatterPlot : Trace des paires de valeurs scalaires pour révéler la corrélation entre deux signaux.
uPlotDisplay : Surveille la forme d'onde temporelle d'un signal sur l'ensemble de la simulation.