Mathematica > Visualization and Graphics > Data Visualization >

Histogram3D

Histogram3D[{{x1, y1}, {x2, y2}, ...}]
plots a 3D histogram of the values {xi, yi}.
Histogram3D[{{x1, y1}, {x2, y2}, ...}, bspec]
plots a 3D histogram with bins specified by bspec.
Histogram3D[{{x1, y1}, {x2, y2}, ...}, bspec, hspec]
plots a 3D histogram with bin heights computed according to the specification hspec.
Histogram3D[{data1, data2, ...}]
plots 3D histograms for multiple datasets datai.
  • Histogram3D[data] by default plots a histogram with equal bins chosen to approximate an assumed underlying smooth distribution of the values {xi, yi}.
  • The x-width of each bin is computed according to the values xi; the y-width according to the yi.
  • The following bin specifications bpsec can be given:
nuse n bins
{w}use bins of width w
{min,max,w}use bins of width w from min to max
{{b1,b2,...}}use bins [b1, b2), [b2, b3), ...
Automaticdetermine bin widths automatically
"name"use a named binning method
fwapply fw to get an explicit bin specification {b1, b2, ...}
{xspec,yspec}give different x and y specifications
  • Possible named binning methods include:
"Sturges"compute the number of bins based on the length of data
"Scott"asymptotically minimize the mean square error
"FreedmanDiaconis"twice the interquartile range divided by the cube root of sample size
"Wand"one-level recursive approximate Wand binning
"Log"logarithmic bin widths
  • The function fw in Histogram3D[data, fw] is applied to a list of all {xi, yi}, and should return an explicit bin list {{bx1, bx2, ...}, {by1, by2, ...}}. In Histogram3D[data, {fx, fy}], fx is applied to the list of xi, and fy to the list of yi.
  • Different forms of 3D histogram can be obtained by giving different bin height specifications hspec in Histogram3D[data, w, hspec]. The following forms can be used:
"Count"the number of values lying in each 2D bin
"Probability"fraction of values lying in each 2D bin
"ProbabilityDensity"fraction of values divided by 2D bin area
"LogCount", "LogProbability", "LogProbabilityDensity"logarithmic heights
fhheights obtained by applying fh to bins and counts
  • The function fh in Histogram3D[data, bspec, fh] is applied to 3 arguments: a list of x bins {{bx1, bx2}, {bx2, ...}, ...}, a list of y bins {{by1, by2}, {by2, ...}, ...}, and the corresponding 2D array of counts {{c11, c12, ...}, {c21, ...}, ...}. The function should return an array of heights to be used for each of the cij.
  • Only values {xi, yi} that consist of real numbers are assigned to bins; others are taken to be missing.
  • In Histogram3D[{data1, data2, ...}, ...], automatic bin locations are determined by combining all the datasets datai.
  • Histogram3D[{..., wi[datai, ...], ...}, ...] renders the histogram elements associated with dataset datai according to the specification defined by the symbolic wrapper wi.
AxesTruewhether to draw axes
BarOriginBottomorigin of histogram bars
BoxRatios{1,1,0.4}bounding 3D box ratios
ChartBaseStyleAutomaticoverall style for bars
ChartElementFunctionAutomatichow to generate raw graphics for bars
ChartElementsAutomaticgraphics to use in each of the bars
ChartLabelsNonecategory labels for datasets
ChartLayoutAutomaticoverall layout to use
ChartLegendsNonelegends for data elements and datasets
ChartStyleAutomaticstyle for bars
ColorFunctionAutomatichow to color bars
ColorFunctionScalingTruewhether to normalize arguments to ColorFunction
LabelingFunctionAutomatichow to label elements
LegendAppearanceAutomaticoverall appearance of legends
Lighting"Neutral"simulated light sources to use
MethodAutomaticmethods to use
PerformanceGoal$PerformanceGoalaspects of performance to try to optimize
  • Possible settings for ChartLayout include "Overlapped" and "Stacked".
  • The arguments supplied to ChartElementFunction are the bin region {{xmin, xmax}, {ymin, ymax}, {zmin, zmax}}, the bin values lists, and metadata {m1, m2, ...} from each level in a nested list of datasets.
  • A list of built-in settings for ChartElementFunction can be obtained from ChartElementData["Histogram3D"].
  • The argument supplied to ColorFunction is the height for each bin.
New in 7
Ask a question about this page  |  Suggest an improvement  |  Leave a message for the team