NAME
plot_multiple_histograms - Plots multiple histograms on the same scale
SYNOPSIS
#include "p/p_plot.h"
Example compile flags (system dependent):
-DLINUX_X86_64 -DLINUX_X86_64_OPTERON -DGNU_COMPILER
-I/home/kobus/include
-L/home/kobus/misc/load/linux_x86_64_opteron -L/usr/lib/x86_64-linux-gnu
-lKJB -lfftw3 -lgsl -lgslcblas -ljpeg -lSVM -lstdc++ -lpthread -lSLATEC -lg2c -lacml -lacml_mv -lblas -lg2c -lncursesw
int plot_multiple_histograms
(
int plot_id,
const Vector_vector *vvp,
int num_bins,
double sigma,
const Word_list *names_ptr,
double *bin_size_ptr
);
DESCRIPTION
This routine allows multiple histograms to be plotted together. The source
data for the histograms are supplied in the vector of vectors in the second
argument. If the fourth parameter (sigma) is positive, it is used to smooth
the histograms. If names_ptr is not NULL, than it is used to label the
histograms. Finally, if bin_size_ptr is not NULL, then it retrieves the bin
size, as a function of the number of bins requested, and all the data used.
RETURNS
NO_ERROR on success, and ERROR on failure, with an error message being
set.
NOTE
When multiple histograms are being plotted, we make it so that the bins
for the various groups are the same. This means that the bins are a
function of the groups, which means that the histograms are also a
function of the group.
DISCLAIMER
This software is not adequatedly tested. It is recomended that
results are checked independantly where appropriate.
AUTHOR
Kobus Barnard
DOCUMENTER
Kobus Barnard
SEE ALSO
push_display_plot_flag
,
pop_display_plot_flag
,
plot_open
,
plot_open3
,
special_plot_open
,
save_plot
,
save_plot_as_pbm
,
save_plot_dir
,
send_command_to_plot
,
plot_set_title
,
plot_set_x_legend
,
plot_set_y_legend
,
plot_add_label
,
plot_add_label_2
,
plot_set_range
,
plot_get_range
,
plot_set_range3
,
plot_function_string
,
plot_selected_multiple_histograms
,
plot_multiple_bars
,
plot_multiple_bars_2
,
plot_histogram
,
plot_bars
,
plot_bars_2
,
plot_vector
,
plot_point_list
,
plot_vector_point
,
plot_point
,
plot_matrix_row_points
,
plot_points
,
plot_curve
,
plot_line
,
plot_multi_segment_curve
,
plot_matrix_vector_list_cols
,
plot_matrix_vector_cols
,
plot_segments
,
plot_matrix_cols
,
plot_matrix_rows
,
plot_multi_matrix_rows
,
plot_matrix_values
,
plot_matrix_values_2
,
plot_update
,
plot_clear
,
plot_close
,
plot_close_all
,
plot_write
,
plot3_points
,
plot3_curve