NAME

kdata_stddev_attach — attach source for standard deviation data plotting

LIBRARY

library “libkplot”

SYNOPSIS

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

int
kdata_stddev_attach(struct kdata *dst, struct kdata *source);

DESCRIPTION

The kdata_stddev_attach function attaches a data source source to a standard deviation data source dst allocated with kdata_stddev_alloc(3). The internal buffers will be increased, if necessary, to the size of the new buffer. If the buffer is increased, the standard deviation values of the new buckets are set to zero. The x-values of the new pairs are set to the new source's x-values.

Passing NULL as source will simply return.

RETURN VALUES

kdata_stddev_attach returns 0 if memory allocation failed or if dst was not allocated with kdata_stddev_alloc(3).

SEE ALSO

kdata_stddev_alloc(3), kplot(3)

Donald E. Knuth, The Art of Computer Programming: Seminumerical Algorithms, 3rd Edition, Addison-Wesley, Volume 2, 232, Boston, 1998.

CAVEATS

If you attach multiple sources with different x-values, the standard deviation x-values will be inconsistent.