Running ToME with LuaProfiler

ToME has the LuaProfiler built-in to help profile code performance. The profiling results will be collected in a file called profiler.log in the working directory of the executable. Make sure that this file does NOT exist before starting a new profiling session.

In order to start the profiler, press Ctrl+Alt+Shift+P from within ToME. There is currently no visual feedback that profiling has started. Perform whatever actions that you want profiled, and then press Ctrl+Alt+Shift+P to stop the profiler.

The profiler.log is an ASCII file, but doesn't make a whole lot of sense. The ToME source code includes a LuaProfiler script to help convert that profiler.log file into a CSV table which tabulates and orders the calls. It can be run with the following command:

lua PATH_TO_TOME/src/luaprofiler/analyzer/summary.lua PATH_TO_EXECUTABLE/profiler.log

Redirect the output to a CSV file and open with your favorite spreadsheet program. Good luck!