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