Skip to content

Latest commit

 

History

History
34 lines (25 loc) · 1.77 KB

README.md

File metadata and controls

34 lines (25 loc) · 1.77 KB

performance-tests-cmdstan

Performance testing tools for use with CmdStan

"Install"

git clone --recursive https://github.com/stan-dev/performance-tests-cmdstan.git

Test performance in current working directory

To test the performance of the current cmdstan et al working directory on, for example, @betanalpha's stat_comp_benchmarks model repo, you can run the following:

./runPerformanceTests.py -j8 stat_comp_benchmarks

./runPerformanceTests.py --help for more options.

Cleaning

make clean will recursively remove all non-checked-in files from all submodules. make revert will bring cmdstan and its submodules back to the commit specified by the current commit of the top-level performance-tests-cmdstan repo.

Testing one git commit against another

to test e.g. develop against a branch you've made on cmdstan,

./compare-git-hashes.sh "stat_comp_benchmarks -j8 --runs 10 <other options to runPerformanceTests.py>" <Baseline CmdStan hash/branch/PR-???> <CmdStan hash for comparison run> <Stan hash for comparison run> <Math hash for comparison run>

All of these take pull request numbers, so to test stan-dev/math#1244 against develop (for example) you can run:

./compare-git-hashes.sh example-models/bugs_examples/vol2/schools/ develop develop false d013e55

Here the false could be replaced with develop - just says to use the Stan hash associated with the CmdStan hash, in this case develop.

The script will then check out and pull all of these commits, branches, or PRs from stan-dev. It should print out which commit hashes it ends up on; please check that these are correct as the script is new. For PRs, you will see an unfamiliar hash that GitHub creates to store the result of the merge of the PR into the base branch the PR is against.