You are here: Symbol Reference > Statistics Namespace > Functions > Statistics.Histogram Function
Stats Master VCL
ContentsIndex
PreviousUpNext
Statistics.Histogram Function

Histogram.

Pascal
procedure Histogram(const Data: TVec; const Bins: TVec; const Results: TVec); overload;

Divide the Data vector elements into intervals, specified by the Bins vector. The Bins elements define the center points for the intervals. The Bins elements must be sorted in ascending order. The number of elements falling in each interval is counted and the result for each interval (frequency distribution) is written to the Results vector. The Length and Complex properties of the Results vector are adjusted automatically.

Use this version if you need non-equidistant histogram.

This example constructs 4 unequal bins and counts the frequencies.

Uses MtxExpr,Statistics;
procedure Example;
  var Data, Bins, Freq: Vector;
begin
  Data.SetIt(false,[1,2,3,4,5,6,7,8,9,10]);
  Bins.SetIt(false,[1.5, 2, 6, 9]); // define centerpoints, note that values are sorted!
  Histogram(Data,Bins, Freq);
  // Freq holds the count of elements in each bin
end;
#include "MtxExpr.hpp"
#include "Statistics.hpp"
void __fastcall Example()
{
  sVector data, bins, freq;
  data.SetIt(false,OPENARRAY(double,(1,2,3,4,5,6,7,8,9,10)));
  // Centerpoints, note that values are sorted!
  bins.SetIt(false,OPENARRAY(double,(1.5, 2.0, 6.0, 9.0)));
  Histogram(data,bins,freq);
  // Freq holds the count of elements in each bin
}
Examples on GitHub
Copyright (c) 1999-2025 by Dew Research. All rights reserved.
What do you think about this topic? Send feedback!