xref: /aosp_15_r20/external/icu/icu4j/perf-tests/converterperf.pl (revision 0e209d3975ff4a8c132096b14b0e9364a753506e) 
1*0e209d39SAndroid Build Coastguard Worker#!/usr/local/bin/perl
2*0e209d39SAndroid Build Coastguard Worker# * © 2016 and later: Unicode, Inc. and others.
3*0e209d39SAndroid Build Coastguard Worker# * License & terms of use: http://www.unicode.org/copyright.html
4*0e209d39SAndroid Build Coastguard Worker# *******************************************************************************
5*0e209d39SAndroid Build Coastguard Worker# * Copyright (C) 2002-2007 International Business Machines Corporation and     *
6*0e209d39SAndroid Build Coastguard Worker# * others. All Rights Reserved.                                                *
7*0e209d39SAndroid Build Coastguard Worker# *******************************************************************************
8*0e209d39SAndroid Build Coastguard Worker
9*0e209d39SAndroid Build Coastguard Workeruse strict;
10*0e209d39SAndroid Build Coastguard Worker
11*0e209d39SAndroid Build Coastguard Worker# Assume we are running within the icu4j/perf-tests root directory
12*0e209d39SAndroid Build Coastguard Workeruse lib 'src/com/ibm/icu/dev/test/perf';
13*0e209d39SAndroid Build Coastguard Workeruse Dataset;
14*0e209d39SAndroid Build Coastguard Worker
15*0e209d39SAndroid Build Coastguard Worker#---------------------------------------------------------------------
16*0e209d39SAndroid Build Coastguard Worker# Test class
17*0e209d39SAndroid Build Coastguard Workermy $TESTCLASS = 'com.ibm.icu.dev.test.perf.ConverterPerformanceTest';
18*0e209d39SAndroid Build Coastguard Worker
19*0e209d39SAndroid Build Coastguard Workermy $CLASSES = './out/bin:../tools/misc/out/bin/:../icu4j.jar:../icu4j-charset.jar';
20*0e209d39SAndroid Build Coastguard Worker
21*0e209d39SAndroid Build Coastguard Worker# Methods to be tested.  Each pair represents a test method and
22*0e209d39SAndroid Build Coastguard Worker# a baseline method which is used for comparison.
23*0e209d39SAndroid Build Coastguard Worker# Some tests do not compile at this time.
24*0e209d39SAndroid Build Coastguard Workermy @METHODS  = (
25*0e209d39SAndroid Build Coastguard Worker##               ['TestByteToCharConverter', 'TestByteToCharConverterICU'],
26*0e209d39SAndroid Build Coastguard Worker##               ['TestCharToByteConverter', 'TestCharToByteConverterICU'],
27*0e209d39SAndroid Build Coastguard Worker                 ['TestCharsetDecoder',      'TestCharsetDecoderICU'],
28*0e209d39SAndroid Build Coastguard Worker                 ['TestCharsetEncoder',      'TestCharsetEncoderICU']
29*0e209d39SAndroid Build Coastguard Worker               );
30*0e209d39SAndroid Build Coastguard Worker
31*0e209d39SAndroid Build Coastguard Worker# Patterns which define the set of characters used for testing.
32*0e209d39SAndroid Build Coastguard Worker
33*0e209d39SAndroid Build Coastguard Workermy $SOURCEDIR ="./data/conversion/";
34*0e209d39SAndroid Build Coastguard Worker
35*0e209d39SAndroid Build Coastguard Worker# Note that some tests are unavailable
36*0e209d39SAndroid Build Coastguard Workermy @OPTIONS = (
37*0e209d39SAndroid Build Coastguard Worker#   src text          src encoding    test encoding
38*0e209d39SAndroid Build Coastguard Worker  [ "arabic.txt",     "UTF-8",        "csisolatinarabic"],
39*0e209d39SAndroid Build Coastguard Worker  [ "french.txt",     "UTF-8",        "csisolatin1"],
40*0e209d39SAndroid Build Coastguard Worker  [ "greek.txt",      "UTF-8",        "csisolatingreek"],
41*0e209d39SAndroid Build Coastguard Worker  [ "hebrew.txt",     "UTF-8",        "csisolatinhebrew"],
42*0e209d39SAndroid Build Coastguard Worker#  [ "hindi.txt" ,     "UTF-8",        "iscii"],
43*0e209d39SAndroid Build Coastguard Worker  [ "japanese.txt",   "UTF-8",        "EUC-JP"],
44*0e209d39SAndroid Build Coastguard Worker  [ "japanese.txt",   "UTF-8",        "csiso2022jp"],
45*0e209d39SAndroid Build Coastguard Worker# [ "japanese.txt",   "UTF-8",        "shift_jis"],
46*0e209d39SAndroid Build Coastguard Worker  [ "korean.txt",     "UTF-8",        "csiso2022kr"],
47*0e209d39SAndroid Build Coastguard Worker#  [ "korean.txt",     "UTF-8",        "EUC-KR"],
48*0e209d39SAndroid Build Coastguard Worker  [ "s-chinese.txt",  "UTF-8",        "EUC_CN"],
49*0e209d39SAndroid Build Coastguard Worker  [ "arabic.txt",     "UTF-8",        "UTF-8"],
50*0e209d39SAndroid Build Coastguard Worker  [ "french.txt",     "UTF-8",        "UTF-8"],
51*0e209d39SAndroid Build Coastguard Worker  [ "greek.txt",      "UTF-8",        "UTF-8"],
52*0e209d39SAndroid Build Coastguard Worker  [ "hebrew.txt",     "UTF-8",        "UTF-8"],
53*0e209d39SAndroid Build Coastguard Worker  [ "hindi.txt" ,     "UTF-8",        "UTF-8"],
54*0e209d39SAndroid Build Coastguard Worker  [ "japanese.txt",   "UTF-8",        "UTF-8"],
55*0e209d39SAndroid Build Coastguard Worker  [ "korean.txt",     "UTF-8",        "UTF-8"],
56*0e209d39SAndroid Build Coastguard Worker  [ "s-chinese.txt",  "UTF-8",        "UTF-8"],
57*0e209d39SAndroid Build Coastguard Worker  [ "french.txt",     "UTF-8",        "UTF-16BE"],
58*0e209d39SAndroid Build Coastguard Worker  [ "french.txt",     "UTF-8",        "UTF-16LE"],
59*0e209d39SAndroid Build Coastguard Worker  [ "english.txt",    "UTF-8",        "US-ASCII"],
60*0e209d39SAndroid Build Coastguard Worker  );
61*0e209d39SAndroid Build Coastguard Worker
62*0e209d39SAndroid Build Coastguard Workermy $CALIBRATE = 2;  # duration in seconds for initial calibration
63*0e209d39SAndroid Build Coastguard Workermy $DURATION  = 10; # duration in seconds for each pass
64*0e209d39SAndroid Build Coastguard Workermy $NUMPASSES = 4;  # number of passes.  If > 1 then the first pass
65*0e209d39SAndroid Build Coastguard Worker                    # is discarded as a JIT warm-up pass.
66*0e209d39SAndroid Build Coastguard Worker
67*0e209d39SAndroid Build Coastguard Workermy $TABLEATTR = 'BORDER="1" CELLPADDING="4" CELLSPACING="0"';
68*0e209d39SAndroid Build Coastguard Worker
69*0e209d39SAndroid Build Coastguard Workermy $PLUS_MINUS = "±";
70*0e209d39SAndroid Build Coastguard Worker
71*0e209d39SAndroid Build Coastguard Workerif ($NUMPASSES < 3) {
72*0e209d39SAndroid Build Coastguard Worker    die "Need at least 3 passes.  One is discarded (JIT warmup) and need two to have 1 degree of freedom (t distribution).";
73*0e209d39SAndroid Build Coastguard Worker}
74*0e209d39SAndroid Build Coastguard Worker
75*0e209d39SAndroid Build Coastguard Workermy $OUT; # see out()
76*0e209d39SAndroid Build Coastguard Worker
77*0e209d39SAndroid Build Coastguard Workermain();
78*0e209d39SAndroid Build Coastguard Worker
79*0e209d39SAndroid Build Coastguard Worker#---------------------------------------------------------------------
80*0e209d39SAndroid Build Coastguard Worker# ...
81*0e209d39SAndroid Build Coastguard Workersub main {
82*0e209d39SAndroid Build Coastguard Worker    my $date = localtime;
83*0e209d39SAndroid Build Coastguard Worker    my $title = "ICU4J Performance Test $date";
84*0e209d39SAndroid Build Coastguard Worker
85*0e209d39SAndroid Build Coastguard Worker    my $html = $date;
86*0e209d39SAndroid Build Coastguard Worker    $html =~ s/://g; # ':' illegal
87*0e209d39SAndroid Build Coastguard Worker    $html =~ s/\s*\d+$//; # delete year
88*0e209d39SAndroid Build Coastguard Worker    $html =~ s/^\w+\s*//; # delete dow
89*0e209d39SAndroid Build Coastguard Worker    $html = "perf $html.html";
90*0e209d39SAndroid Build Coastguard Worker
91*0e209d39SAndroid Build Coastguard Worker    open(HTML,">$html") or die "Can't write to $html: $!";
92*0e209d39SAndroid Build Coastguard Worker
93*0e209d39SAndroid Build Coastguard Worker    print HTML <<EOF;
94*0e209d39SAndroid Build Coastguard Worker<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
95*0e209d39SAndroid Build Coastguard Worker   "http://www.w3.org/TR/html4/strict.dtd">
96*0e209d39SAndroid Build Coastguard Worker<HTML>
97*0e209d39SAndroid Build Coastguard Worker   <HEAD>
98*0e209d39SAndroid Build Coastguard Worker      <TITLE>$title</TITLE>
99*0e209d39SAndroid Build Coastguard Worker   </HEAD>
100*0e209d39SAndroid Build Coastguard Worker   <BODY>
101*0e209d39SAndroid Build Coastguard WorkerEOF
102*0e209d39SAndroid Build Coastguard Worker    print HTML "<H1>$title</H1>\n";
103*0e209d39SAndroid Build Coastguard Worker
104*0e209d39SAndroid Build Coastguard Worker    print HTML "<H2>$TESTCLASS</H2>\n";
105*0e209d39SAndroid Build Coastguard Worker
106*0e209d39SAndroid Build Coastguard Worker    my $raw = "";
107*0e209d39SAndroid Build Coastguard Worker
108*0e209d39SAndroid Build Coastguard Worker    for my $methodPair (@METHODS) {
109*0e209d39SAndroid Build Coastguard Worker
110*0e209d39SAndroid Build Coastguard Worker        my $testMethod = $methodPair->[0];
111*0e209d39SAndroid Build Coastguard Worker        my $baselineMethod = $methodPair->[1];
112*0e209d39SAndroid Build Coastguard Worker
113*0e209d39SAndroid Build Coastguard Worker        print HTML "<P><TABLE $TABLEATTR><TR><TD>\n";
114*0e209d39SAndroid Build Coastguard Worker        print HTML "<P><B>$testMethod vs. $baselineMethod</B></P>\n";
115*0e209d39SAndroid Build Coastguard Worker
116*0e209d39SAndroid Build Coastguard Worker        print HTML "<P><TABLE $TABLEATTR BGCOLOR=\"#CCFFFF\">\n";
117*0e209d39SAndroid Build Coastguard Worker        print HTML "<TR><TD>Options</TD><TD>$testMethod</TD>";
118*0e209d39SAndroid Build Coastguard Worker        print HTML "<TD>$baselineMethod</TD><TD>Ratio</TD></TR>\n";
119*0e209d39SAndroid Build Coastguard Worker
120*0e209d39SAndroid Build Coastguard Worker        $OUT = '';
121*0e209d39SAndroid Build Coastguard Worker
122*0e209d39SAndroid Build Coastguard Worker        for my $pat (@OPTIONS) {
123*0e209d39SAndroid Build Coastguard Worker            print HTML "<TR><TD>@$pat[0], @$pat[2]</TD>\n";
124*0e209d39SAndroid Build Coastguard Worker
125*0e209d39SAndroid Build Coastguard Worker            out("<P><TABLE $TABLEATTR WIDTH=\"100%\">");
126*0e209d39SAndroid Build Coastguard Worker
127*0e209d39SAndroid Build Coastguard Worker            # measure the test method
128*0e209d39SAndroid Build Coastguard Worker            out("<TR><TD>");
129*0e209d39SAndroid Build Coastguard Worker            print "\n$testMethod [@$pat]\n";
130*0e209d39SAndroid Build Coastguard Worker            my $t = measure2($testMethod, $pat, -$DURATION);
131*0e209d39SAndroid Build Coastguard Worker            out("</TD></TR>");
132*0e209d39SAndroid Build Coastguard Worker            print HTML "<TD>", formatSeconds(4, $t->getMean(), $t->getError);
133*0e209d39SAndroid Build Coastguard Worker            print HTML "/event</TD>\n";
134*0e209d39SAndroid Build Coastguard Worker
135*0e209d39SAndroid Build Coastguard Worker            # measure baseline method
136*0e209d39SAndroid Build Coastguard Worker            out("<TR><TD>");
137*0e209d39SAndroid Build Coastguard Worker            print "\n$baselineMethod [@$pat]\n";
138*0e209d39SAndroid Build Coastguard Worker            my $b = measure2($baselineMethod, $pat, -$DURATION);
139*0e209d39SAndroid Build Coastguard Worker            out("</TD></TR>");
140*0e209d39SAndroid Build Coastguard Worker            print HTML "<TD>", formatSeconds(4, $b->getMean(), $t->getError);
141*0e209d39SAndroid Build Coastguard Worker            print HTML "/event</TD>\n";
142*0e209d39SAndroid Build Coastguard Worker
143*0e209d39SAndroid Build Coastguard Worker            out("</TABLE></P>");
144*0e209d39SAndroid Build Coastguard Worker
145*0e209d39SAndroid Build Coastguard Worker            # output ratio
146*0e209d39SAndroid Build Coastguard Worker            my $r = $t->divide($b);
147*0e209d39SAndroid Build Coastguard Worker            my $mean = $r->getMean() - 1;
148*0e209d39SAndroid Build Coastguard Worker            my $color = $mean < 0 ? "RED" : "BLACK";
149*0e209d39SAndroid Build Coastguard Worker            print HTML "<TD><B><FONT COLOR=\"$color\">", formatPercent(3, $mean, $r->getError);
150*0e209d39SAndroid Build Coastguard Worker            print HTML "</FONT></B></TD></TR>\n";
151*0e209d39SAndroid Build Coastguard Worker        }
152*0e209d39SAndroid Build Coastguard Worker
153*0e209d39SAndroid Build Coastguard Worker        print HTML "</TABLE></P>\n";
154*0e209d39SAndroid Build Coastguard Worker
155*0e209d39SAndroid Build Coastguard Worker        print HTML "<P>Raw data:</P>\n";
156*0e209d39SAndroid Build Coastguard Worker        print HTML $OUT;
157*0e209d39SAndroid Build Coastguard Worker        print HTML "</TABLE></P>\n";
158*0e209d39SAndroid Build Coastguard Worker    }
159*0e209d39SAndroid Build Coastguard Worker
160*0e209d39SAndroid Build Coastguard Worker    print HTML <<EOF;
161*0e209d39SAndroid Build Coastguard Worker   </BODY>
162*0e209d39SAndroid Build Coastguard Worker</HTML>
163*0e209d39SAndroid Build Coastguard WorkerEOF
164*0e209d39SAndroid Build Coastguard Worker    close(HTML) or die "Can't close $html: $!";
165*0e209d39SAndroid Build Coastguard Worker}
166*0e209d39SAndroid Build Coastguard Worker
167*0e209d39SAndroid Build Coastguard Worker#---------------------------------------------------------------------
168*0e209d39SAndroid Build Coastguard Worker# Append text to the global variable $OUT
169*0e209d39SAndroid Build Coastguard Workersub out {
170*0e209d39SAndroid Build Coastguard Worker    $OUT .= join('', @_);
171*0e209d39SAndroid Build Coastguard Worker}
172*0e209d39SAndroid Build Coastguard Worker
173*0e209d39SAndroid Build Coastguard Worker#---------------------------------------------------------------------
174*0e209d39SAndroid Build Coastguard Worker# Append text to the global variable $OUT
175*0e209d39SAndroid Build Coastguard Workersub outln {
176*0e209d39SAndroid Build Coastguard Worker    $OUT .= join('', @_) . "\n";
177*0e209d39SAndroid Build Coastguard Worker}
178*0e209d39SAndroid Build Coastguard Worker
179*0e209d39SAndroid Build Coastguard Worker#---------------------------------------------------------------------
180*0e209d39SAndroid Build Coastguard Worker# Measure a given test method with a give test pattern using the
181*0e209d39SAndroid Build Coastguard Worker# global run parameters.
182*0e209d39SAndroid Build Coastguard Worker#
183*0e209d39SAndroid Build Coastguard Worker# @param the method to run
184*0e209d39SAndroid Build Coastguard Worker# @param the pattern defining characters to test
185*0e209d39SAndroid Build Coastguard Worker# @param if >0 then the number of iterations per pass.  If <0 then
186*0e209d39SAndroid Build Coastguard Worker#        (negative of) the number of seconds per pass.
187*0e209d39SAndroid Build Coastguard Worker#
188*0e209d39SAndroid Build Coastguard Worker# @return a Dataset object, scaled by iterations per pass and
189*0e209d39SAndroid Build Coastguard Worker#         events per iteration, to give time per event
190*0e209d39SAndroid Build Coastguard Worker#
191*0e209d39SAndroid Build Coastguard Workersub measure2 {
192*0e209d39SAndroid Build Coastguard Worker    my @data = measure1(@_);
193*0e209d39SAndroid Build Coastguard Worker    my $iterPerPass = shift(@data);
194*0e209d39SAndroid Build Coastguard Worker    my $eventPerIter = shift(@data);
195*0e209d39SAndroid Build Coastguard Worker
196*0e209d39SAndroid Build Coastguard Worker    shift(@data) if (@data > 1); # discard first run
197*0e209d39SAndroid Build Coastguard Worker
198*0e209d39SAndroid Build Coastguard Worker    my $ds = Dataset->new(@data);
199*0e209d39SAndroid Build Coastguard Worker    $ds->setScale(1.0e-3 / ($iterPerPass * $eventPerIter));
200*0e209d39SAndroid Build Coastguard Worker    $ds;
201*0e209d39SAndroid Build Coastguard Worker}
202*0e209d39SAndroid Build Coastguard Worker
203*0e209d39SAndroid Build Coastguard Worker#---------------------------------------------------------------------
204*0e209d39SAndroid Build Coastguard Worker# Measure a given test method with a give test pattern using the
205*0e209d39SAndroid Build Coastguard Worker# global run parameters.
206*0e209d39SAndroid Build Coastguard Worker#
207*0e209d39SAndroid Build Coastguard Worker# @param the method to run
208*0e209d39SAndroid Build Coastguard Worker# @param the pattern defining characters to test
209*0e209d39SAndroid Build Coastguard Worker# @param if >0 then the number of iterations per pass.  If <0 then
210*0e209d39SAndroid Build Coastguard Worker#        (negative of) the number of seconds per pass.
211*0e209d39SAndroid Build Coastguard Worker#
212*0e209d39SAndroid Build Coastguard Worker# @return array of:
213*0e209d39SAndroid Build Coastguard Worker#         [0] iterations per pass
214*0e209d39SAndroid Build Coastguard Worker#         [1] events per iteration
215*0e209d39SAndroid Build Coastguard Worker#         [2..] ms reported for each pass, in order
216*0e209d39SAndroid Build Coastguard Worker#
217*0e209d39SAndroid Build Coastguard Workersub measure1 {
218*0e209d39SAndroid Build Coastguard Worker    my $method = shift;
219*0e209d39SAndroid Build Coastguard Worker    my $pat = shift;
220*0e209d39SAndroid Build Coastguard Worker    my $param3 = shift;  # Either -seconds/pass or iteration count
221*0e209d39SAndroid Build Coastguard Worker
222*0e209d39SAndroid Build Coastguard Worker    my $iterCount = 0;  # Set later based on param3.
223*0e209d39SAndroid Build Coastguard Worker
224*0e209d39SAndroid Build Coastguard Worker    out("<P>Measuring $method for input file @$pat[0] for encoding @$pat[2] , ");
225*0e209d39SAndroid Build Coastguard Worker    if ($param3 > 0) {
226*0e209d39SAndroid Build Coastguard Worker        $iterCount = $param3;
227*0e209d39SAndroid Build Coastguard Worker        out("$iterCount iterations/pass, $NUMPASSES passes</P>\n");
228*0e209d39SAndroid Build Coastguard Worker    } else {
229*0e209d39SAndroid Build Coastguard Worker        my $timePerPass = -$param3;
230*0e209d39SAndroid Build Coastguard Worker        out(-$timePerPass, " seconds/pass, $NUMPASSES passes</P>\n");
231*0e209d39SAndroid Build Coastguard Worker
232*0e209d39SAndroid Build Coastguard Worker        # Value given was -seconds/pass
233*0e209d39SAndroid Build Coastguard Worker
234*0e209d39SAndroid Build Coastguard Worker        # calibrate: estimate ms/iteration
235*0e209d39SAndroid Build Coastguard Worker        print "Calibrating...";
236*0e209d39SAndroid Build Coastguard Worker        my @t = callJava($method, $pat, -$CALIBRATE, 1);
237*0e209d39SAndroid Build Coastguard Worker        print "done.\n";
238*0e209d39SAndroid Build Coastguard Worker
239*0e209d39SAndroid Build Coastguard Worker        my @data = split(/\s+/, $t[0]->[2]);
240*0e209d39SAndroid Build Coastguard Worker        $data[0] *= 1.0e+3;
241*0e209d39SAndroid Build Coastguard Worker
242*0e209d39SAndroid Build Coastguard Worker        my $timePerIter = 1.0e-3 * $data[0] / $data[1];
243*0e209d39SAndroid Build Coastguard Worker
244*0e209d39SAndroid Build Coastguard Worker        # determine iterations/pass from timePerPass and timePerIteration
245*0e209d39SAndroid Build Coastguard Worker        $iterCount = int($timePerPass / $timePerIter + 0.5);
246*0e209d39SAndroid Build Coastguard Worker
247*0e209d39SAndroid Build Coastguard Worker        out("<P>Calibration pass ($CALIBRATE sec): ");
248*0e209d39SAndroid Build Coastguard Worker        out("$data[0] ms, ");
249*0e209d39SAndroid Build Coastguard Worker        out("$data[1] iterations = ");
250*0e209d39SAndroid Build Coastguard Worker        out(formatSeconds(4, $timePerIter), "/iteration<BR>\n");
251*0e209d39SAndroid Build Coastguard Worker    }
252*0e209d39SAndroid Build Coastguard Worker
253*0e209d39SAndroid Build Coastguard Worker    # run passes
254*0e209d39SAndroid Build Coastguard Worker    print "Measuring $iterCount iterations x $NUMPASSES passes...";
255*0e209d39SAndroid Build Coastguard Worker    my @t = callJava($method, $pat, $iterCount, $NUMPASSES);
256*0e209d39SAndroid Build Coastguard Worker    print "done.\n";
257*0e209d39SAndroid Build Coastguard Worker    my @ms = ();
258*0e209d39SAndroid Build Coastguard Worker    my @b; # scratch
259*0e209d39SAndroid Build Coastguard Worker    for my $a (@t) {
260*0e209d39SAndroid Build Coastguard Worker        # $a->[0]: method name, corresponds to $method
261*0e209d39SAndroid Build Coastguard Worker        # $a->[1]: 'begin' data, == $iterCount
262*0e209d39SAndroid Build Coastguard Worker        # $a->[2]: 'end' data, of the form <ms> <loops> <eventsPerIter>
263*0e209d39SAndroid Build Coastguard Worker        # $a->[3...]: gc messages from JVM during pass
264*0e209d39SAndroid Build Coastguard Worker        @b = split(/\s+/, $a->[2]);
265*0e209d39SAndroid Build Coastguard Worker        push(@ms, $b[0] * 1.0e+3);
266*0e209d39SAndroid Build Coastguard Worker    }
267*0e209d39SAndroid Build Coastguard Worker    my $eventsPerIter = $b[2];
268*0e209d39SAndroid Build Coastguard Worker
269*0e209d39SAndroid Build Coastguard Worker    out("Iterations per pass: $iterCount<BR>\n");
270*0e209d39SAndroid Build Coastguard Worker    out("Events per iteration: $eventsPerIter<BR>\n");
271*0e209d39SAndroid Build Coastguard Worker
272*0e209d39SAndroid Build Coastguard Worker    my @ms_str = @ms;
273*0e209d39SAndroid Build Coastguard Worker    $ms_str[0] .= " (discarded)" if (@ms_str > 1);
274*0e209d39SAndroid Build Coastguard Worker    out("Raw times (ms/pass): ", join(", ", @ms_str), "<BR>\n");
275*0e209d39SAndroid Build Coastguard Worker
276*0e209d39SAndroid Build Coastguard Worker    ($iterCount, $eventsPerIter, @ms);
277*0e209d39SAndroid Build Coastguard Worker}
278*0e209d39SAndroid Build Coastguard Worker
279*0e209d39SAndroid Build Coastguard Worker#---------------------------------------------------------------------
280*0e209d39SAndroid Build Coastguard Worker# Invoke java to run $TESTCLASS, passing it the given parameters.
281*0e209d39SAndroid Build Coastguard Worker#
282*0e209d39SAndroid Build Coastguard Worker# @param the method to run
283*0e209d39SAndroid Build Coastguard Worker# @param the number of iterations, or if negative, the duration
284*0e209d39SAndroid Build Coastguard Worker#        in seconds.  If more than on pass is desired, pass in
285*0e209d39SAndroid Build Coastguard Worker#        a string, e.g., "100 100 100".
286*0e209d39SAndroid Build Coastguard Worker# @param the pattern defining characters to test
287*0e209d39SAndroid Build Coastguard Worker#
288*0e209d39SAndroid Build Coastguard Worker# @return an array of results.  Each result is an array REF
289*0e209d39SAndroid Build Coastguard Worker#         describing one pass.  The array REF contains:
290*0e209d39SAndroid Build Coastguard Worker#         ->[0]: The method name as reported
291*0e209d39SAndroid Build Coastguard Worker#         ->[1]: The params on the '= <meth> begin ...' line
292*0e209d39SAndroid Build Coastguard Worker#         ->[2]: The params on the '= <meth> end ...' line
293*0e209d39SAndroid Build Coastguard Worker#         ->[3..]: GC messages from the JVM, if any
294*0e209d39SAndroid Build Coastguard Worker#
295*0e209d39SAndroid Build Coastguard Workersub callJava {
296*0e209d39SAndroid Build Coastguard Worker    my $method = shift;
297*0e209d39SAndroid Build Coastguard Worker    my $pat = shift;
298*0e209d39SAndroid Build Coastguard Worker    my $n = shift;
299*0e209d39SAndroid Build Coastguard Worker    my $passes = shift;
300*0e209d39SAndroid Build Coastguard Worker
301*0e209d39SAndroid Build Coastguard Worker    my $fileName = $SOURCEDIR.@$pat[0] ;
302*0e209d39SAndroid Build Coastguard Worker    my $n = ($n < 0) ? "-t ".(-$n) : "-i ".$n;
303*0e209d39SAndroid Build Coastguard Worker
304*0e209d39SAndroid Build Coastguard Worker    my $cmd = "java -classpath $CLASSES $TESTCLASS $method $n -p $passes -f $fileName -e @$pat[1] -T @$pat[2]";
305*0e209d39SAndroid Build Coastguard Worker    print "[$cmd]\n"; # for debugging
306*0e209d39SAndroid Build Coastguard Worker    open(PIPE, "$cmd|") or die "Can't run \"$cmd\"";
307*0e209d39SAndroid Build Coastguard Worker    my @out;
308*0e209d39SAndroid Build Coastguard Worker    while (<PIPE>) {
309*0e209d39SAndroid Build Coastguard Worker        push(@out, $_);
310*0e209d39SAndroid Build Coastguard Worker    }
311*0e209d39SAndroid Build Coastguard Worker    close(PIPE) or die "Java failed: \"$cmd\"";
312*0e209d39SAndroid Build Coastguard Worker
313*0e209d39SAndroid Build Coastguard Worker    @out = grep(!/^\#/, @out);  # filter out comments
314*0e209d39SAndroid Build Coastguard Worker
315*0e209d39SAndroid Build Coastguard Worker    #print "[", join("\n", @out), "]\n";
316*0e209d39SAndroid Build Coastguard Worker
317*0e209d39SAndroid Build Coastguard Worker    my @results;
318*0e209d39SAndroid Build Coastguard Worker    my $method = '';
319*0e209d39SAndroid Build Coastguard Worker    my $data = [];
320*0e209d39SAndroid Build Coastguard Worker    foreach (@out) {
321*0e209d39SAndroid Build Coastguard Worker        next unless (/\S/);
322*0e209d39SAndroid Build Coastguard Worker
323*0e209d39SAndroid Build Coastguard Worker        if (/^=\s*(\w+)\s*(\w+)\s*(.*)/) {
324*0e209d39SAndroid Build Coastguard Worker            my ($m, $state, $d) = ($1, $2, $3);
325*0e209d39SAndroid Build Coastguard Worker            #print "$_ => [[$m $state $data]]\n";
326*0e209d39SAndroid Build Coastguard Worker            if ($state eq 'begin') {
327*0e209d39SAndroid Build Coastguard Worker                die "$method was begun but not finished" if ($method);
328*0e209d39SAndroid Build Coastguard Worker                $method = $m;
329*0e209d39SAndroid Build Coastguard Worker                push(@$data, $d);
330*0e209d39SAndroid Build Coastguard Worker                push(@$data, ''); # placeholder for end data
331*0e209d39SAndroid Build Coastguard Worker            } elsif ($state eq 'end') {
332*0e209d39SAndroid Build Coastguard Worker                if ($m ne $method) {
333*0e209d39SAndroid Build Coastguard Worker                    die "$method end does not match: $_";
334*0e209d39SAndroid Build Coastguard Worker                }
335*0e209d39SAndroid Build Coastguard Worker                $data->[1] = $d; # insert end data at [1]
336*0e209d39SAndroid Build Coastguard Worker                #print "#$method:", join(";",@$data), "\n";
337*0e209d39SAndroid Build Coastguard Worker                unshift(@$data, $method); # add method to start
338*0e209d39SAndroid Build Coastguard Worker
339*0e209d39SAndroid Build Coastguard Worker                push(@results, $data);
340*0e209d39SAndroid Build Coastguard Worker                $method = '';
341*0e209d39SAndroid Build Coastguard Worker                $data = [];
342*0e209d39SAndroid Build Coastguard Worker            } else {
343*0e209d39SAndroid Build Coastguard Worker                die "Can't parse: $_";
344*0e209d39SAndroid Build Coastguard Worker            }
345*0e209d39SAndroid Build Coastguard Worker        }
346*0e209d39SAndroid Build Coastguard Worker
347*0e209d39SAndroid Build Coastguard Worker        elsif (/^\[/) {
348*0e209d39SAndroid Build Coastguard Worker            if ($method) {
349*0e209d39SAndroid Build Coastguard Worker                push(@$data, $_);
350*0e209d39SAndroid Build Coastguard Worker            } else {
351*0e209d39SAndroid Build Coastguard Worker                # ignore extraneous GC notices
352*0e209d39SAndroid Build Coastguard Worker            }
353*0e209d39SAndroid Build Coastguard Worker        }
354*0e209d39SAndroid Build Coastguard Worker
355*0e209d39SAndroid Build Coastguard Worker        else {
356*0e209d39SAndroid Build Coastguard Worker            die "Can't parse: $_";
357*0e209d39SAndroid Build Coastguard Worker        }
358*0e209d39SAndroid Build Coastguard Worker    }
359*0e209d39SAndroid Build Coastguard Worker
360*0e209d39SAndroid Build Coastguard Worker    die "$method was begun but not finished" if ($method);
361*0e209d39SAndroid Build Coastguard Worker
362*0e209d39SAndroid Build Coastguard Worker    @results;
363*0e209d39SAndroid Build Coastguard Worker}
364*0e209d39SAndroid Build Coastguard Worker
365*0e209d39SAndroid Build Coastguard Worker#|#---------------------------------------------------------------------
366*0e209d39SAndroid Build Coastguard Worker#|# Format a confidence interval, as given by a Dataset.  Output is as
367*0e209d39SAndroid Build Coastguard Worker#|# as follows:
368*0e209d39SAndroid Build Coastguard Worker#|#   241.23 - 241.98 => 241.5 +/- 0.3
369*0e209d39SAndroid Build Coastguard Worker#|#   241.2 - 243.8 => 242 +/- 1
370*0e209d39SAndroid Build Coastguard Worker#|#   211.0 - 241.0 => 226 +/- 15 or? 230 +/- 20
371*0e209d39SAndroid Build Coastguard Worker#|#   220.3 - 234.3 => 227 +/- 7
372*0e209d39SAndroid Build Coastguard Worker#|#   220.3 - 300.3 => 260 +/- 40
373*0e209d39SAndroid Build Coastguard Worker#|#   220.3 - 1000 => 610 +/- 390 or? 600 +/- 400
374*0e209d39SAndroid Build Coastguard Worker#|#   0.022 - 0.024 => 0.023 +/- 0.001
375*0e209d39SAndroid Build Coastguard Worker#|#   0.022 - 0.032 => 0.027 +/- 0.005
376*0e209d39SAndroid Build Coastguard Worker#|#   0.022 - 1.000 => 0.5 +/- 0.5
377*0e209d39SAndroid Build Coastguard Worker#|# In other words, take one significant digit of the error value and
378*0e209d39SAndroid Build Coastguard Worker#|# display the mean to the same precision.
379*0e209d39SAndroid Build Coastguard Worker#|sub formatDataset {
380*0e209d39SAndroid Build Coastguard Worker#|    my $ds = shift;
381*0e209d39SAndroid Build Coastguard Worker#|    my $lower = $ds->getMean() - $ds->getError();
382*0e209d39SAndroid Build Coastguard Worker#|    my $upper = $ds->getMean() + $ds->getError();
383*0e209d39SAndroid Build Coastguard Worker#|    my $scale = 0;
384*0e209d39SAndroid Build Coastguard Worker#|    # Find how many initial digits are the same
385*0e209d39SAndroid Build Coastguard Worker#|    while ($lower < 1 ||
386*0e209d39SAndroid Build Coastguard Worker#|           int($lower) == int($upper)) {
387*0e209d39SAndroid Build Coastguard Worker#|        $lower *= 10;
388*0e209d39SAndroid Build Coastguard Worker#|        $upper *= 10;
389*0e209d39SAndroid Build Coastguard Worker#|        $scale++;
390*0e209d39SAndroid Build Coastguard Worker#|    }
391*0e209d39SAndroid Build Coastguard Worker#|    while ($lower >= 10 &&
392*0e209d39SAndroid Build Coastguard Worker#|           int($lower) == int($upper)) {
393*0e209d39SAndroid Build Coastguard Worker#|        $lower /= 10;
394*0e209d39SAndroid Build Coastguard Worker#|        $upper /= 10;
395*0e209d39SAndroid Build Coastguard Worker#|        $scale--;
396*0e209d39SAndroid Build Coastguard Worker#|    }
397*0e209d39SAndroid Build Coastguard Worker#|}
398*0e209d39SAndroid Build Coastguard Worker
399*0e209d39SAndroid Build Coastguard Worker#---------------------------------------------------------------------
400*0e209d39SAndroid Build Coastguard Worker# Format a number, optionally with a +/- delta, to n significant
401*0e209d39SAndroid Build Coastguard Worker# digits.
402*0e209d39SAndroid Build Coastguard Worker#
403*0e209d39SAndroid Build Coastguard Worker# @param significant digit, a value >= 1
404*0e209d39SAndroid Build Coastguard Worker# @param multiplier
405*0e209d39SAndroid Build Coastguard Worker# @param time in seconds to be formatted
406*0e209d39SAndroid Build Coastguard Worker# @optional delta in seconds
407*0e209d39SAndroid Build Coastguard Worker#
408*0e209d39SAndroid Build Coastguard Worker# @return string of the form "23" or "23 +/- 10".
409*0e209d39SAndroid Build Coastguard Worker#
410*0e209d39SAndroid Build Coastguard Workersub formatNumber {
411*0e209d39SAndroid Build Coastguard Worker    my $sigdig = shift;
412*0e209d39SAndroid Build Coastguard Worker    my $mult = shift;
413*0e209d39SAndroid Build Coastguard Worker    my $a = shift;
414*0e209d39SAndroid Build Coastguard Worker    my $delta = shift; # may be undef
415*0e209d39SAndroid Build Coastguard Worker
416*0e209d39SAndroid Build Coastguard Worker    my $result = formatSigDig($sigdig, $a*$mult);
417*0e209d39SAndroid Build Coastguard Worker    if (defined($delta)) {
418*0e209d39SAndroid Build Coastguard Worker        my $d = formatSigDig($sigdig, $delta*$mult);
419*0e209d39SAndroid Build Coastguard Worker        # restrict PRECISION of delta to that of main number
420*0e209d39SAndroid Build Coastguard Worker        if ($result =~ /\.(\d+)/) {
421*0e209d39SAndroid Build Coastguard Worker            # TODO make this work for values with all significant
422*0e209d39SAndroid Build Coastguard Worker            # digits to the left of the decimal, e.g., 1234000.
423*0e209d39SAndroid Build Coastguard Worker
424*0e209d39SAndroid Build Coastguard Worker            # TODO the other thing wrong with this is that it
425*0e209d39SAndroid Build Coastguard Worker            # isn't rounding the $delta properly.  Have to put
426*0e209d39SAndroid Build Coastguard Worker            # this logic into formatSigDig().
427*0e209d39SAndroid Build Coastguard Worker            my $x = length($1);
428*0e209d39SAndroid Build Coastguard Worker            $d =~ s/\.(\d{$x})\d+/.$1/;
429*0e209d39SAndroid Build Coastguard Worker        }
430*0e209d39SAndroid Build Coastguard Worker        $result .= " $PLUS_MINUS " . $d;
431*0e209d39SAndroid Build Coastguard Worker    }
432*0e209d39SAndroid Build Coastguard Worker    $result;
433*0e209d39SAndroid Build Coastguard Worker}
434*0e209d39SAndroid Build Coastguard Worker
435*0e209d39SAndroid Build Coastguard Worker#---------------------------------------------------------------------
436*0e209d39SAndroid Build Coastguard Worker# Format a time, optionally with a +/- delta, to n significant
437*0e209d39SAndroid Build Coastguard Worker# digits.
438*0e209d39SAndroid Build Coastguard Worker#
439*0e209d39SAndroid Build Coastguard Worker# @param significant digit, a value >= 1
440*0e209d39SAndroid Build Coastguard Worker# @param time in seconds to be formatted
441*0e209d39SAndroid Build Coastguard Worker# @optional delta in seconds
442*0e209d39SAndroid Build Coastguard Worker#
443*0e209d39SAndroid Build Coastguard Worker# @return string of the form "23 ms" or "23 +/- 10 ms".
444*0e209d39SAndroid Build Coastguard Worker#
445*0e209d39SAndroid Build Coastguard Workersub formatSeconds {
446*0e209d39SAndroid Build Coastguard Worker    my $sigdig = shift;
447*0e209d39SAndroid Build Coastguard Worker    my $a = shift;
448*0e209d39SAndroid Build Coastguard Worker    my $delta = shift; # may be undef
449*0e209d39SAndroid Build Coastguard Worker
450*0e209d39SAndroid Build Coastguard Worker    my @MULT = (1   , 1e3,  1e6,  1e9,  1e12);
451*0e209d39SAndroid Build Coastguard Worker    my @SUFF = ('s' , 'ms', 'us', 'ns', 'ps');
452*0e209d39SAndroid Build Coastguard Worker
453*0e209d39SAndroid Build Coastguard Worker    # Determine our scale
454*0e209d39SAndroid Build Coastguard Worker    my $i = 0;
455*0e209d39SAndroid Build Coastguard Worker    ++$i while ($a*$MULT[$i] < 1 && $i < @MULT);
456*0e209d39SAndroid Build Coastguard Worker
457*0e209d39SAndroid Build Coastguard Worker    formatNumber($sigdig, $MULT[$i], $a, $delta) . ' ' . $SUFF[$i];
458*0e209d39SAndroid Build Coastguard Worker}
459*0e209d39SAndroid Build Coastguard Worker
460*0e209d39SAndroid Build Coastguard Worker#---------------------------------------------------------------------
461*0e209d39SAndroid Build Coastguard Worker# Format a percentage, optionally with a +/- delta, to n significant
462*0e209d39SAndroid Build Coastguard Worker# digits.
463*0e209d39SAndroid Build Coastguard Worker#
464*0e209d39SAndroid Build Coastguard Worker# @param significant digit, a value >= 1
465*0e209d39SAndroid Build Coastguard Worker# @param value to be formatted, as a fraction, e.g. 0.5 for 50%
466*0e209d39SAndroid Build Coastguard Worker# @optional delta, as a fraction
467*0e209d39SAndroid Build Coastguard Worker#
468*0e209d39SAndroid Build Coastguard Worker# @return string of the form "23 %" or "23 +/- 10 %".
469*0e209d39SAndroid Build Coastguard Worker#
470*0e209d39SAndroid Build Coastguard Workersub formatPercent {
471*0e209d39SAndroid Build Coastguard Worker    my $sigdig = shift;
472*0e209d39SAndroid Build Coastguard Worker    my $a = shift;
473*0e209d39SAndroid Build Coastguard Worker    my $delta = shift; # may be undef
474*0e209d39SAndroid Build Coastguard Worker
475*0e209d39SAndroid Build Coastguard Worker    formatNumber($sigdig, 100, $a, $delta) . ' %';
476*0e209d39SAndroid Build Coastguard Worker}
477*0e209d39SAndroid Build Coastguard Worker
478*0e209d39SAndroid Build Coastguard Worker#---------------------------------------------------------------------
479*0e209d39SAndroid Build Coastguard Worker# Format a number to n significant digits without using exponential
480*0e209d39SAndroid Build Coastguard Worker# notation.
481*0e209d39SAndroid Build Coastguard Worker#
482*0e209d39SAndroid Build Coastguard Worker# @param significant digit, a value >= 1
483*0e209d39SAndroid Build Coastguard Worker# @param number to be formatted
484*0e209d39SAndroid Build Coastguard Worker#
485*0e209d39SAndroid Build Coastguard Worker# @return string of the form "1234" "12.34" or "0.001234".  If
486*0e209d39SAndroid Build Coastguard Worker#         number was negative, prefixed by '-'.
487*0e209d39SAndroid Build Coastguard Worker#
488*0e209d39SAndroid Build Coastguard Workersub formatSigDig {
489*0e209d39SAndroid Build Coastguard Worker    my $n = shift() - 1;
490*0e209d39SAndroid Build Coastguard Worker    my $a = shift;
491*0e209d39SAndroid Build Coastguard Worker
492*0e209d39SAndroid Build Coastguard Worker    local $_ = sprintf("%.${n}e", $a);
493*0e209d39SAndroid Build Coastguard Worker    my $sign = (s/^-//) ? '-' : '';
494*0e209d39SAndroid Build Coastguard Worker
495*0e209d39SAndroid Build Coastguard Worker    my $a_e;
496*0e209d39SAndroid Build Coastguard Worker    my $result;
497*0e209d39SAndroid Build Coastguard Worker    if (/^(\d)\.(\d+)e([-+]\d+)$/) {
498*0e209d39SAndroid Build Coastguard Worker        my ($d, $dn, $e) = ($1, $2, $3);
499*0e209d39SAndroid Build Coastguard Worker        $a_e = $e;
500*0e209d39SAndroid Build Coastguard Worker        $d .= $dn;
501*0e209d39SAndroid Build Coastguard Worker        $e++;
502*0e209d39SAndroid Build Coastguard Worker        $d .= '0' while ($e > length($d));
503*0e209d39SAndroid Build Coastguard Worker        while ($e < 1) {
504*0e209d39SAndroid Build Coastguard Worker            $e++;
505*0e209d39SAndroid Build Coastguard Worker            $d = '0' . $d;
506*0e209d39SAndroid Build Coastguard Worker        }
507*0e209d39SAndroid Build Coastguard Worker        if ($e == length($d)) {
508*0e209d39SAndroid Build Coastguard Worker            $result = $sign . $d;
509*0e209d39SAndroid Build Coastguard Worker        } else {
510*0e209d39SAndroid Build Coastguard Worker            $result = $sign . substr($d, 0, $e) . '.' . substr($d, $e);
511*0e209d39SAndroid Build Coastguard Worker        }
512*0e209d39SAndroid Build Coastguard Worker    } else {
513*0e209d39SAndroid Build Coastguard Worker        die "Can't parse $_";
514*0e209d39SAndroid Build Coastguard Worker    }
515*0e209d39SAndroid Build Coastguard Worker    $result;
516*0e209d39SAndroid Build Coastguard Worker}
517*0e209d39SAndroid Build Coastguard Worker
518*0e209d39SAndroid Build Coastguard Worker#eof
519