Prev Next

Speed Testing Main Program

Syntax
speed/package/package test seed option_list 
Purpose
A version of this program runs the correctness tests or the speed tests for one AD package identified by package .

package

AD Package
The command line argument package specifies one of the following AD packages: adolc , cppad , fadbad , sacado .

double
The value package can be double in which case the function values (instead of derivatives) are computed using double precision operations. This enables one to compare the speed of computing function values in double to the speed of the derivative computations. (It is often useful to divide the speed of the derivative computation by the speed of the function evaluation in double.)

profile
In the special case where package is profile, the CppAD package is compiled and run with profiling to aid in determining where it is spending most of its time.

test
It the argument test specifies which test to run and has the following possible values: correct , speed , det_minor , det_lu , ode , poly , sparse_hessian , sparse_jacobian .

correct
If test is equal to correct, all of the correctness tests are run.

speed
If test is equal to speed, all of the speed tests are run.

seed
The command line argument seed is a positive integer. The random number simulator uniform_01 is initialized with the call
     uniform_01(seed)
 before any of the testing routines (listed above) are called.

option_list
This is a list of options that follow seed value. The order of the options does not matter and the list can be empty. Each option in the list, must be separate command line argument to the main program.

retape
If the option retape is present, the symbol 
 
	extern bool global_retape
is true and otherwise it is false. If this external symbol is true, every test must retape the AD operation sequence for each test repetition. If it is false, and the particular test has a fixed operation sequence, the AD package is allowed to use one taping of the operation sequence for all the repetitions of that speed test. The following tests have a fixed operation sequence: det_minor, ode, poly.

optimize
If the option code optimize is present, the symbol 
 
	extern bool global_optimize
is true and otherwise it is false. If this external symbol is true, and the AD package has an optional way to spend time optimizing the operation sequence, this optimization should be done before doing computations. If it is false, this optimization should not be done.

Correctness Results
An output line is generated for each correctness test stating of the test passed or failed.

Speed Results
For each speed test, corresponds to three lines of output. The name of the package and test are printed on the first line, the vector of problem sizes are printed on the next line, and the rates corresponding to the different problem sizes are printed on the third line. The rate is the number of times per second that the calculation was repeated.

Link Functions
Each speed test defines it's own version of one of the following functions that link the speed test to the main program described above:
link_det_lu Speed Testing Gradient of Determinant Using Lu Factorization
link_det_minor Speed Testing Gradient of Determinant by Minor Expansion
link_ode Speed Testing the Jacobian of Ode Solution
link_poly Speed Testing Second Derivative of a Polynomial
link_sparse_hessian Speed Testing Sparse Hessian
link_sparse_jacobian Speed Testing Sparse Jacobian
Input File: speed/main.cpp