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