Calculate Frequency Histogram¶

Group (Subgroup)¶

Statistics (Ensemble)

Description¶

This Filter will create a "frequency distribution" histogram of a specified scalar Attribute Array. The user will select the number of bins (a value greater than zero). The user will enter a new Attribute Matrix name and a new histogram Attribute Array name. If the user clicks the new Data Container check box, a new Data Container name must be entered. Otherwise the current Data Container will be used.

The histogram is a "Left Closed, Right Open" histogram, meaning the bin intervals are denoted as [a, b). The value returned in component "0" of the output array is b from the above interval while component "1" is the frequency for that bin. The output output array can be most easily be thought of as a 2 column x "num bins" row output.

Example Data¶

Using some data about the "Old Faithful" geyser in the United States from the R site, here is the top few lines of data:

Duration, Wait Time
{3.6,79},
{1.8,54},
{3.333,74},
{2.283,62},
{4.533,85},
{2.883,55},
{4.7,88},
   ..

Example Output¶

The range on the data is [1.6, 5.1]. Using 8 bins starting from 1.5 with a bin width of 0.5 the expected output for a "Left Closed, Right Open" histogram is the following table data.

[1.5,2)            51 
[2,2.5)            41 
[2.5,3)             5 
[3,3.5)             7 
[3.5,4)            30 
[4,4.5)            73 
[4.5,5)            61 
[5,5.5)             4

Example Plot¶

Example Plot of the Frequency Data from the Old Faithful data set

Additional Information¶

Also see Histogram Quick Reference at https://plot.ly/histogram/.

Parameters¶

Name	Type	Description
Number of Bins	int32_t	Specifies number of histogram bins (greater than zero)
Use Min & Max Range	bool	Whether the user can set the min and max values to consider for the histogram
Min Value	float	Specifies the lower bound of the histogram. Only needed if Use Min & Max Range is checked
Max Value	float	Specifies the upper bound of the histogram. Only needed if Use Min & Max Range is checked
New Data Container	bool	Whether the output array will be stored in a new Data Container or the existing one

Required Geometry¶

Not Applicable

Required Objects¶

Kind	Default Name	Type	Component Dimensions	Description
Any Attribute Array	None	Any	(1)	Array to calculate histogram of (must be a scalar array)

Created Objects¶

Kind	Default Name	Type	Component Dimensions	Description
Data Container	NewDataContainer	N/A	N/A	Created Data Container name. Only created if Use Min & Max Range is checked
Attribute Matrix	NewAttributeMatrixName	Generic	N/A	Created Attribute Matrix name
Any Attribute Array	Histogram	double	(2)	Two component array with [Bin cutoff {right side}, Frequency] values for each bin

Example Pipelines¶

Image Histogram
Confidence Index Histogram

License & Copyright¶

Please see the description file distributed with this Plugin

DREAM.3D Mailing Lists¶

If you need more help with a Filter, please consider asking your question on the DREAM.3D Users Google group!

Appendix¶

Example Data¶

