1 /* PSPP - computes sample statistics.
2 Copyright (C) 2004 Free Software Foundation, Inc.
3 Written by John Darrington <john@darrington.wattle.id.au>
5 This program is free software; you can redistribute it and/or
6 modify it under the terms of the GNU General Public License as
7 published by the Free Software Foundation; either version 2 of the
8 License, or (at your option) any later version.
10 This program is distributed in the hope that it will be useful, but
11 WITHOUT ANY WARRANTY; without even the implied warranty of
12 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
13 General Public License for more details.
15 You should have received a copy of the GNU General Public License
16 along with this program; if not, write to the Free Software
17 Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA
26 #include <gsl/gsl_histogram.h>
34 /* Array of standard colour names */
35 extern const char *data_colour[];
42 plPlotterParams *pl_params;
45 /* The geometry of the chart
46 See diagram at the foot of this file.
64 /* Default font size for the plot (if zero, then use plotter default) */
69 /* Stuff Particular to Cartesians (and Boxplots ) */
70 double ordinate_scale;
71 double abscissa_scale;
80 int chart_initialise(struct chart *ch);
82 void chart_finalise(struct chart *ch);
85 double chart_rounded_tick(double tick);
87 void chart_write_xlabel(struct chart *ch, const char *label);
88 void chart_write_ylabel(struct chart *ch, const char *label);
90 void chart_write_title(struct chart *ch, const char *title, ...);
92 enum tick_orientation {
97 void draw_tick(struct chart *ch, enum tick_orientation orientation,
98 double position, const char *label, ...);
109 void draw_barchart(struct chart *ch, const char *title,
110 const char *xlabel, const char *ylabel, enum bar_opts opt);
112 void draw_box_whisker_chart(struct chart *ch, const char *title);
124 void histogram_write_legend(struct chart *ch, const struct normal_curve *norm);
127 /* Plot a gsl_histogram */
128 void histogram_plot(const gsl_histogram *hist, const char *factorname,
129 const struct normal_curve *norm, short show_normal);
132 /* Create a gsl_histogram and set it's parameters based upon
133 x_min, x_max and bins.
134 The caller is responsible for freeing the histogram.
136 gsl_histogram * histogram_create(double bins, double x_min, double x_max) ;
150 /* Draw a piechart */
151 void piechart_plot(const char *title,
152 const struct slice *slices, int n_slices);
154 void draw_scatterplot(struct chart *ch);
157 void draw_lineplot(struct chart *ch);
160 /* Set the scale on chart CH.
161 The scale extends from MIN to MAX .
162 TICK is the approximate number of tick marks.
165 void chart_write_xscale(struct chart *ch,
166 double min, double max, int ticks);
168 void chart_write_yscale(struct chart *ch,
169 double min, double max, int ticks);
172 void chart_datum(struct chart *ch, int dataset, double x, double y);
177 void boxplot_draw_boxplot(struct chart *ch,
184 void boxplot_draw_yscale(struct chart *ch , double y_max, double y_min);
194 void chart_line(struct chart *ch, double slope, double intercept,
195 double limit1, double limit2, enum CHART_DIM limit_d);
201 The anatomy of a chart is as follows.
203 +-------------------------------------------------------------+
204 | +----------------------------------+ |
208 | +----------------------------------+ |
209 |+----------++----------------------------------++-----------+|
220 || Ordinate || Data || Legend ||
231 |+----------++----------------------------------++-----------+| --
232 | +----------------------------------+ | - ^ data_bottom
234 | | | | | abscissa_top
235 | +----------------------------------+ | v v
236 +-------------------------------------------------------------+ ----
246 |<--------------------------------------------->|| |
248 |<---------------------------------------------->| |
250 |<---------------------------------------------------------->|