home | help
KDATA_HIST_ALLOC(3)	     Library Functions Manual	     KDATA_HIST_ALLOC(3)

NAME
     kdata_hist_alloc -- allocate histogram data for plotting

LIBRARY
     libkplot

SYNOPSIS
     #include <cairo.h>
     #include <kplot.h>

     struct kdata *
     kdata_hist_alloc(double rmin, double rmax, size_t bins);

DESCRIPTION
     The  kdata_hist_alloc function creates a reference-counted data sources for
     kplot(3).	The histogram is initialised with x-values  set  to  the  bucket
     minimum and y-values set to zero.	It uses a histogram data model: the data
     array is laid out in uniformly-spaced buckets of size (rmax - rmin) / bins,
     with  a  given value x falling into bucket [i / bins * (rmax - rmin) <= x <
     (i + 1) /	bins  *  (rmax	-  rmin)].   Bucket  values  are  modified  with
     kdata_hist_add(3) and kdata_hist_set(3).

RETURN VALUES
     kdata_hist_alloc returns NULL if memory allocation failed.

SEE ALSO
     kdata_hist_add(3), kplot(3)

FreeBSD ports 15.quarterly	January 16, 2015	     KDATA_HIST_ALLOC(3)

home | help