scuffed-code/icu4c/source/test/perf
2010-07-29 19:09:01 +00:00
..
charperf ICU-6697 Updated samples, test/perf subtree project files. Fixed a bug in reader.c while I was in the neighborhood... 2009-01-23 03:48:42 +00:00
collationperf ICU-7311 Replace tab character with spaces in changes from the patch. 2010-02-24 19:46:03 +00:00
collperf ICU-6697 Updated samples, test/perf subtree project files. Fixed a bug in reader.c while I was in the neighborhood... 2009-01-23 03:48:42 +00:00
convperf ICU-6697 Updated samples, test/perf subtree project files. Fixed a bug in reader.c while I was in the neighborhood... 2009-01-23 03:48:42 +00:00
DateFmtPerf ICU-7275 added -x option and several new performance tests 2010-07-29 19:09:01 +00:00
normperf ICU-6697 Updated samples, test/perf subtree project files. Fixed a bug in reader.c while I was in the neighborhood... 2009-01-23 03:48:42 +00:00
perldriver ICU-7275 Added DateFmtPerf performance test case 2010-07-09 16:14:46 +00:00
strsrchperf ICU-6926 Fix svn properties and text file line endings 2009-06-16 05:56:50 +00:00
ubrkperf ICU-7275 Added DateFmtPerf performance test case 2010-07-09 16:14:46 +00:00
ucnvavailperf ICU-6441 add perf test for this ticket, testing ucnv_countAvailable() speed and memory consumption 2009-04-07 18:41:01 +00:00
unisetperf ICU-6697 Updated samples, test/perf subtree project files. Fixed a bug in reader.c while I was in the neighborhood... 2009-01-23 03:48:42 +00:00
usetperf ICU-6697 Updated samples, test/perf subtree project files. Fixed a bug in reader.c while I was in the neighborhood... 2009-01-23 03:48:42 +00:00
ustrperf ICU-6697 Updated samples, test/perf subtree project files. Fixed a bug in reader.c while I was in the neighborhood... 2009-01-23 03:48:42 +00:00
utfperf ICU-6697 Updated samples, test/perf subtree project files. Fixed a bug in reader.c while I was in the neighborhood... 2009-01-23 03:48:42 +00:00
utrie2perf ICU-6697 Updated samples, test/perf subtree project files. Fixed a bug in reader.c while I was in the neighborhood... 2009-01-23 03:48:42 +00:00
Makefile.in ICU-6530 add UTrie2 and improve upvec_ via svn merge -r 24551:24849 icu/branches/markus/utf8 2008-10-22 19:50:07 +00:00
perf.sln ICU-7275 Added DateFmtPerf performance test case 2010-07-09 16:14:46 +00:00
README ICU-5658 Add README for running performance test and add comment in Common.pl. 2008-04-07 17:38:51 +00:00

Copyright (C) 2008, International Business Machines
Corporation and others.  All Rights Reserved.

README for ICU4C Performance Test

Introduction:
The performance tests in ICU4C compares various aspects of ICU against previous versions of ICU,
Posix, and/or Windows.  Some tests only run on Windows and are labeled accordingly.All of the 
performance tests are driven by a perl-based script which calls the underlying C program and 
displays the statistical analysis of the test in an easy to read HTML web page.  Each test will
have its own web page.


Requirements:
The most up to date tests are in ICU 4.0 and later. In addition, most tests depend on data which are 
in a seperate repository.  

Data repository:
http://source.icu-project.org/repos/icu/data/trunk/test/perf
There are 3 folders in here: collation, conversion, and udr.


Running Performance Test:

1) You should create a directory to hold the ICU (current and previous versions) and the data.
   (e.g. C:\ICUPerformanceTest)

2) Checkout the current ICU and 2 previous versions (for proper regression testing) and the data
   into the ICUPerformanceTest directory.

3) Do a general build on all the ICUs either through Visual Studios or with the Makefile.

4) Build the ICU performance tests either through Visual Studios or with the Makefile.
   (The location of the performance test is: icu/source/test/perf)

5) Go to perf/perldriver and edit Common.pl.
   In this file, you will need to set a few variables:
   a) ICU version numbers
   b) Path to the performance test data
   c) Path to the root directory of the different versions of ICU
   d) Whether or not you are running the test on Windows
   * The Path needs to be absolute
   * All other variables should be left as is

6) In the perf directory, there are several other directories for the various tests that can be run.
   (e.g. convperf (Conversion tests)). Go to each directory and execute the perl script for each test
   you want to run. (e.g. CharPerf_r.pl in CharPerf directory)
   * You only need to run the perl script from the latest ICU version.  The corresponding perl script 
     in the previous versions of ICU do not need to be run seperately.
   * All of the test result web pages will be stored in perf/results.


Note: When running on Windows, cygwin is preferred.
Note: If a test needs to be run on Windows, a message will be displayed.
Note: After building the performance tests, it is a good idea to execute each C program to ensure that each
      test can run. (e.g. convperf.exe)
Note: To run the actual performance test, you will need to setup Perl with the following modules:
      a) Statistics/Distribution.pm
      b) Statistics/Descriptive.pm 
Note: Some tests take a while depending on the machine it is running on so a script to run each performance test's
      perl script might be helpful.