annotate Histogram.c @ 16:f4d96eaf374a

updated for VMS name chgs from VMS__malloc to VMS_int__malloc
author Me@portablequad
date Sun, 12 Feb 2012 01:45:40 -0800
parents 32489b8b763c
children cd8275f62ee1 4d9af65ad3df
rev   line source
Me@0 1 /*
Me@0 2 * Copyright 2010 OpenSourceStewardshipFoundation.org
Me@0 3 * Licensed under GNU General Public License version 2
Me@0 4 *
Me@0 5 * Author: seanhalle@yahoo.com
Me@0 6 *
Me@0 7 */
Me@4 8 #include <stdio.h>
Me@0 9 #include "Histogram.h"
Me@0 10
msach@10 11 //External variables for saving of the histogram
msach@10 12 //These have to be defined by to plugins in order to enable VMS to print this
msach@10 13 //information to the histogram file
msach@10 14 extern char __ProgrammName[]; //Defined in main.c
msach@10 15 extern char __Scheduler[]; //Defined in VPThread_PluginFns.c
msach@10 16 extern char __DataSet[255];
Me@0 17
Me@0 18 /*This Histogram Abstract Data Type has a number of bins plus a range of
Me@0 19 * values that the bins span, both chosen at creation.
Me@0 20 *
Me@0 21 *One creates a Histogram instance using the makeHistogram function, then
Me@0 22 * updates it with the addToHist function, and prints it out with the
Me@0 23 * printHist function.
Me@0 24 *
Me@0 25 *Note, the bin width is an integer, so the end of the range is adjusted
Me@0 26 * accordingly. Use the bin-width to calculate the bin boundaries.
Me@0 27 */
Me@0 28
Me@0 29
Me@0 30 Histogram *
SeanHalle@5 31 makeHistogram( int32 numBins, int32 startOfRange, int32 endOfRange )
Me@0 32 {
Me@0 33 Histogram *hist;
SeanHalle@5 34 int32 i;
Me@0 35
Me@0 36
Me@16 37 hist = VMS_int__malloc( sizeof(Histogram) );
Me@16 38 hist->bins = VMS_int__malloc( numBins * sizeof(int32) );
Me@0 39
Me@0 40 hist->numBins = numBins;
Me@0 41 hist->binWidth = (endOfRange - startOfRange) / numBins;
Me@0 42 hist->endOfRange = startOfRange + hist->binWidth * numBins;
Me@0 43 hist->startOfRange = startOfRange;
Me@0 44
Me@0 45 for( i = 0; i < hist->numBins; i++ )
Me@0 46 {
Me@0 47 hist->bins[ i ] = 0;
Me@0 48 }
Me@0 49
Me@7 50 hist->name = NULL;
Me@7 51 return hist;
Me@7 52 }
Me@7 53
Me@7 54 inline void
Me@7 55 makeHist_helper( Histogram *hist, int32 numBins,
Me@7 56 int32 startOfRange, int32 binWidth, char *nameCopy )
Me@7 57 {
Me@7 58 hist->numBins = numBins;
Me@7 59 hist->binWidth = binWidth;
Me@7 60 hist->endOfRange = startOfRange + hist->binWidth * numBins;
Me@7 61 hist->startOfRange = startOfRange;
Me@7 62 hist->name = nameCopy;
Me@7 63 memset( hist->bins, 0, numBins * sizeof(int32) );
Me@7 64 }
Me@7 65
Me@7 66
Me@7 67 Histogram *
Me@7 68 makeFixedBinHist( int32 numBins, int32 startOfRange, int32 binWidth,
Me@7 69 char *name )
Me@7 70
Me@7 71 {
Me@7 72 Histogram *hist;
Me@7 73
Me@16 74 hist = VMS_int__malloc( sizeof(Histogram) );
Me@16 75 hist->bins = VMS_int__malloc( numBins * sizeof(int32) );
Me@7 76
Me@16 77 makeHist_helper( hist, numBins, startOfRange, binWidth,VMS_int__strDup(name));
Me@7 78
Me@7 79 return hist;
Me@7 80 }
Me@7 81
Me@7 82 Histogram *
Me@15 83 makeFixedBinHistExt( int32 numBins, int32 startOfRange, int32 binWidth,
Me@7 84 char *name )
Me@7 85
Me@7 86 {
Me@7 87 Histogram *hist;
Me@7 88
Me@7 89 hist = malloc( sizeof(Histogram) );
Me@7 90 hist->bins = malloc( numBins * sizeof(int32) );
Me@7 91
Me@7 92 makeHist_helper( hist, numBins, startOfRange, binWidth, strdup(name));
Me@7 93
Me@0 94 return hist;
Me@0 95 }
Me@0 96
SeanHalle@5 97 void inline
SeanHalle@5 98 addToHist( int32 value, Histogram *hist )
Me@0 99 {
SeanHalle@5 100 int32 binIdx;
Me@0 101
Me@0 102 if( value < hist->startOfRange )
Me@0 103 { binIdx = 0;
Me@0 104 }
Me@0 105 else if( value > hist->endOfRange )
Me@0 106 { binIdx = hist->numBins - 1;
Me@0 107 }
Me@0 108 else
Me@0 109 {
Me@0 110 binIdx = (value - hist->startOfRange) / hist->binWidth;
Me@0 111 }
Me@0 112
Me@0 113 hist->bins[ binIdx ] += 1;
Me@0 114 }
Me@0 115
Me@8 116 void inline
Me@8 117 subFromHist( int32 value, Histogram *hist )
Me@8 118 {
Me@8 119 int32 binIdx;
Me@8 120
Me@8 121 if( value < hist->startOfRange )
Me@8 122 { binIdx = 0;
Me@8 123 }
Me@8 124 else if( value > hist->endOfRange )
Me@8 125 { binIdx = hist->numBins - 1;
Me@8 126 }
Me@8 127 else
Me@8 128 {
Me@8 129 binIdx = (value - hist->startOfRange) / hist->binWidth;
Me@8 130 }
Me@8 131
Me@8 132 hist->bins[ binIdx ] -= 1;
Me@8 133 }
Me@8 134
SeanHalle@5 135
Me@7 136 /*Inline because use with RDTSC in innermost code so need ultra-fast
Me@7 137 */
SeanHalle@5 138 void inline
msach@10 139 addIntervalToHist( uint32 startIntvl, uint32 endIntvl, Histogram *hist )
SeanHalle@5 140 {
SeanHalle@5 141 int32 value;
SeanHalle@5 142
SeanHalle@5 143 value = endIntvl - startIntvl;
SeanHalle@5 144 if( value < 0 || value > 10000000 ) return; //sanity check
SeanHalle@5 145 addToHist( value, hist );
SeanHalle@5 146 }
SeanHalle@5 147
Me@8 148 void inline
Me@8 149 subIntervalFromHist( int32 startIntvl, int32 endIntvl, Histogram *hist )
Me@8 150 {
Me@8 151 int32 value;
Me@8 152
Me@8 153 value = endIntvl - startIntvl;
Me@8 154 if( value < 0 || value > 10000000 ) return; //sanity check
Me@8 155 subFromHist( value, hist );
Me@8 156 }
Me@8 157
Me@0 158 void
msach@10 159 saveHistToFile(Histogram *hist)
msach@10 160 {
msach@10 161 FILE *output;
msach@10 162 int32 binIdx, binStart, binEnd, centerValue, width;
msach@10 163 int32 maxHeight, i,n;
msach@11 164 float32 total, total2, expectedValue1, expectedValue2;
msach@10 165
msach@10 166 if(hist == NULL || hist->name == NULL)
msach@10 167 return;
msach@10 168
msach@10 169 //Calculate the average
msach@10 170 //do all except the top bin
msach@10 171 maxHeight = 0; total = 0.0; expectedValue1 = 0.0;
msach@10 172 for( i = 0; i < hist->numBins -1; i++ )
msach@10 173 {
msach@10 174 if( maxHeight < hist->bins[ i ] ) maxHeight = hist->bins[ i ];
msach@10 175 total += hist->bins[ i ];
msach@10 176 binStart = hist->startOfRange + hist->binWidth * i;
msach@10 177 expectedValue1 += hist->bins[ i ] * (binStart + hist->binWidth/2.0);
msach@10 178 }
msach@10 179 //copy and calc expected value minus the top bin
msach@10 180 expectedValue2 = expectedValue1;
msach@10 181 expectedValue2 /= total;
msach@10 182 total2 = total;
msach@10 183 //now do last iteration, to add the top bin
msach@10 184 if(maxHeight < hist->bins[ i ])
msach@10 185 maxHeight = hist->bins[ i ];
msach@10 186 total += hist->bins[ i ];
msach@10 187 binStart = hist->startOfRange + hist->binWidth * i;
msach@10 188 expectedValue1 += hist->bins[ i ] * (binStart + hist->binWidth/2.0);
msach@10 189
msach@10 190 expectedValue1 /= total;
msach@10 191
msach@10 192
msach@10 193
msach@10 194
msach@10 195 //If a histogram directory does not exist, do not save to file.
msach@10 196 //TODO change to argument
msach@10 197 char filename[255];
msach@10 198 for(n=0;n<255;n++)
msach@10 199 {
msach@10 200 sprintf(filename, "./histograms/%s.%d.dat", hist->name,n);
msach@10 201 output = fopen(filename,"r");
msach@10 202 if(output)
msach@10 203 {
msach@10 204 fclose(output);
msach@10 205 }else{
msach@10 206 break;
msach@10 207 }
msach@10 208 }
msach@10 209 printf("Saving Hist to File: %s ...\n", filename);
msach@10 210 output = fopen(filename,"w+");
msach@10 211 if(output == NULL){
msach@10 212 printf("[!]No histogram was saved. To save histograms create folder 'histograms'.\n");
msach@10 213 return;
msach@10 214 }
msach@10 215
msach@10 216 /*
msach@10 217 * Write the header of the measurement file.
msach@10 218 */
msach@10 219 //--------------------------
msach@10 220 //Build Environment
msach@10 221 fprintf(output, "# >> Build Environment <<\n");
msach@10 222 fprintf(output, "# Hardware Architecture: ");
msach@10 223 #ifdef __x86_64
msach@10 224 fprintf(output, "x86_64");
msach@11 225 #endif //__x86_64
msach@10 226 #ifdef __i386
msach@10 227 fprintf(output, "x86");
msach@11 228 #endif //__i386
msach@10 229 fprintf(output, "\n");
msach@10 230 fprintf(output, "# GCC VERSION: %d.%d.%d\n",__GNUC__,__GNUC_MINOR__,__GNUC_PATCHLEVEL__);
msach@10 231 fprintf(output, "# Build Date: %s %s\n", __DATE__, __TIME__);
msach@10 232 fprintf(output, "# Number of Cores: %d\n", NUM_CORES);
msach@10 233 //--------------------------
msach@10 234
msach@10 235 //--------------------------
msach@10 236 //VMS Plugins
msach@10 237 fprintf(output, "#\n# >> VMS Plugins <<\n");
msach@10 238 fprintf(output, "# Language : ");
msach@10 239 #ifdef VPTHREAD
msach@10 240 fprintf(output, "VPThread");
msach@10 241 #endif
msach@10 242 #ifdef VCILK
msach@10 243 fprintf(output, "VCilk");
msach@10 244 #endif
msach@10 245 #ifdef SSR
msach@10 246 fprintf(output, "SSR");
msach@10 247 #endif
msach@10 248 fprintf(output, "\n");
msach@10 249 fprintf(output, "# Scheduler: %s\n", __Scheduler);
msach@10 250
msach@10 251 //--------------------------
msach@10 252 //Application
msach@10 253 fprintf(output, "#\n# >> Application <<\n");
msach@10 254 fprintf(output, "# Name: %s\n", __ProgrammName);
msach@10 255 fprintf(output, "# Data Set:\n%s\n",__DataSet);
msach@10 256
msach@10 257 //--------------------------
msach@10 258 //Histogram
msach@10 259 fprintf(output, "#\n# Histogram Name: %s\n", hist->name);
msach@10 260 fprintf(output, "# Expected Values\n");
msach@10 261 fprintf(output, "#\tnum samples: %d | expected value: %3.2f \n",
msach@10 262 (int)total, expectedValue1 );
msach@10 263 fprintf(output, "#\tminus top bin, num samples: %d | expected value: %3.2f \n",
msach@10 264 (int)total2, expectedValue2 );
msach@10 265 fprintf(output, "#\n# [Interval] [Center Value] [Count] [relative Count] [Width]\n");
msach@10 266
msach@10 267 for( binIdx = 0; binIdx < hist->numBins; binIdx++ )
msach@10 268 {
msach@10 269 binStart = hist->startOfRange + hist->binWidth * binIdx;
msach@10 270 binEnd = binStart + hist->binWidth - 1;
msach@10 271 centerValue = (binStart+binEnd)/2;
msach@10 272 width = (binEnd-binStart)+1;
msach@10 273 fprintf(output, "%d-%d\t%d\t%d\t%.4f\t%d\n", binStart, binEnd, centerValue,
msach@10 274 hist->bins[ binIdx ],
msach@10 275 hist->bins[ binIdx ]/total, width);
msach@10 276 }
msach@10 277
msach@10 278 fclose(output);
msach@10 279 fflush(stdout);
msach@10 280 }
msach@10 281
msach@10 282 void
Me@0 283 printHist( Histogram *hist )
Me@0 284 {
Me@7 285 int32 binIdx, i, numBars, maxHeight, barValue, binStart, binEnd;
Me@8 286 float32 total, total2, binPercent, expectedValue1, expectedValue2;
Me@0 287
Me@8 288 if( hist == NULL ) return;
Me@8 289
Me@7 290 //do all except the top bin
Me@7 291 maxHeight = 0; total = 0.0; expectedValue1 = 0.0;
Me@7 292 for( i = 0; i < hist->numBins -1; i++ )
Me@0 293 {
Me@0 294 if( maxHeight < hist->bins[ i ] ) maxHeight = hist->bins[ i ];
Me@7 295 total += hist->bins[ i ];
Me@7 296 binStart = hist->startOfRange + hist->binWidth * i;
Me@7 297 expectedValue1 += hist->bins[ i ] * (binStart + hist->binWidth/2.0);
Me@0 298 }
Me@7 299 //copy and calc expected value minus the top bin
Me@8 300 expectedValue2 = expectedValue1;
Me@7 301 expectedValue2 /= total;
Me@8 302 total2 = total;
Me@7 303 //now do last iteration, to add the top bin
Me@7 304 if( maxHeight < hist->bins[ i ] ) maxHeight = hist->bins[ i ];
Me@7 305 total += hist->bins[ i ];
Me@7 306 binStart = hist->startOfRange + hist->binWidth * i;
Me@7 307 expectedValue1 += hist->bins[ i ] * (binStart + hist->binWidth/2.0);
Me@7 308
Me@7 309 expectedValue1 /= total;
Me@7 310
Me@7 311 printf( "histogram: " );
Me@7 312 if( hist->name != NULL ) printf( "%s\n", hist->name );
Me@7 313 else printf( "\n" );
Me@8 314 printf( " num samples: %d | expected value: %3.2f \n",
Me@8 315 (int)total, expectedValue1 );
Me@8 316 printf( "minus top bin, num samples: %d | expected value: %3.2f \n",
Me@8 317 (int)total2, expectedValue2 );
Me@7 318
msach@10 319 if(maxHeight < 60){
msach@10 320 barValue = 1;
msach@10 321 printf("Single Bar Value: %i\n", barValue);
msach@10 322 }else{
msach@10 323 barValue = maxHeight / 60; //60 spaces across page for tallest bin
msach@10 324 printf("Single Bar Value: %0.3f\n", (float)maxHeight /60);
msach@10 325 }
msach@10 326
Me@8 327 if( barValue == 0 ) { printf("error: bar val zero\n"); return; }
Me@0 328 for( binIdx = 0; binIdx < hist->numBins; binIdx++ )
Me@0 329 {
Me@0 330 binStart = hist->startOfRange + hist->binWidth * binIdx;
Me@0 331 binEnd = binStart + hist->binWidth - 1;
Me@7 332 binPercent = 100 * hist->bins[ binIdx ] / total;
Me@7 333 printf("bin range: %d - %d | %3.2f", binStart, binEnd, binPercent );
Me@0 334
Me@0 335 numBars = hist->bins[ binIdx ] / barValue;
Me@0 336 //print one bin, height of bar is num dashes across page
Me@0 337 for( i = 0; i < numBars; i++ )
Me@0 338 {
Me@0 339 printf("-");
Me@0 340 }
Me@0 341 printf("\n");
Me@0 342 }
Me@0 343 }
Me@0 344
Me@3 345 void
Me@3 346 freeHist( Histogram *hist )
Me@3 347 {
Me@16 348 VMS_int__free( hist->bins );
Me@16 349 VMS_int__free( hist->name );
Me@16 350 VMS_int__free( hist );
Me@15 351 }
Me@15 352 void
Me@15 353 freeHistExt( Histogram *hist )
Me@15 354 {
Me@7 355 free( hist->bins );
Me@7 356 free( hist->name );
Me@7 357 free( hist );
Me@7 358 }