Scilab Website | Contribute with GitLab | Mailing list archives | ATOMS toolboxes
Scilab Online Help
5.4.0 - English

Change language to:
Français - 日本語 - Português - Русский

Please note that the recommended version of Scilab is 2024.0.0. This page might be outdated.
See the recommended documentation of this function

Scilab help >> Graphics > 2d_plot > histplot


plot a histogram

Calling Sequence

histplot(n, data, <opt_args>)
histplot(x, data, <opt_args>)



positive integer (number of classes)


increasing vector defining the classes (x may have at least 2 components)


vector (data to be analysed)


This represents a sequence of statements key1=value1,key2=value2 ,... where key1, key2,... can be any optional plot2d parameter (style,strf,leg, rect,nax, logflag,frameflag, axesflag )or normalization. For this last one the corresponding value must be a boolean scalar (default value %t).


This function plot a histogram of the data vector using the classes x. When the number n of classes is provided instead of x, the classes are chosen equally spaced and x(1) = min(data) < x(2) = x(1) + dx < ... < x(n+1) = max(data) with dx = (x(n+1)-x(1))/n.

The classes are defined by C1 = [x(1), x(2)] and Ci = ( x(i), x(i+1)] for i >= 2. Noting Nmax the total number of data (Nmax = length(data)) and Ni the number of data components falling in Ci, the value of the histogram for x in Ci is equal to Ni/(Nmax (x(i+1)-x(i))) when normalization is true (default case) and else, simply equal to Ni. When normalization occurs the histogram verifies:

when x(1)<=min(data) and max(data) <= x(n+1)

Any plot2d (optional) parameter may be provided; for instance to plot a histogram with the color number 2 (blue if std colormap is used) and to restrict the plot inside the rectangle [-3,3]x[0,0.5], you may use histplot(n,data, style=2, rect=[-3,0,3,0.5]).

Enter the command histplot() to see a demo.


  • Example #1: variations around a histogram of a gaussian random sample
    d=rand(1,10000,'normal');  // the gaussian random sample
    clf();histplot(20,d,leg='rand(1,10000,''normal'')',style=16, rect=[-3,0,3,0.5]);
  • Example #2: histogram of a binomial (B(6,0.5)) random sample
    d = grand(1000,1,"bin", 6, 0.5);
    c = linspace(-0.5,6.5,8);
    histplot(c, d, style=2)
    xtitle("normalized histogram")
    histplot(c, d, normalization=%f, style=5)
    xtitle("non normalized histogram")
  • Example #3: histogram of an exponential random sample
    lambda = 2;
    X = grand(100000,1,"exp", 1/lambda);
    Xmax = max(X);
    histplot(40, X, style=2)
    x = linspace(0,max(Xmax),100)';
    legend(["exponential random sample histogram" "exact density curve"]);

See Also

  • hist3d — 3D representation of a histogram
  • plot2d — 2D plot
  • dsearch — search in ordered sets
Report an issue
<< graypolarplot 2d_plot paramfplot2d >>

Copyright (c) 2022-2023 (Dassault Systèmes)
Copyright (c) 2017-2022 (ESI Group)
Copyright (c) 2011-2017 (Scilab Enterprises)
Copyright (c) 1989-2012 (INRIA)
Copyright (c) 1989-2007 (ENPC)
with contributors
Last updated:
Mon Oct 01 17:34:52 CEST 2012