Profiling - Revision history

Jaspervdg: /* How to Profile using gcov */

2008-08-16T09:19:58Z

How to Profile using gcov

← Older revision		Revision as of 09:19, 16 August 2008
Line 43:		Line 43:
	Basically the process is exactly the same as for profiling, except that you should disable optimizations (remove the -O2 flag) and now you have to add '-fprofile-arcs -ftest-coverage' instead of '-pg'.		Basically the process is exactly the same as for profiling, except that you should disable optimizations (remove the -O2 flag) and now you have to add '-fprofile-arcs -ftest-coverage' instead of '-pg'.

	Note that there is a tool in SVN ([http://inkscape.svn.sourceforge.net/svnroot/inkscape/gsoc-testsuite/~~tester~~/coverage.py coverage.py]) that can help with analyzing the huge amounts of coverage data. For example, the following will create a .ini-like file that contains a section per source file with for each executed line an execution count, as well as a section with a total (executable) line count (be sure to fill in the right directories for 'src' and 'build/obj'):		Note that there is a tool in SVN ([http://inkscape.svn.sourceforge.net/svnroot/inkscape/gsoc-testsuite/analysis/coverage.py coverage.py]) that can help with analyzing the huge amounts of coverage data. For example, the following will create a .ini-like file that contains a section per source file with for each executed line an execution count, as well as a section with a total (executable) line count (be sure to fill in the right directories for 'src' and 'build/obj'):

	: coverage.py -s src -o build/obj > coveragedata.txt		: coverage.py -s src -o build/obj > coveragedata.txt

Jaspervdg: /* How to Profile using gprof (Linux) */

2008-08-15T13:04:41Z

How to Profile using gprof (Linux)

← Older revision		Revision as of 13:04, 15 August 2008
Line 1:		Line 1:
	== How to Profile using gprof ~~(Linux)~~ ==		== How to Profile using gprof ==

	Here is a (slightly edited) description of how to profile from Bryce Harrington:		Here is a (slightly edited) description of how to profile from Bryce Harrington:

Jaspervdg at 13:04, 15 August 2008

2008-08-15T13:04:09Z

← Older revision		Revision as of 13:04, 15 August 2008
Line 1:		Line 1:
	== How to Profile (Linux) ==		== How to Profile using gprof (Linux) ==

	Here is a description of how to profile ~~under Linux~~ from Bryce Harrington:		Here is a (slightly edited) description of how to profile from Bryce Harrington:

	~~Here is how I've done profiling for Inkscape in the past. I have no~~
	~~idea if this will work on Win32 though since profiling requires kernel~~
	~~calls, so you may have to do some adapting.~~

	There are essentially three major steps:		There are essentially three major steps:
Line 16:		Line 12:

	For Step A what you need to do is add the -pg option to the compiler.		For Step A what you need to do is add the -pg option to the compiler.
	~~You~~ can do this via the CXXFLAGS variable at configure time. For example		On Linux you can do this via the CXXFLAGS variable at configure time, on Windows you need to edit build.xml (note that you'll have to add the -pg flag to the compile target AND the link targets). For example, on Linux,
	in Bash:		in Bash (note that this assumes everything is getting recompiled, if not, do make clean/btool clean first):

	$ CXXFLAGS='-pg' ./configure		: $ CXXFLAGS='-pg' ./configure
	$ make		: $ make

	Step B is where some creativity is needed. You'll probably want to do		Step B is where some creativity is needed. You'll probably want to do
Line 33:		Line 29:
	different sorts of reports, such as the flat profile and call graph. For example here's how to get the plain default report:		different sorts of reports, such as the flat profile and call graph. For example here's how to get the plain default report:

	$ gprof inkscape gmon.out > report		: $ gprof inkscape gmon.out > report

	Read the report file for a table of functions sorted by how much time each function worked during this run of Inkscape. See the gprof manpage for all the analysis report options.		Read the report file for a table of functions sorted by how much time each function worked during this run of Inkscape. See the gprof manpage for all the analysis report options.
Line 39:		Line 35:
	Bryce		Bryce

	== How to Profile (~~Windows~~) ==		'''Note:''' It is not necessary to disable optimizations (not doing so might give some odd results now and then, but it also helps to make the timings more realistic).

			== How to Profile using gcov ==

			You can also use gcov to analyze Inkscape. This tool does not generate any time related information, but it does generate very fine-grained coverage information. It can tell you exactly how many times each line was executed and can be quite useful to see which parts of the code are and which ones aren't executed (often). Which can be used to give some idea of the coverage of tests for example.

	~~very incomplete~~, ~~please~~ add ~~all you can~~.		Basically the process is exactly the same as for profiling, except that you should disable optimizations (remove the -O2 flag) and now you have to add '-fprofile-arcs -ftest-coverage' instead of '-pg'.

	~~Basically it works~~ the ~~same~~ as ~~on linux, although now you have~~ to ~~change things~~ in ~~build.xml. Add~~ '~~-pg~~' ~~to compiler~~ and ~~linker flags:~~		Note that there is a tool in SVN ([http://inkscape.svn.sourceforge.net/svnroot/inkscape/gsoc-testsuite/tester/coverage.py coverage.py]) that can help with analyzing the huge amounts of coverage data. For example, the following will create a .ini-like file that contains a section per source file with for each executed line an execution count, as well as a section with a total (executable) line count (be sure to fill in the right directories for 'src' and 'build/obj'):
	~~Compiler~~:
	~~-mms-bitfields -pg~~
	~~Linker~~
	~~-mconsole -pg~~

	~~Then~~ build ~~clean Inkscape~~.		: coverage.py -s src -o build/obj > coveragedata.txt

	~~Running Inkscape~~ will ~~create a gmon~~.~~out file~~.		Using '-w test' you can output coverage values for all unit tested files, '-f coveragedata.txt' will use the data from coveragedata.txt instead of recomputing everything using gcov (when using -f the -s and -o switches are unnecessary) and '-c othercoveragedata.txt' will remove any execution counts from its gathered coverage data for lines that have an execution count in othercoveragedata.txt. This last switch can be used to see which lines in unit tested files are executed while rendering an SVG file but not while executing the unit tests, for example (by executing the unit tests, gathering coverage data, rendering, gathering coverage data again and finally comparing the two coverage data files using the -c switch).
	~~Then one can do:~~
	~~gprof inkscape~~.~~dbg gmon~~.~~out > report~~.~~txt~~

	== Helpful Profiling Links ==		== Helpful Profiling Links ==
	*[http://en.wikipedia.org/wiki/Profiler_(computer_science) Wikipedia: Profiler]		*[http://en.wikipedia.org/wiki/Profiler_(computer_science) Wikipedia: Profiler]
	*[http://www.gnu.org/software/binutils/manual/gprof-2.9.1/html_mono/gprof.html GNU gprof Manual]		*[http://www.gnu.org/software/binutils/manual/gprof-2.9.1/html_mono/gprof.html GNU gprof Manual]
			*[http://gcc.gnu.org/onlinedocs/gcc/Gcov.html Information on using gcov]

	[[Category:Developer Documentation]]		[[Category:Developer Documentation]]

Johanengelen: /* How to Profile (Windows) */

2008-06-16T15:01:44Z

How to Profile (Windows)

← Older revision		Revision as of 15:01, 16 June 2008
Line 50:		Line 50:

	Then build clean Inkscape.		Then build clean Inkscape.

			Running Inkscape will create a gmon.out file.
			Then one can do:
			gprof inkscape.dbg gmon.out > report.txt

	== Helpful Profiling Links ==		== Helpful Profiling Links ==

Johanengelen: /* How to Profile */

2008-06-06T16:52:16Z

How to Profile

← Older revision		Revision as of 16:52, 6 June 2008
Line 1:		Line 1:
	== How to Profile ==		== How to Profile (Linux) ==

	Here is a description of how to profile under Linux from Bryce Harrington:		Here is a description of how to profile under Linux from Bryce Harrington:
Line 38:		Line 38:

	Bryce		Bryce

			== How to Profile (Windows) ==

			very incomplete, please add all you can.

			Basically it works the same as on linux, although now you have to change things in build.xml. Add '-pg' to compiler and linker flags:
			Compiler:
			-mms-bitfields -pg
			Linker
			-mconsole -pg

			Then build clean Inkscape.

	== Helpful Profiling Links ==		== Helpful Profiling Links ==

Colin Marquardt at 09:00, 3 July 2006

2006-07-03T09:00:57Z

New page

== How to Profile ==

Here is a description of how to profile under Linux from Bryce Harrington:

Here is how I've done profiling for Inkscape in the past. I have no
idea if this will work on Win32 though since profiling requires kernel
calls, so you may have to do some adapting.

There are essentially three major steps:

A) Compile the application with profiling support

B) Run the application in a "certain way"

C) Run gprof to generate analysis reports

For Step A what you need to do is add the -pg option to the compiler.
You can do this via the CXXFLAGS variable at configure time. For example
in Bash:

$ CXXFLAGS='-pg' ./configure
$ make

Step B is where some creativity is needed. You'll probably want to do
several profiling runs to get the hang of it. Essentially, you want to
exercise the part of the program you're most interested in measuring.
For instance, if you're measuring the speed of rendering stars, you may
want to create a document full of zillions of stars, and start Inkscape
with that file, then immediately close when it finishes rendering.

As part of Step B, a special output file is generated (called gmon.out by
default). In Step C, you run gprof on inkscape executable and this file to generate
different sorts of reports, such as the flat profile and call graph. For example here's how to get the plain default report:

$ gprof inkscape gmon.out > report

Read the report file for a table of functions sorted by how much time each function worked during this run of Inkscape. See the gprof manpage for all the analysis report options.

Bryce

== Helpful Profiling Links ==
*[http://en.wikipedia.org/wiki/Profiler_(computer_science) Wikipedia: Profiler]
*[http://www.gnu.org/software/binutils/manual/gprof-2.9.1/html_mono/gprof.html GNU gprof Manual]

[[Category:Developer Documentation]]