Personal tools

ThreadScope Tour

From HaskellWiki

(Difference between revisions)
Jump to: navigation, search
(Planned)
(maybe better wording?)
 
(11 intermediate revisions by one user not shown)
Line 1: Line 1:
 
__NOTOC__
 
__NOTOC__
 
 
''A guided tour of ThreadScope''
 
''A guided tour of ThreadScope''
   
[[Image:ThreadScope-ch8.png|200px]]
+
Have parallel Haskell but not enough performance? Try [[ThreadScope]]! It won't fix your program for you, but it may help you to understand what is slowing your program down. We in the ThreadScope team have put together this user guide to help you get started and make the most of this tool.
   
In this tutorial, we'll be working through concrete examples on using ThreadScope to debug the performance of parallel programs.
+
You can also treat this manual as a tutorial. We'll be working through concrete examples on using ThreadScope to debug the performance of parallel programs. We aim to keep each module in this tutorial self-contained, so you can either follow the progression suggested or jump to just the sections we need.
   
We aim to keep each module in the tutorial self-contained, so you can either follow the progression suggested or jump to just the sections we need.
+
<div class="subtitle">Software</div>
   
Note that you will need:
+
This tutorial is written with the following software versions in mind.
   
* ThreadScope 0.2.1 or higher
+
* [[ThreadScope]] 0.2.1
* GHC 7.4 or higher. You could try earlier versions, but more advanced features such as spark events will not available
+
* GHC 7.4. (earlier versions work, but lack more advanced features like spark events)
   
''This tutorial was initially written by Well-Typed in the context of the [[Parallel GHC Project]]. [mailto:eric@well-typed.com Feedback] would be most appreciated!''
+
<div class="subtitle">Getting started</div>
   
== Getting Started ==
+
[[Image:ThreadScope-ch8.png|thumb]]
   
 
# [[ThreadScope_Tour/Install|Installation]]: install ThreadScope and run a sample trace
 
# [[ThreadScope_Tour/Install|Installation]]: install ThreadScope and run a sample trace
 
# [[ThreadScope_Tour/Run|Hello world]]: run ThreadScope on a small test program
 
# [[ThreadScope_Tour/Run|Hello world]]: run ThreadScope on a small test program
   
== Basic skills ==
+
<div class="subtitle">Basic skills</div>
  +
  +
[[Image:ThreadScope-sudoku2.png|thumb]]
   
 
<ol start="3" style="list-style-type: decimal;">
 
<ol start="3" style="list-style-type: decimal;">
 
<li>[[ThreadScope_Tour/Statistics|Initial statistics]]: collect some simple statistics</li>
 
<li>[[ThreadScope_Tour/Statistics|Initial statistics]]: collect some simple statistics</li>
<li>[[ThreadScope_Tour/Profile|Profile]]: examine the profile for a real program</li>
+
<li>[[ThreadScope_Tour/Profile|Profile]]: examine the profile for a real program </li>
 
<li>[[ThreadScope_Tour/Profile2|Profile 2]]: examine the profile for an improved program</li>
 
<li>[[ThreadScope_Tour/Profile2|Profile 2]]: examine the profile for an improved program</li>
<li>[[ThreadScope_Tour/Zoom|Zoom]]: zooming and bookmarking</li>
+
<li>[[ThreadScope_Tour/Zoom|Zoom]]: zoom in to see performance behaviour at a finer resolution</li>
  +
<li>[[ThreadScope_Tour/Bookmark|Bookmark]]: place a temporary marker in the eventlog</li>
 
<li>[[ThreadScope_Tour/Consolidate|Consolidate]]: tease out the sequential parts of code</li></ol>
 
<li>[[ThreadScope_Tour/Consolidate|Consolidate]]: tease out the sequential parts of code</li></ol>
   
== Digging into a program with spark events ==
+
<div class="subtitle">Digging into a program with spark events</div>
   
<ol start="8" style="list-style-type: decimal;">
+
[[Image:spark-lifecycle.png|thumb]]
  +
  +
<ol start="9" style="list-style-type: decimal;">
 
<li>[[ThreadScope_Tour/SparkOverview|Spark overview]]
 
<li>[[ThreadScope_Tour/SparkOverview|Spark overview]]
 
<ul>
 
<ul>
 
<li>[[ThreadScope_Tour/RTS|GHC RTS flags]]: a subset of flags relevant to ThreadScope</li>
 
<li>[[ThreadScope_Tour/RTS|GHC RTS flags]]: a subset of flags relevant to ThreadScope</li>
<li>[[:Image:spark-lifecycle.png|Spark lifecycle]]: Lifecycle of a spark</li></ul>
+
<li>[[Special:FilePath/spark-lifecycle.png|Spark lifecycle]]: Lifecycle of a spark</li></ul>
  +
</li>
  +
<li>[[ThreadScope_Tour/Spark|Spark rates]]: study spark creation/conversion
 
</li>
 
</li>
<li>[[ThreadScope_Tour/Spark|Spark rates]]: study spark creation/conversion</li>
 
 
<li>[[ThreadScope_Tour/Spark2|Spark rates 2]]: spark debugging continued</li>
 
<li>[[ThreadScope_Tour/Spark2|Spark rates 2]]: spark debugging continued</li>
 
</ol>
 
</ol>
   
== Reference ==
+
<div class="subtitle">Reference</div>
   
 
* [[ThreadScope_Tour/Downloads|Downloads]]: examples used in this tutorial
 
* [[ThreadScope_Tour/Downloads|Downloads]]: examples used in this tutorial
  +
  +
''This tutorial was initially written by Well-Typed in the context of the [[Parallel GHC Project]]. [mailto:eric@well-typed.com Feedback] would be most appreciated!''
   
 
[[Category:ThreadScope]]
 
[[Category:ThreadScope]]

Latest revision as of 07:47, 17 May 2012

A guided tour of ThreadScope

Have parallel Haskell but not enough performance? Try ThreadScope! It won't fix your program for you, but it may help you to understand what is slowing your program down. We in the ThreadScope team have put together this user guide to help you get started and make the most of this tool.

You can also treat this manual as a tutorial. We'll be working through concrete examples on using ThreadScope to debug the performance of parallel programs. We aim to keep each module in this tutorial self-contained, so you can either follow the progression suggested or jump to just the sections we need.

Software

This tutorial is written with the following software versions in mind.

  • ThreadScope 0.2.1
  • GHC 7.4. (earlier versions work, but lack more advanced features like spark events)
Getting started
ThreadScope-ch8.png
  1. Installation: install ThreadScope and run a sample trace
  2. Hello world: run ThreadScope on a small test program
Basic skills
ThreadScope-sudoku2.png
  1. Initial statistics: collect some simple statistics
  2. Profile: examine the profile for a real program
  3. Profile 2: examine the profile for an improved program
  4. Zoom: zoom in to see performance behaviour at a finer resolution
  5. Bookmark: place a temporary marker in the eventlog
  6. Consolidate: tease out the sequential parts of code
Digging into a program with spark events
Spark-lifecycle.png
  1. Spark overview
  2. Spark rates: study spark creation/conversion
  3. Spark rates 2: spark debugging continued
Reference

This tutorial was initially written by Well-Typed in the context of the Parallel GHC Project. Feedback would be most appreciated!