Profiler

The profiler measures simulation performance and output core and model performance statistics. The profiler is enabled using the profile command line option or the global variable profiler.

= Single-threaded profiles =

The output from the profiler generally looks as follows for a single-threaded model:

Core profiler results ====================== Total objects               101 objects Parallelism                   1 thread Total time                117.0 seconds Core time                29.8 seconds (25.4%) Compiler                1.6 seconds (1.4%) Schedules               0.0 seconds (0.0%) Loadshapes              0.0 seconds (0.0%) Enduses                 2.9 seconds (2.4%) Transforms              0.1 seconds (0.1%) Model time               87.2 seconds/thread (74.6%) Simulation time              31 days Simulation speed            642 object.hours/second Syncs completed          128694 passes Time steps completed     128694 timesteps Convergence efficiency     1.00 passes/timestep Memory lock contention      0.0% Average timestep             21 seconds/timestep Simulation rate           22892 x realtime Model profiler results ====================== Class           Time (s) Time (%) msec/obj house            87.120     99.9%    871.2 collector         0.110      0.1%    110.0 ================ ======== ======== ======== Total            87.230    100.0%    863.7

= Multi-threaded profiles =

When running a multi-threaded model, the profiler output looks as follows:

Core profiler results ====================== Total objects               101 objects Parallelism                   4 threads Total time                109.0 seconds Core time                45.9 seconds (42.1%) Compiler                1.7 seconds (1.5%) Schedules               0.0 seconds (0.0%) Loadshapes              0.0 seconds (0.0%) Enduses                14.0 seconds (12.8%) Transforms              0.3 seconds (0.3%) Model time               63.1 seconds/thread (57.9%) Simulation time              31 days Simulation speed            689 object.hours/second Syncs completed          128694 passes Time steps completed     128694 timesteps Convergence efficiency     1.00 passes/timestep Memory lock contention      0.0% Average timestep             21 seconds/timestep Simulation rate           24572 x realtime Model profiler results ====================== Class           Time (s) Time (%) msec/obj house           252.000     99.8%   2520.0 collector         0.550      0.2%    550.0 ================ ======== ======== ======== Total           252.550    100.0%   2500.5

= See also =


 * profile
 * threadcount
 * Global variables