Index, Duration, Wait Time
{1,3.6,79},
{2,1.8,54},
{3,3.333,74},
{4,2.283,62},
{5,4.533,85},
{6,2.883,55},
{7,4.7,88},
{8,3.6,85},
{9,1.95,51},
{10,4.35,85},
{11,1.833,54},
{12,3.917,84},
{13,4.2,78},
{14,1.75,47},
{15,4.7,83},
{16,2.167,52},
{17,1.75,62},
{18,4.8,84},
{19,1.6,52},
{20,4.25,79},
{21,1.8,51},
{22,1.75,47},
{23,3.45,78},
{24,3.067,69},
{25,4.533,74},
{26,3.6,83},
{27,1.967,55},
{28,4.083,76},
{29,3.85,78},
{30,4.433,79},
{31,4.3,73},
{32,4.467,77},
{33,3.367,66},
{34,4.033,80},
{35,3.833,74},
{36,2.017,52},
{37,1.867,48},
{38,4.833,80},
{39,1.833,59},
{40,4.783,90},
{41,4.35,80},
{42,1.883,58},
{43,4.567,84},
{44,1.75,58},
{45,4.533,73},
{46,3.317,83},
{47,3.833,64},
{48,2.1,53},
{49,4.633,82},
{50,2,59},
{51,4.8,75},
{52,4.716,90},
{53,1.833,54},
{54,4.833,80},
{55,1.733,54},
{56,4.883,83},
{57,3.717,71},
{58,1.667,64},
{59,4.567,77},
{60,4.317,81},
{61,2.233,59},
{62,4.5,84},
{63,1.75,48},
{64,4.8,82},
{65,1.817,60},
{66,4.4,92},
{67,4.167,78},
{68,4.7,78},
{69,2.067,65},
{70,4.7,73},
{71,4.033,82},
{72,1.967,56},
{73,4.5,79},
{74,4,71},
{75,1.983,62},
{76,5.067,76},
{77,2.017,60},
{78,4.567,78},
{79,3.883,76},
{80,3.6,83},
{81,4.133,75},
{82,4.333,82},
{83,4.1,70},
{84,2.633,65},
{85,4.067,73},
{86,4.933,88},
{87,3.95,76},
{88,4.517,80},
{89,2.167,48},
{90,4,86},
{91,2.2,60},
{92,4.333,90},
{93,1.867,50},
{94,4.817,78},
{95,1.833,63},
{96,4.3,72},
{97,4.667,84},
{98,3.75,75},
{99,1.867,51},
{100,4.9,82},
{101,2.483,62},
{102,4.367,88},
{103,2.1,49},
{104,4.5,83},
{105,4.05,81},
{106,1.867,47},
{107,4.7,84},
{108,1.783,52},
{109,4.85,86},
{110,3.683,81},
{111,4.733,75},
{112,2.3,59},
{113,4.9,89},
{114,4.417,79},
{115,1.7,59},
{116,4.633,81},
{117,2.317,50},
{118,4.6,85},
{119,1.817,59},
{120,4.417,87},
{121,2.617,53},
{122,4.067,69},
{123,4.25,77},
{124,1.967,56},
{125,4.6,88},
{126,3.767,81},
{127,1.917,45},
{128,4.5,82},
{129,2.267,55},
{130,4.65,90},
{131,1.867,45},
{132,4.167,83},
{133,2.8,56},
{134,4.333,89},
{135,1.833,46},
{136,4.383,82},
{137,1.883,51},
{138,4.933,86},
{139,2.033,53},
{140,3.733,79},
{141,4.233,81},
{142,2.233,60},
{143,4.533,82},
{144,4.817,77},
{145,4.333,76},
{146,1.983,59},
{147,4.633,80},
{148,2.017,49},
{149,5.1,96},
{150,1.8,53},
{151,5.033,77},
{152,4,77},
{153,2.4,65},
{154,4.6,81},
{155,3.567,71},
{156,4,70},
{157,4.5,81},
{158,4.083,93},
{159,1.8,53},
{160,3.967,89},
{161,2.2,45},
{162,4.15,86},
{163,2,58},
{164,3.833,78},
{165,3.5,66},
{166,4.583,76},
{167,2.367,63},
{168,5,88},
{169,1.933,52},
{170,4.617,93},
{171,1.917,49},
{172,2.083,57},
{173,4.583,77},
{174,3.333,68},
{175,4.167,81},
{176,4.333,81},
{177,4.5,73},
{178,2.417,50},
{179,4,85},
{180,4.167,74},
{181,1.883,55},
{182,4.583,77},
{183,4.25,83},
{184,3.767,83},
{185,2.033,51},
{186,4.433,78},
{187,4.083,84},
{188,1.833,46},
{189,4.417,83},
{190,2.183,55},
{191,4.8,81},
{192,1.833,57},
{193,4.8,76},
{194,4.1,84},
{195,3.966,77},
{196,4.233,81},
{197,3.5,87},
{198,4.366,77},
{199,2.25,51},
{200,4.667,78},
{201,2.1,60},
{202,4.35,82},
{203,4.133,91},
{204,1.867,53},
{205,4.6,78},
{206,1.783,46},
{207,4.367,77},
{208,3.85,84},
{209,1.933,49},
{210,4.5,83},
{211,2.383,71},
{212,4.7,80},
{213,1.867,49},
{214,3.833,75},
{215,3.417,64},
{216,4.233,76},
{217,2.4,53},
{218,4.8,94},
{219,2,55},
{220,4.15,76},
{221,1.867,50},
{222,4.267,82},
{223,1.75,54},
{224,4.483,75},
{225,4,78},
{226,4.117,79},
{227,4.083,78},
{228,4.267,78},
{229,3.917,70},
{230,4.55,79},
{231,4.083,70},
{232,2.417,54},
{233,4.183,86},
{234,2.217,50},
{235,4.45,90},
{236,1.883,54},
{237,1.85,54},
{238,4.283,77},
{239,3.95,79},
{240,2.333,64},
{241,4.15,75},
{242,2.35,47},
{243,4.933,86},
{244,2.9,63},
{245,4.583,85},
{246,3.833,82},
{247,2.083,57},
{248,4.367,82},
{249,2.133,67},
{250,4.35,74},
{251,2.2,54},
{252,4.45,83},
{253,3.567,73},
{254,4.5,73},
{255,4.15,88},
{256,3.817,80},
{257,3.917,71},
{258,4.45,83},
{259,2,56},
{260,4.283,79},
{261,4.767,78},
{262,4.533,84},
{263,1.85,58},
{264,4.25,83},
{265,1.983,43},
{266,2.25,60},
{267,4.75,75},
{268,4.117,81},
{269,2.15,46},
{270,4.417,90},
{271,1.817,46},
{272,4.467,74}}