NAME
plot_selected_multiple_histograms - Plots selected multiple histograms
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_selected_multiple_histograms
(
int plot_id,
const Vector_vector *vvp,
int num_bins,
double sigma,
const Word_list *names_ptr,
const Int_vector *enable_vp,
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. If enable_vp is not NULL, then enables/disables the
corresponding histogram. 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
If enable_vp is NULL, this routine is equivalent to
plot_multiple_histograms().
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_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