DensityHistogram

DensityHistogram[{{x1, y1}, {x2, y2}, ...}]
plots a density histogram of the values .

DensityHistogram[{{x1, y1}, {x2, y2}, ...}, bspec]
plots a density histogram with bins specified by bspec.

DensityHistogram[{{x1, y1}, {x2, y2}, ...}, bspec, hspec]
plots a density histogram with bin densities computed according to the specification hspec.

Details and OptionsDetails and Options

  • DensityHistogram[data] by default plots a histogram with equal bins chosen to approximate an assumed underlying smooth distribution of the values .
  • The -width of each bin is computed according to the values , and the -width according to the values .
  • The following bin specifications bspec 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
    Automaticdetermine bin widths automatically
    "name"use a named binning method
    {"Log",bspec}apply binning bspec on log transformed data
    fbapply fb to get an explicit bin specification
    {xspec,yspec}give different x and y specifications
  • The binning specification is taken to use the Automatic underlying binning method.
  • 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
    "Knuth"balance likelihood and prior probability of a piecewise uniform model
    "Wand"one-level recursive approximate Wand binning
  • The function fb in DensityHistogram[data, fb] is applied to a list of all , and should return an explicit bin list . In DensityHistogram[data, {fx, fy}], fx is applied to the list of , and fy to the list of .
  • Different forms of density histogram can be obtained by giving different bin density specifications hspec in DensityHistogram[data, bspec, hspec]. The following forms can be used:
  • "Count"the number of values lying in each bin
    "CumulativeCount"cumulative counts
    "SurvivalCount"survival counts
    "Probability"fraction of values lying in each bin
    "PDF"probability density function
    "CDF"cumulative distribution function
    "SF"survival function
    "HF"hazard function
    "CHF"cumulative hazard function
    {"Log",hspec}log transformed height specification
    fhheights obtained by applying fh to bins and counts
  • The function fh in DensityHistogram[data, bspec, fh] is applied to three arguments: a list of bins , a list of bins , and the corresponding 2D array of counts . The function should return an array of densities to be used for each of the .
  • Only values that consist of real numbers are assigned to bins; others are taken to be missing.
  • DensityHistogram has the same options as Graphics with the following additions and changes:
  • AspectRatio1ratio of height to width
    ChartBaseStyleAutomaticoverall style for tiles
    ChartElementFunctionAutomatichow to generate raw graphics for tiles
    ClippingStyleNonehow to draw values clipped by PlotRange
    ColorFunctionAutomatichow to color the plot
    ColorFunctionScalingTruewhether to scale the argument to ColorFunction
    FrameTruewhether to draw a frame around the plot
    FrameTicksAutomaticframe tick marks
    LabelingFunctionAutomatichow to label elements
    MethodAutomaticthe method to use for refining the plot
    PerformanceGoal$PerformanceGoalaspects of performance to try to optimize
    PlotRangeAutomaticthe range of f or other values to include
    PlotRangeClippingTruewhether to clip at the plot range
    PlotRangePaddingAutomatichow much to pad the range of values
    ScalingFunctionsNonehow to scale individual coordinates
  • The arguments supplied to ChartElementFunction are the bin region , the bin values lists, and metadata .
  • The argument supplied to ColorFunction is the density for each bin.
  • With ScalingFunctions->{sx, sy, sz}, the -coordinate is scaled using etc.
  • Style and other options are effectively applied in the order ChartBaseStyle, ColorFunction, and ChartElementFunction, with later specifications overriding earlier ones.

ExamplesExamplesopen allclose all

Basic Examples (2)Basic Examples (2)

Plot a density histogram for a dataset:

In[1]:=
Click for copyable input
Out[1]=

Plot the probability density function of the data:

In[1]:=
Click for copyable input
In[2]:=
Click for copyable input
Out[2]=

Cumulative distribution function:

In[3]:=
Click for copyable input
Out[3]=

Survival function:

In[4]:=
Click for copyable input
Out[4]=

Hazard function:

In[5]:=
Click for copyable input
Out[5]=

Cumulative hazard function:

In[6]:=
Click for copyable input
Out[6]=
New in 8
New to Mathematica? Find your learning path »
Have a question? Ask support »