Back to index

python3.2  3.2.2
Public Member Functions | Public Attributes | Static Public Attributes
Lookups.NormalInstanceAttribute Class Reference
Inheritance diagram for Lookups.NormalInstanceAttribute:
Inheritance graph
[legend]
Collaboration diagram for Lookups.NormalInstanceAttribute:
Collaboration graph
[legend]

List of all members.

Public Member Functions

def test
def calibrate
def get_timer
def compatible
def calibrate_test
def run
def stat

Public Attributes

 last_timing
 warp
 times

Static Public Attributes

float version = 2.0
 Instance variables that each test should override.
int operations = 5
int rounds = 100000
int is_a_test = 1
 Internal variables.
tuple last_timing = (0.0, 0.0, 0.0)
int warp = 1
 calibration_runs = CALIBRATION_RUNS
 overhead_times = None
list times = []
 timer = TIMER_PLATFORM_DEFAULT

Detailed Description

Definition at line 558 of file Lookups.py.


Member Function Documentation

Calibrate the test.

    This method should execute everything that is needed to
    setup and run the test - except for the actual operations
    that you intend to measure. pybench uses this method to
    measure the test implementation overhead.

Reimplemented from pybench.Test.

Definition at line 737 of file Lookups.py.

00737 
00738     def calibrate(self):
00739 
00740         class c:
00741             pass
00742         o = c()
00743 
00744         for i in range(self.rounds):
00745             pass

Here is the caller graph for this function:

def pybench.Test.calibrate_test (   self) [inherited]

Definition at line 262 of file pybench.py.

00262 
00263     def calibrate_test(self):
00264 
00265         if self.calibration_runs == 0:
00266             self.overhead_times = [0.0]
00267             return
00268 
00269         calibrate = self.calibrate
00270         timer = self.get_timer()
00271         calibration_loops = range(CALIBRATION_LOOPS)
00272 
00273         # Time the calibration loop overhead
00274         prep_times = []
00275         for i in range(self.calibration_runs):
00276             t = timer()
00277             for i in calibration_loops:
00278                 pass
00279             t = timer() - t
00280             prep_times.append(t / CALIBRATION_LOOPS)
00281         min_prep_time = min(prep_times)
00282         if _debug:
00283             print()
00284             print('Calib. prep time     = %.6fms' % (
00285                 min_prep_time * MILLI_SECONDS))
00286 
00287         # Time the calibration runs (doing CALIBRATION_LOOPS loops of
00288         # .calibrate() method calls each)
00289         for i in range(self.calibration_runs):
00290             t = timer()
00291             for i in calibration_loops:
00292                 calibrate()
00293             t = timer() - t
00294             self.overhead_times.append(t / CALIBRATION_LOOPS
00295                                        - min_prep_time)
00296 
00297         # Check the measured times
00298         min_overhead = min(self.overhead_times)
00299         max_overhead = max(self.overhead_times)
00300         if _debug:
00301             print('Calib. overhead time = %.6fms' % (
00302                 min_overhead * MILLI_SECONDS))
00303         if min_overhead < 0.0:
00304             raise ValueError('calibration setup did not work')
00305         if max_overhead - min_overhead > 0.1:
00306             raise ValueError(
00307                 'overhead calibration timing range too inaccurate: '
00308                 '%r - %r' % (min_overhead, max_overhead))

def pybench.Test.compatible (   self,
  other 
) [inherited]
Return 1/0 depending on whether the test is compatible
    with the other Test instance or not.

Definition at line 250 of file pybench.py.

00250 
00251     def compatible(self, other):
00252 
00253         """ Return 1/0 depending on whether the test is compatible
00254             with the other Test instance or not.
00255 
00256         """
00257         if self.version != other.version:
00258             return 0
00259         if self.rounds != other.rounds:
00260             return 0
00261         return 1

Here is the caller graph for this function:

def pybench.Test.get_timer (   self) [inherited]
Return the timer function to use for the test.

Definition at line 243 of file pybench.py.

00243 
00244     def get_timer(self):
00245 
00246         """ Return the timer function to use for the test.
00247 
00248         """
00249         return get_timer(self.timer)

Here is the caller graph for this function:

def pybench.Test.run (   self) [inherited]
Run the test in two phases: first calibrate, then
    do the actual test. Be careful to keep the calibration
    timing low w/r to the test timing.

Definition at line 309 of file pybench.py.

00309 
00310     def run(self):
00311 
00312         """ Run the test in two phases: first calibrate, then
00313             do the actual test. Be careful to keep the calibration
00314             timing low w/r to the test timing.
00315 
00316         """
00317         test = self.test
00318         timer = self.get_timer()
00319 
00320         # Get calibration
00321         min_overhead = min(self.overhead_times)
00322 
00323         # Test run
00324         t = timer()
00325         test()
00326         t = timer() - t
00327         if t < MIN_TEST_RUNTIME:
00328             raise ValueError('warp factor too high: '
00329                              'test times are < 10ms')
00330         eff_time = t - min_overhead
00331         if eff_time < 0:
00332             raise ValueError('wrong calibration')
00333         self.last_timing = (eff_time, t, min_overhead)
00334         self.times.append(eff_time)

def pybench.Test.stat (   self) [inherited]
Return test run statistics as tuple:

    (minimum run time,
     average run time,
     total run time,
     average time per operation,
     minimum overhead time)

Definition at line 357 of file pybench.py.

