Table Histogram
Use a Table Histogram node in 1D () or 2D () to plot a histogram that shows how a quantity is distributed over the geometry (mesh volume) based on data from a table or evaluation group. In 1D histograms, the x-axis in the histogram represents the values of the quantity (as a number of bins or a range of values), and the y-axis represents the count of the total element volume in each interval. You can also view the histogram as a plot showing the area between contours or isosurfaces. In 2D histograms, the x-axis and y-axis represent the values of two quantities (as a number of bins or a range of values), and the color surface represents the count of the total element volume in each “bin”. The histogram can be normalized and also displayed as a cumulative plot, and it can appear as a discrete or a continuous function. You can use a histogram with settings that provide a bar chart of, for example, the distribution of values in different ranges. To add a table histogram, right-click a 1D Plot Group or 2D Plot Group and select this plot from the More Plots or More Point Plots submenu, respectively. Add Height Expression (2D only), Transparency (with Height Expression only), and Visual Effects (with Height Expression only) subnodes if required.
•
Go to Common Results Node Settings for links to information about these sections: Title, and Coloring and Style.
•
For a 2D histogram based on a precomputed matrix of data, see Matrix Histogram.
Data
From the Source list choose Table or Evaluation group as the data source. Depending on the chosen type of data source, choose a table or an evaluation group from the Table list or Evaluation group list, respectively.
From the x-coordinates and y-coordinates (2D only) lists, choose one of the table columns as the coordinate.
Bins
Select an Entry method — Number of bins or Limits — to define the bins for the histogram’s x-axis. Select Number of bins (the default) to specify the number of bins (default is 10), or select Limits to specify a range of limits (1 2 3 4, for example) for the histogram bins.
For 2D Histogram nodes, these settings are available for the x direction and y direction under x bins and y bins.
Output
Under Output, specify some properties for the appearance of the histogram. Specify whether to use a continuous or discrete function for the histogram, the normalization, and whether to use a standard or a cumulative histogram.
From the Function list, choose Discrete (the default) to plot it as a discrete function (that is, using a constant level in each bin) or Continuous to plot the histogram as a continuous function. The discrete version is useful to display the histogram as a bar chart, perhaps with the Integral normalization setting so that each bin (bar) shows its relative size and (for 1D only) the Type set to Bar under Coloring and Style for filled histogram bins.
From the Normalization list, select:
•
 Sum of values to normalize the histogram so that the integral is equal to 1 by dividing the absolute count of each bin by the sum of the counts over all bins. Use this normalization to get the relative size (percentage) of values in each bin.
•
 Integral to normalize the histogram by dividing the absolute count of each bin by the sum of the counts over all bins, each multiplied by the width of the bin.
•
 None (the default) to show the actual element volume without any normalization.
•
 Peak to normalize the histogram so that the peak value is equal to 1.
Select the Cumulative checkbox to make the histogram cumulative (that is, the value in each bin is the sum of the values for all bins up to the current one).