r-kan / semile

Profile what you care, monitor how it goes (support C/C++)

semile :)

~Simpler way to profile and diagnose~ http://r-kan.github.io/semile/

2016/10/07: c interface is supported
2016/09/24: semile is refined with much more simpler use model!

What is semile?

A profiling framework provides the ability to monitor programs, in general of any programming language, by the following two pieces of information:

• consumed time per execution
• 'footprint' debug message per execution

Difference with other profiling tools?

• Profile 'semantically' Each call to the same function plays its individual role within profiling. Normal 'syntactic' profilers are good in other aspects but fail to achieve this.
• Lightweight The profiled program gives little run-time overhead. The viewer is compact that targets to provide only necessary information without fancy visual effect. It gives profile result in widespread PNG and XML format.
• Message-embedded profile Custom information can be left within profile elements. It then also provides the ability to help reveal internal state/decision inside the program.

P.S. The user-provided semantic specifications (via the profile library) is necessary for semantic profile

System Requirement

python3 (viewer)
g++ (c/cpp profile library)

Dependent Library

dot (graphviz)

Use semile

profiler/cpp_library/src => check to see how to use cpp profile library
profiler/cpp_library/example => check to see an example using cpp profile library
profiler/c_interface/src => check to see how to use c profile interface
profiler/c_interface/example => check to see an example using c profile interface
viewer/README => check to see how to use semile viewer

Contact

Please contact Rodney Kan by [email protected] for any question/request/bug without hesitation.

---

Find screenshots, tutorials, and more information at http://r-kan.github.io/semile/!

semile's Issues

Check dot version (too old version can work incorrectly)

For example:
(command line: dot -V)
dot version 2.2 (Fri Mar 16 22:26:42 UTC 2007) => this version is too old
dot - graphviz version 2.38.0 (20140413.2041) => this version is okay