treetimer | TreeTimer Library is a custom library

treetimer is a C++ library. treetimer has no bugs, it has no vulnerabilities, it has a Permissive License and it has low support. You can download it from GitHub.

The TreeTimer Library is a custom library intended to capture data about instrumented blocks in the code. It tracks the relationship between codeblocks based on how they are nested in one another akin to a callpath tree. In each block, as well as timing data, it can also store 'local' parameters that are associated with the block in which they are stored, and 'global' parameters that can be associated with an entire run. Postprocessing: The library itself must be initialised with TreeTimerInit() prior to any blocks, and finalized with TreeTimerFinalize() to write out its results. The results are currently written out to an SQLite Database for postprocessing, such as by the example python script provided at scripts/treetimer-postprocessing. The script can be used by running it with the path to a SQlite database file output by the instrumentation library as an argument. A small selection of post-processing methods can be selected by uncommenting the appropriate method. Instrumentation: Timer Blocks are started with a entry method call associated with a "BlockName", beginning a timing/parameter data capture. Timer Blocks are ended with a exit method call associated with a "BlockName", ending the timing of the current block entry and storing either a new trace entry or adding to the aggregate data. Please note that if the exit blockname differs from the name of the current block the library thinks it is in, a warning will be printed since the data will be invalid (i.e. the entry/exits should match in a stacking order if they are nested).