Histogram
SinksHistogram 方块在仿真运行过程中累积输入的标量数值，并将其频率分布渲染为柱状直方图。数值被归类到跨越用户定义范围的固定数量等宽区间（bin）中，使用户对信号的统计特性一目了然。
该方块非常适合于噪声分析、蒙特卡洛（Monte Carlo）结果检查以及质量控制监测，在这些场景中，分布的形态——而非时域波形——才是重点关注的量。
输入与输出
| Direction | ID | Label | 类型 | Status |
|---|---|---|---|---|
| → In | in |
Input | array | Required |
参数
| 参数 | Label | 类型 | 默认值 | 描述 |
|---|---|---|---|---|
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). |
使用示例
分析传感器噪声
NoiseSensor → Histogram将含有噪声的传感器输出直接连接到 Histogram，以观察噪声是否近似服从高斯分布并测量其离散程度。
蒙特卡洛输出分布
RandomSource → Plant → Histogram使用随机信号源驱动受控对象；Histogram 方块将显示整个仿真运行期间所产生的输出值统计分布。
说明与最佳实践
- 接收端方块（Sink）：Histogram 没有输出端口。它属于终端显示节点，不向任何下游计算提供信号。
- 标量输入：输入端口接收一个标量数值信号。每个仿真步长都会向累积分布贡献一个样本点。
- 累积性：与瞬时显示方块不同，直方图从仿真启动开始累积所有样本。随着运行时间的增加，分布形态会趋于稳定。
- 边界截断：落在
[minValue, maxValue]范围之外的采样点会计入边界区间，而不会被丢弃。如果分布边缘出现大量堆积截断，请调整范围设置。
相关模块
- BarChart：显示数组信号中每个离散元素的值，而非统计分布。
- ScatterPlot：绘制成对的标量值以揭示两个信号之间的相关性。
- uPlotDisplay：在整个仿真运行期间监测信号的时序波形。