profile (MATLAB Function Reference)

(translator=PoChien, ChineseSource=PoChien-20020706-13\profile.html, EnglishSource=c:\matlabr12\help\techdoc\ref\profile.html)

MATLAB Function Reference

profile

最佳化及 M檔案程式碼除錯的工具

Syntax

profile on
profile on -detail level
profile on -history
profile off
profile resume
profile clear
profile report
profile report basename
profile plot
s = profile('status')
stats = profile('info')

Description

profiler 的實用性追蹤 M檔案的執行時間可幫助你除錯及對 M檔案的最佳化.在.M檔案中的每一個函數記錄有關執行時間,呼叫的次數,父函數,子函數, 程式碼命中數及程式碼執行時間的資訊.有些人使用 profile 只是要看子函數;而depfun 也有這個目地.

profile on 開啟 profiler, 清除之前的記錄的 profile 數值.

profile on -detail level由level詳細為函數集敘述開啟 profiler, 清除之前記錄的 profile 記數.

level的值
函數Profiler集合的資訊

mmex
M-函數, M-子函數, and MEX-函數; mmex是預設值

builtin
相同的函數 mmex + built-in 函數,例如 eig (****不太了解…****)

operator
相同的函數 builtin + built-in運算子, 例如 +

level的值	函數Profiler集合的資訊
`mmex`	M-函數, M-子函數, and MEX-函數; `mmex`是預設值
`builtin`	相同的函數 `mmex` + built-in 函數,例如 `eig (**不太了解…**)`
`operator`	相同的函數 `builtin` + built-in運算子, 例如 `+`

profile on -history 開啟 profiler, 清除之前記錄的 profile 記數, 並記錄準確的函數呼叫. profiler 可記錄至多 10,000 筆函數及退出事件. 大於10,000 事件, profiler 繼續記錄其他的 profile 記數, 但是不是呼叫的順序.

profile off 停止 profiler.

profile resume 重新開始 profiler 而不清除之前的記錄記數.

profile clear 將 profiler 記數的記錄清除.

profile report 終止 profiler, 以HTML格式產生 profile 報告,且用你系統預設的網路瀏覽器顯示.

profile report basename 終止 profiler, 以 HTML 格式產生 profile 報告, 將報告存在現行目錄下且名為basename, 且用你系統預設的網路瀏覽器顯示報告. 因為報告包含數個檔案, 不要給basename副檔名.

profile plot 終止 profiler 且用圖形視窗顯示一個函數的長條圖形使用大部分的執行時間.

s = profile('status') 顯示一個包含現行 profiler 狀態的結構. 以下表示此結構的值.

Field
Values

ProfilerStatus
'開' 或 '關'

DetailLevel
'mmex', 'builtin', 或 'operator'

HistoryTracking
'開' 或 '關'

Field	Values
`ProfilerStatus`	`'開'` 或 `'關'`
`DetailLevel`	`'mmex'`, `'builtin'`, 或 `'operator'`
`HistoryTracking`	`'開'` 或 `'關'`

stats = profile('info') 終止profiler且顯示包含profiler結果的結構. 使用此函數可以存取由profiler產生的資料. 而此結構的值為

FunctionTable
包含所有被呼叫函數的列表所成的陣列

FunctionHistory
包含函數呼叫的歷史所成的陣列

ClockPrecision
精確地profiler 的時間測量

`FunctionTable`	包含所有被呼叫函數的列表所成的陣列
`FunctionHistory`	包含函數呼叫的歷史所成的陣列
`ClockPrecision`	精確地profiler 的時間測量

Remarks

請試著研究一個有 profile 報告和標繪圖的例子, 以及學習更多有關結果及如何如用 profiling, 見Improving M-File Performance: the Profiler" in Using MATLAB.

Examples

跟著下列步驟去執行 profiler 以及產生一個 profile 報告.

執行 profiler 的程式碼以計算 Lotka-Volterra predator-prey 人口模組.

profile on -detail builtin -history
[t,y] = ode23('lotka',[0 2],[20;20]);
profile report

profile 報告出現在你預設的網路瀏覽器,提供所有 M函數, M子函數, M函數及固定函數的資訊.報告還包含函數呼叫歷史.

產生 profile 標繪圖.

profile 標繪圖會出現在圖形視窗.

因為報告和標繪圖主要作用是要終止 profiler , 重新開始它的運作且不會清除己收集的記數.

當你執行下一個 M檔案時, profiler 將繼續記數.

See Also

depdir, depfun, profreport, tic

Improving M-File Performance - the Profiler in Using MATLAB

prod profreport