Package io.deephaven.plot.datasets.histogram

Class HistogramCalculator

java.lang.Object

io.deephaven.plot.datasets.histogram.HistogramCalculator

public class HistogramCalculator
extends Object

Utility for calculating histogram plot information: bin locations and data frequencies within these bins.

Constructor Summary

Constructors

Constructor	Description
HistogramCalculator()

Method Summary

Modifier and Type	Method	Description
static Table	calc(Table table, String histogramColumn, double rangeMin, double rangeMax, int nbins, PlotInfo plotInfo, String... byColumns)	Splits the specified range into nbins equally sized bins.
static Table	calc(Table table, String histogramColumn, double rangeMin, double rangeMax, int nbins, PlotInfo plotInfo, List<String> byColumns)	Splits the specified range into nbins equally sized bins.
static Table	calc(Table table, String column, int nbins, PlotInfo plotInfo, String... byColumns)	Finds the minimum and maximum of the data in the column of the table and splits this range into nbins equally sized bins.
static Table	calc(Table table, String column, int nbins, PlotInfo plotInfo, List<String> byColumns)	Finds the minimum and maximum of the data in the column of the table and splits this range into nbins equally sized bins.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

HistogramCalculator

public HistogramCalculator()

Method Details

calc

public static Table calc(Table table,
 String column,
 int nbins,
 PlotInfo plotInfo,
 String... byColumns)

Finds the minimum and maximum of the data in the column of the table and splits this range into nbins equally sized bins. Calculates the number of data values in each bin.

Data which is not finite as defined in Numeric.isFinite(java.lang.Byte) is filtered out of the data set.

Parameters:

table - table

column - column in table

nbins - number of bins

plotInfo - plot information

byColumns - other columns needed to calaculate histogram, these columns will be included while grouping

Returns:

table holding the calculated bins and their counts

Throws:

RequirementFailure - table and column must not be null

RuntimeException - column must be numeric

RequirementFailure - table and column must not be null

RuntimeException - column must be numeric

calc

public static Table calc(Table table,
 String column,
 int nbins,
 PlotInfo plotInfo,
 List<String> byColumns)

Finds the minimum and maximum of the data in the column of the table and splits this range into nbins equally sized bins. Calculates the number of data values in each bin.

Data which is not finite as defined in Numeric.isFinite(java.lang.Byte) is filtered out of the data set.

Parameters:

table - table

column - column in table

nbins - number of bins

plotInfo - plot information

byColumns - other columns needed to calaculate histogram, these columns will be included while grouping

Returns:

table holding the calculated bins and their counts

Throws:

RequirementFailure - table and column must not be null

RuntimeException - column must be numeric

calc

public static Table calc(Table table,
 String histogramColumn,
 double rangeMin,
 double rangeMax,
 int nbins,
 PlotInfo plotInfo,
 String... byColumns)

Splits the specified range into nbins equally sized bins. Calculates the number of data values in each bin.

Data which is not finite as defined in Numeric.isFinite(java.lang.Byte) is filtered out of the data set.

Parameters:

table - table

histogramColumn - histogramColumn in table

rangeMin - range minimum

rangeMax - range maximum

nbins - number of bins

plotInfo - plot information

byColumns - other columns needed to calaculate histogram, these columns will be included while grouping

Returns:

table holding the calculated bins and their counts

Throws:

RequirementFailure - table and histogramColumn must not be null

RuntimeException - histogramColumn must be numeric

calc

public static Table calc(Table table,
 String histogramColumn,
 double rangeMin,
 double rangeMax,
 int nbins,
 PlotInfo plotInfo,
 List<String> byColumns)

Splits the specified range into nbins equally sized bins. Calculates the number of data values in each bin.

Data which is not finite as defined in Numeric.isFinite(java.lang.Byte) is filtered out of the data set.

Parameters:

table - table

histogramColumn - histogramColumn in table

rangeMin - range minimum

rangeMax - range maximum

nbins - number of bins

plotInfo - plot information

byColumns - other columns needed to calaculate histogram, these columns will be included while grouping

Returns:

table holding the calculated bins and their counts

Throws:

RequirementFailure - table and histogramColumn must not be null

RuntimeException - histogramColumn must be numeric