Development Environment

Viewing Profiler Results

There are two main ways to view the profiler results:

• Viewing Profile Reports
• Profile Plot

To save results, see Saving Profile Reports.

Viewing Profile Reports

To display profiler results, type

profile report

This suspends the profiler and produces three reports:

• Summary Profile Report
• Function Details Profile Report
• Function Call History Profile Report

The summary report appears in your system's default Web browser. Use the links at the top of the report page to see the other reports.

Summary Profile Report

The summary report presents statistics about the overall execution and provides summary statistics for each function called. Values reported include:

• Number of functions - The numbers of built-in functions, M-functions, and M-subfunctions are reported.
• Clock precision - The precision of the profiler's time measurement. When Time for a function is 0, it is actually a positive value, but smaller than the profiler can detect given the clock precision.
• Time columns - The total time spent in a function, including all child functions called. Because the time for a function includes time spent on child functions, the times do not add up to the Total recorded time and the percentages add up to more than 100%.
• Self time columns - The total time spent in a function, not including time for any child functions called. Adding the Self time values for all functions listed equals the Total recorded time. The Self time percentages for all functions add up to approximately 100%.

Note that the profiler itself uses some time, which is included in the profiler results.

Following is the summary report for the Lotka-Volterra model described in An Example Using the Profiler.

Function Details Profile Report

The function details report provides statistics for the parent and child functions of a function, and reports the line numbers on which the most time was spent. Following is detail report for the lotka function, which is one of the functions called in An Example Using the Profiler.

Function Call History Profile Report

The function call history displays the exact sequence of functions called. To view this report, you must have started the profiler using the -history option.

profile on -history

The profiler records up to 10,000 function entry and exit events. For more than 10,000 events, the profiler continues to record other profile statistics, but not the sequence of calls. Following is the history report generated from An Example Using the Profiler.

An Example Using the Profiler

Profile Plot