← Back to branch summary

~ubuntu-branches/ubuntu/vivid/atlas/vivid

« back to all changes in this revision

Viewing changes to doc/TestTime.txt

  • Committer: Bazaar Package Importer
  • Author(s): Sylvestre Ledru
  • Date: 2009-09-17 23:31:54 UTC
  • mto: (2.2.1 experimental)
  • mto: This revision was merged to the branch mainline in revision 10.
  • Revision ID: james.westby@ubuntu.com-20090917233154-9esw88ub02twbuab
Tags: upstream-3.8.3
Import upstream version 3.8.3

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/TestTime.txt
12
12
1. THE FORTRAN77 INTERFACE BLAS TESTERS
13
13
 
14
14
   The official BLAS testers for the Fortran77 interface to the legacy BLAS
15
 
   can be ran in ATLAS/interfaces/blas/F77/testing/<arch>.  Typing "make" with
 
15
   can be ran in BLDdir/interfaces/blas/F77/testing/.  Typing "make" with
16
16
   no arguments will compile all of the testers (all levels & precisions).
17
17
   The user may then run the testers by:
18
18
 
39
39
2. THE ANSI/ISO C INTERFACE BLAS TESTERS
40
40
 
41
41
   The official BLAS testers for the ANSI/ISO C interface to the legacy BLAS
42
 
   can be ran in ATLAS/interfaces/blas/C/testing/<arch>.  Typing "make" with
 
42
   can be ran in BLDdir/interfaces/blas/C/testing/.  Typing "make" with
43
43
   no arguments will compile all of the testers (all levels & precisions).
44
44
   The user may then run the testers by:
45
45
 
83
83
   the Level 3 programs, read section 6.1.
84
84
 
85
85
   To properly build the programs with your BLAS library, make sure to
86
 
   set the BLASlib variable in the ATLAS/Make.<arch> makefile correctly:
 
86
   set the BLASlib variable in the BLDdir/Make.inc include file correctly:
87
87
 
88
88
   BLASlib = /path/to/library/libblas.a
89
89
 
115
115
 
116
116
   BLASlib =
117
117
 
118
 
   Then, edit ATLAS/bin/l3blastst.c, and change line 75 from:
 
118
   Then, edit ATLAS/bin/l3blastst.c, and change line 87 from:
119
119
#define USE_F77_BLAS
120
120
   to:
121
121
#define USE_L3_REFERENCE
122
122
 
123
 
   Edit ATLAS/bin/l2blastst.c and change line 44 from:
 
123
   Edit ATLAS/bin/l2blastst.c and change line 56 from:
124
124
#define USE_F77_BLAS
125
125
   to:
126
126
#define USE_L2_REFERENCE
365
365
7. Timing the Level 2 BLAS
366
366
 
367
367
   The level 2 timer/tester is very similar in action to the level 3 timer.
368
 
   to make, in ATLAS/bin/<arch>, type:
 
368
   to make, in BLDdir/bin/, type:
369
369
 
370
370
   make xsl2blastst
371
371
   make xdl2blastst
378
378
 
379
379
8. Timing the Level 1 BLAS
380
380
   The level 1 timer/tester is very similar in action to the level 2 timer.
381
 
   to make, in ATLAS/bin/<arch>, type:
 
381
   to make, in BLDdir/bin/, type:
382
382
 
383
383
   make xsl1blastst
384
384
   make xdl1blastst
405
405
 
406
406
   These timers time ATLAS's LU and Cholesky.  If you wish to time LAPACK or
407
407
   some other library's LU and Cholesky for comparison purposes, set your
408
 
   Make.<arch> macro FLAPACKlib to point to the appropriate library, and then
 
408
   Make.inc macro FLAPACKlib to point to the appropriate library, and then
409
409
 
410
410
   make xslutstF
411
411
   make xdlutstF
431
431
      supply a floating point threshhold the residual must pass.  If set to
432
432
      negative, no testing is done (saving time and space).  If set to zero,
433
433
      all tests will be flagged as failed.
 
434
 
 
435
10. Other timers/testers, including threading.
 
436
   ATLAS provides other timer/testers.  In particular, note that the timers
 
437
   in the bin directory have versions to test the threaded interface.  To
 
438
   build these, one simply adds the "_pt" suffix to the timer/tester name
 
439
   (eg., "make xdlutst_pt" rather than "make xdlutst").  Many of these
 
440
   timers also have a "_dyn" suffix, which allows you to test against
 
441
   the dynamically-linked ATLAS libs, assuming you have build them.
 
442
   In addition to the lu and llt tests mentioned above, we also have
 
443
   an inversion tester ("make xdinvtst"), an U*U' tester ("make xduumtst").
 
444
   and a solver tester ("make xdslvtst").  These work similarly to the
 
445
   LU and LLt testers covered above.  The solve tester allows for testing
 
446
   LU, Cholesky, and for some cases, QR solves.