NAME

kdata_hist_alloc — allocate histogram data for plotting

LIBRARY

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)