We can use the line_profiler package in Python to perform a line-by-line analysis of runtime of a function call. If you would simply like to measure the runtime of a single line or block of code refer to %timeit.

If you haven't installed the package you will first need to do so:


        
        
            
                
                
                    pip install line_profiler

Next we need to load the line_profiler package into our session:


        
        
            
                
                
                    %load_ext line_profiler

General syntax to get line-by-line runtime of a function call:


        
        
            
                
                
                    %lprun -f function_name function_call(arg1, arg2 ...)

Examples

Here is a function to add '$' to each element of a list:


        
        
            
                
                
                    def add_dollar(nums):
    prices = ['$'+ str(price) for price in nums]
    return prices

To measure the runtime of the function call:


        
        
            
                
                
                    %load_ext line_profiler

def add_dollar(nums):
    prices = ['$'+ str(price) for price in nums]
    return prices

nums = [1, 2, 3, 4]

%lprun -f add_dollar add_dollar(nums)
                
            
            Timer unit: 1e-06 s
Total time: 1.2e-05 s
File: <ipython-input-6-0ebfeb8e89f9>
Function: add_dollar at line 1
Line #      Hits         Time  Per Hit   % Time  Line Contents
==============================================================
     1                                           def add_dollar(nums):
     2         1         11.0     11.0     91.7      prices = ['$'+ str(price) for price in nums]
     3         1          1.0      1.0      8.3      return prices

Interpreting the results:

Header	Explanation
Timer unit	The unit of time used for measurement
Line #	The line number
Hits	Number of times the line of code was executed
Time	Total time the line took to execute.
Per Hit	The time taken for executing the line once. Hits / Time
% Time	Time spent executing that line of code as a percentage of time spent for executing entire function.
Line Contents	The source code for each line

Published by Arthur Yanagisawa

Edited by 0 others

Did you find this page useful?

thumb_up

thumb_down

Comment

Citation

Ask a question or leave a feedback...

thumb_up

thumb_down

chat_bubble_outline

settings

Enjoy our search

Hit / to insta-search docs and recipes!