00357 
00358     def stat(self):
00359 
00360         """ Return test run statistics as tuple:
00361 
00362             (minimum run time,
00363              average run time,
00364              total run time,
00365              average time per operation,
00366              minimum overhead time)
00367 
00368         """
00369         runs = len(self.times)
00370         if runs == 0:
00371             return 0.0, 0.0, 0.0, 0.0
00372         min_time = min(self.times)
00373         total_time = sum(self.times)
00374         avg_time = total_time / float(runs)
00375         operation_avg = total_time / float(runs
00376                                            * self.rounds
00377                                            * self.operations)
00378         if self.overhead_times:
00379             min_overhead = min(self.overhead_times)
00380         else:
00381             min_overhead = self.last_timing[2]
00382         return min_time, avg_time, total_time, operation_avg, min_overhead

Here is the call graph for this function:

Run the test.

    The test needs to run self.rounds executing
    self.operations number of operations each.

Reimplemented from pybench.Test.

Definition at line 564 of file Lookups.py.

00564 
00565     def test(self):
00566 
00567         class c:
00568             pass
00569         o = c()
00570 
00571         for i in range(self.rounds):
00572 
00573             o.a = 2
00574             o.b = 3
00575             o.c = 4
00576 
00577             o.a = 2
00578             o.b = 3
00579             o.c = 4
00580 
00581             o.a = 2
00582             o.b = 3
00583             o.c = 4
00584 
00585             o.a = 2
00586             o.b = 3
00587             o.c = 4
00588 
00589 
00590             x = o.a
00591             x = o.b
00592             x = o.c
00593 
00594             x = o.a
00595             x = o.b
00596             x = o.c
00597 
00598             x = o.a
00599             x = o.b
00600             x = o.c
00601 
00602             x = o.a
00603             x = o.b
00604             x = o.c
00605 
00606             o.a = 2
00607             o.b = 3
00608             o.c = 4
00609 
00610             o.a = 2
00611             o.b = 3
00612             o.c = 4
00613 
00614             o.a = 2
00615             o.b = 3
00616             o.c = 4
00617 
00618             o.a = 2
00619             o.b = 3
00620             o.c = 4
00621 
00622 
00623             x = o.a
00624             x = o.b
00625             x = o.c
00626 
00627             x = o.a
00628             x = o.b
00629             x = o.c
00630 
00631             x = o.a
00632             x = o.b
00633             x = o.c
00634 
00635             x = o.a
00636             x = o.b
00637             x = o.c
00638 
00639             o.a = 2
00640             o.b = 3
00641             o.c = 4
00642 
00643             o.a = 2
00644             o.b = 3
00645             o.c = 4
00646 
00647             o.a = 2
00648             o.b = 3
00649             o.c = 4
00650 
00651             o.a = 2
00652             o.b = 3
00653             o.c = 4
00654 
00655 
00656             x = o.a
00657             x = o.b
00658             x = o.c
00659 
00660             x = o.a
00661             x = o.b
00662             x = o.c
00663 
00664             x = o.a
00665             x = o.b
00666             x = o.c
00667 
00668             x = o.a
00669             x = o.b
00670             x = o.c
00671 
00672             o.a = 2
00673             o.b = 3
00674             o.c = 4
00675 
00676             o.a = 2
00677             o.b = 3
00678             o.c = 4
00679 
00680             o.a = 2
00681             o.b = 3
00682             o.c = 4
00683 
00684             o.a = 2
00685             o.b = 3
00686             o.c = 4
00687 
00688 
00689             x = o.a
00690             x = o.b
00691             x = o.c
00692 
00693             x = o.a
00694             x = o.b
00695             x = o.c
00696 
00697             x = o.a
00698             x = o.b
00699             x = o.c
00700 
00701             x = o.a
00702             x = o.b
00703             x = o.c
00704 
00705             o.a = 2
00706             o.b = 3
00707             o.c = 4
00708 
00709             o.a = 2
00710             o.b = 3
00711             o.c = 4
00712 
00713             o.a = 2
00714             o.b = 3
00715             o.c = 4
00716 
00717             o.a = 2
00718             o.b = 3
00719             o.c = 4
00720 
00721 
00722             x = o.a
00723             x = o.b
00724             x = o.c
00725 
00726             x = o.a
00727             x = o.b
00728             x = o.c
00729 
00730             x = o.a
00731             x = o.b
00732             x = o.c
00733 
00734             x = o.a
00735             x = o.b
00736             x = o.c

Here is the caller graph for this function:


Member Data Documentation

pybench.Test.calibration_runs = CALIBRATION_RUNS [static, inherited]

Definition at line 206 of file pybench.py.

int pybench.Test.is_a_test = 1 [static, inherited]

Internal variables.

Definition at line 197 of file pybench.py.

tuple pybench.Test.last_timing = (0.0, 0.0, 0.0) [static, inherited]

Definition at line 200 of file pybench.py.

Definition at line 332 of file pybench.py.

Reimplemented from pybench.Test.

Definition at line 561 of file Lookups.py.

pybench.Test.overhead_times = None [static, inherited]

Definition at line 209 of file pybench.py.

Reimplemented from pybench.Test.

Definition at line 562 of file Lookups.py.

pybench.Test.timer = TIMER_PLATFORM_DEFAULT [static, inherited]

Definition at line 215 of file pybench.py.

list pybench.Test.times = [] [static, inherited]

Definition at line 212 of file pybench.py.

pybench.Test.times [inherited]

Definition at line 234 of file pybench.py.

Instance variables that each test should override.

Reimplemented from pybench.Test.

Definition at line 560 of file Lookups.py.

int pybench.Test.warp = 1 [static, inherited]

Definition at line 203 of file pybench.py.

pybench.Test.warp [inherited]

Definition at line 224 of file pybench.py.


The documentation for this class was generated from the following file: