NAME

Data::BenchmarkResults - Perl extension for averaging and comparing multiple benchmark runs.

SYNOPSIS

  use Data::BenchmarkResults;
  $conditionA_results = new Data::BenchmarkResults;
  $conditionB_results = new Data::BenchmarkResults;
  
  #Load test result runs for the first condition
  $conditionA_results->add_result_set("test1","run1",\@data1);
  $conditionA_results->add_result_set("test2","run1",\@data2);
  $conditionA_results->add_result_set("test1","run2",\@data3);
  $conditionA_results->add_result_set("test2","run2",\@data4);
  
  #Load test result runs for the second condition
  $conditionB_results->add_result_set("test1","run1",\@data5);
  $conditionB_results->add_result_set("test2","run2",\@data6);
  $conditionB_results->add_result_set("test1","run1",\@data7);
  $conditionB_results->add_result_set("test2","run2",\@data8);
  
  #Average (mean average) the results of all the the runs of 'test1'
  # w/o tossing the highest and lowest values (replace the '0' with '1'to
  # toss the highest and lowest values
  
  my $computed = $conditionA_results->process_result_set("test1","mean",0);
  my $computed2 = $conditionB_results->process_result_set("test1","mean",0);
  
  #OR process all of the tests at once (tossing the highest and lowest value) :
  
  $conditionA_results->process_all_result_sets("mean",1);
  $conditionB_results->process_all_result_sets("mean",1);


  #Print out all of the processed test results
  print "Condition A results.... \n\n"
  $conditionA_results->print_calculated_sets;
  print "Condition B results.... \n\n"
  $conditionB_results->print_calculated_sets;


  #Compare results of 'test1' of condition B against those with condition A
  # as a percentage change from A to B
  
  my $compared = $conditionB_results->compare_result_set($conditionA_results,"test1");

  #OR compare all the processed test results from one condition to those of another
  my $total_comparison = $conditionB_results->compare_all_result_sets($conditionA_results);

DESCRIPTION

new

add_result_set

add_computed_set

process_result_set

process_all_result_sets

compare_result_set

compare_all_result_sets

print_calculated_sets

EXPORT

None by default.

AUTHOR

Jason Titus, jasontitus@tiltastech.com

SEE ALSO

perl(1).