cascade.set_logger_level_trace

cascade.set_logger_level_trace() → None

Sets the logger level to “trace”

Cascade under the hood works with the spdlog C++ logging library API to control the screen verbosity of its screen logs. This function sets the level to “trace”.

When this level is activated cascade will also report on screen setuptimes for building and jitting the Taylor integrators as well as, for each simulation step, the timings for the various parts of the cascade algorithm.

A typical output may look like:

[...] Integrators setup time: 0.810280909s
[...] JIT functions setup time: 0.263069601s

[...] ---- STEP BEGIN ---
[...] Number of chunks: 10
[...] Propagation + AABB computation time: 0.012357934s
[...] Morton encoding and sorting time: 0.015623162s
[...] BVH construction time: 0.044566595s
[...] Broad phase collision detection time: 0.354104341s
[...] Average number of AABB collisions per particle per chunk: 0.03350329934013198
[...] Narrow phase collision detection time: 0.002799526s
[...] Total number of collisions detected: 0
[...] Total number of conjunctions detected: 0
[...] Runtime for append_conj_data(): 2.24e-06s
[...] Total propagation time: 0.431442951s
[...] ---- STEP END ---

This information is useful, among other things, to tune simulation parameters such as the collisional timestep and the number of parallel collisional timesteps.