Difference between revisions of "Scan"

From CSE231 Wiki
Jump to navigation Jump to search
 
(18 intermediate revisions by 2 users not shown)
Line 13: Line 13:
 
[https://en.wikipedia.org/wiki/Prefix_sum Prefix Sum]
 
[https://en.wikipedia.org/wiki/Prefix_sum Prefix Sum]
  
==Hillis-Steele Prefix Sum==
 
 
[https://en.wikipedia.org/wiki/Prefix_sum#Algorithm_1:_Shorter_span,_more_parallel Hillis and Steele Algorithm]
 
[https://en.wikipedia.org/wiki/Prefix_sum#Algorithm_1:_Shorter_span,_more_parallel Hillis and Steele Algorithm]
  
 
[https://dl.acm.org/citation.cfm?coll=GUIDE&dl=GUIDE&id=7903 Data parallel algorithms]  
 
[https://dl.acm.org/citation.cfm?coll=GUIDE&dl=GUIDE&id=7903 Data parallel algorithms]  
  
<youtube>RdfmxfZBHpo</youtube>
+
{{CollapsibleYouTube|Hillis and Steele Scan|<youtube>RdfmxfZBHpo</youtube>}}
  
 
[[File:Hillis-Steele_Prefix_Sum.svg]]
 
[[File:Hillis-Steele_Prefix_Sum.svg]]
  
==(Extra Credit) Work-efficient==
+
=Lecture=
===Exclusive (Blelloch)===
+
[https://docs.google.com/presentation/d/1xUsx7-n6Ocvm2pQSQX3canzxqYsMo-xka5bw7qFugNk/pub slides]
[https://en.wikipedia.org/wiki/Prefix_sum#Algorithm_2:_Work-efficient Blelloch Algorithm]
 
  
[https://www.cs.cmu.edu/~guyb/papers/sc90.pdf Scan Primitives for Vector Computers]
+
<youtube>RmekgaW8X8A</youtube>
 +
 
 +
=Visualization=
 +
{{Viz|ScanViz|scan.viz|main}}
  
[https://www.cs.cmu.edu/~guyb/papers/Ble93.pdf Prefix Sums and Their Applications]
+
[[File:Step_Efficient_Scan_Viz.png]]
  
<youtube>mmYv3Haj6uc</youtube>
+
=Warmup=
 +
[[Sequential_Scan_Assignment|Sequential Sum Scan]]
  
===Inclusive===
+
=Client=
[[File:Prefix sum 16.svg]]
+
{{Client|StepEfficientParallelSumScannerClient|scan.client|main}}
  
=Lecture=
+
{{CollapsibleCode|StepEfficientParallelSumScannerClient|
[https://docs.google.com/presentation/d/1xUsx7-n6Ocvm2pQSQX3canzxqYsMo-xka5bw7qFugNk/pub slides]
+
<syntaxhighlight lang="java">
 +
OutOfPlaceSumScanner sumScanner = new StepEfficientParallelSumScanner();
 +
int[] data = {1, 2, 3, 4, 5, 6, 7, 8};
 +
System.out.println(Arrays.toString(data));
 +
int[] result = sumScanner.sumScan(data);
 +
System.out.println(Arrays.toString(result));
 +
</syntaxhighlight>}}
  
<youtube>RmekgaW8X8A</youtube>
+
{{CollapsibleConsole|StepEfficientParallelSumScannerClient Output|<pre style="border: 0px; background: #000; color:#fff;">[1, 2, 3, 4, 5, 6, 7, 8]
 +
[1, 3, 6, 10, 15, 21, 28, 36]</pre>}}
  
 
=Code To Use=
 
=Code To Use=
 +
==[[PowersOf2Iterable]]==
 +
This [[PowersOf2Iterable|exercise]] should come in handy here. Recall that we implemented a <code>PowersOfTwoLessThan</code> class in this exercise.
 +
 +
<syntaxhighlight lang="java">
 +
for(int v : new PowersOfTwoLessThan(71)) {
 +
    System.out.println(v);
 +
}
 +
</syntaxhighlight>
 +
 +
==PhasableIntArrays==
 
class [https://www.cse.wustl.edu/~cosgroved/courses/cse231/current/apidocs/edu/wustl/cse231s/phasable/PhasableIntArrays.html PhasableIntArrays] extends [https://www.cse.wustl.edu/~cosgroved/courses/cse231/current/apidocs/edu/wustl/cse231s/phasable/AbstractPhasable.html AbstractPhasable]
 
class [https://www.cse.wustl.edu/~cosgroved/courses/cse231/current/apidocs/edu/wustl/cse231s/phasable/PhasableIntArrays.html PhasableIntArrays] extends [https://www.cse.wustl.edu/~cosgroved/courses/cse231/current/apidocs/edu/wustl/cse231s/phasable/AbstractPhasable.html AbstractPhasable]
: [https://www.cse.wustl.edu/~cosgroved/courses/cse231/current/apidocs/edu/wustl/cse231s/phasable/AbstractPhasable.html#getSrcForPhase(int) getSrcForPhase(phaseIndex)]
+
: [https://www.cse.wustl.edu/~cosgroved/courses/cse231/current/apidocs/edu/wustl/cse231s/phasable/AbstractPhasable.html#srcForPhase(int) srcForPhase(phaseIndex)]
: [https://www.cse.wustl.edu/~cosgroved/courses/cse231/current/apidocs/edu/wustl/cse231s/phasable/AbstractPhasable.html#getSrcForPhase(int) getSrcForPhase(phaseIndex)]
+
: [https://www.cse.wustl.edu/~cosgroved/courses/cse231/current/apidocs/edu/wustl/cse231s/phasable/AbstractPhasable.html#dstForPhase(int) drcForPhase(phaseIndex)]
  
[[PowersOf2Iterable]]
+
One of the downsides to parallel scan requires memory.  For our scans we add the additional requirement that we will not mutate the incoming array parameter.  We could create log(n) arrays, one for each level but that would be wasteful.  If we create two array buffers and switch which is the source to read from and which is the destination to write to at each power-of-two level of the scan, we should be good to go. Re-assigning two buffers back and forth as they switch between source and destination roles raises finality issues when attempting to access them inside of lambdas.
  
==PhasableIntArrays==
+
This is what <code>PhasableIntArrays</code> helps us with. By using its <code>dstForPhase(int phaseIndex)</code> and <code>srcForPhase(int phaseIndex)</code>, we can get the source and destination array corresponding to the phase.
One of the downsides to parallel scan requires memory. For our scans we add the additional requirement that we will not mutate the incoming array parameter.  We could create log(n) arrays, one for each level but that would be wasteful.  If we create two array buffers and switch which is the source to read from and which is the destination to write from at each power of two level of the scan, we should be good to go.
 
  
The table below shows which array will be passed back for each offset.
+
The table below shows which of the two buffer arrays, a or b, will be passed back for each phase index as the source or the destination array.
 
{|class="wikitable"
 
{|class="wikitable"
|'''phase''' ||0||1||2||3||4
+
!'''phase''' !! src !! dst !! power of 2
 
|-
 
|-
|'''src'''||data||a||b||a||b
+
|0||data||a||1
 
|-
 
|-
|'''dst'''||a||b||a||b||a
+
|1||a||b||2
 
|-
 
|-
|||||||||||
+
|2||b||a||4
 
|-
 
|-
|'''bonus info: power of 2''' ||1|||2||4||8||16
+
|3||a||b||8
 +
|-
 +
|4||b||a||16
 +
|-
 +
|5||a||b||32
 +
|-
 +
|6||b||a||64
 
|}
 
|}
  
 
'''NOTE:''' think about which array is the correct one to return from your scan method given how you write your code.
 
'''NOTE:''' think about which array is the correct one to return from your scan method given how you write your code.
 
==[[PowersOf2Iterable]]==
 
This [[PowersOf2Iterable|studio]] should come in handy here.
 
 
Example usage:
 
<nowiki>for(int v : new PowersOfTwoLessThan(71)) {
 
    System.out.println(v);
 
}</nowiki>
 
  
 
=Code To Implement=
 
=Code To Implement=
==Sequential Sum Scanner==
 
{{CodeToImplement|SequentialSumScanner|sumScan|scan.exerise}}
 
 
{{Sequential|public int[] sumScan(int[] data)}}
 
 
{{Warning|Do NOT mutate the data parameter.  Return a new array which contains the sum scan of data.}}
 
 
Implement the simple sequential scan algorithm with the dependencies depicted below:
 
 
[[File:Sequential_scan.png|600px]]
 
 
Work: N
 
 
CPL: N
 
 
==Hillis and Steele Parallel Sum Scanner==
 
 
 
{{CodeToImplement|StepEfficientParallelSumScanner|sumScan|scan.exercise}}
 
{{CodeToImplement|StepEfficientParallelSumScanner|sumScan|scan.exercise}}
  
 
{{Parallel|int[] sumScan(int[] data)}}
 
{{Parallel|int[] sumScan(int[] data)}}
 
+
=Challenge Problem=
==(Extra Credit) Work Efficient Scan==
+
[[Work_Efficient_Parallel_Scan_Assignment|Blelloch (Work-efficient) Scan]]
Choose one path.
 
===Inclusive (Blelloch)===
 
{{CodeToImplement|WorkEfficientParallelScan|sumScanExclusiveInPlace|scan.challenge}}
 
 
 
{{Parallel|public static void sumScanExclusiveInPlace(int[] data)}}
 
 
 
===Exclusive===
 
 
 
{{CodeToImplement|WorkEfficientInPlaceInclusiveSumScanner|sumScan|scan.challenge}}
 
 
 
{{Parallel|void sumScan(int[] data)}}
 
 
 
=Visualization=
 
{{Viz|ScanApp|scan.viz|main}}
 
  
 
=Testing Your Solution=
 
=Testing Your Solution=
==Correctness==
 
===Required===
 
 
{{TestSuite|__ScanTestSuite|scan.exercise}}
 
{{TestSuite|__ScanTestSuite|scan.exercise}}
===Optional Work Efficient===
+
 
{{TestSuite|_WorkEfficientScanTestSuite|scan.challenge}}
+
=Pledge, Acknowledgments, Citations=
 +
{{Pledge|exercise-scan}}

Latest revision as of 03:21, 18 August 2023

Motivation

Scan, also known as parallel prefix, is a fundamental and useful operation in parallel programming. We will gain experience in building Hillis & Steele scan with an optional work efficient Blellock scan.

Further, the dependencies in scan:

make it seem to have little hope for parallelism. However, simple yet clever approaches can achieve critical path lengths.

While we will simply implement prefix sum, scan can be used for other associative operations.

Background

Prefix Sum

Hillis and Steele Algorithm

Data parallel algorithms

Video: Hillis and Steele Scan  

Hillis-Steele Prefix Sum.svg

Lecture

slides

Visualization

class: ScanViz.java VIZ
package: scan.viz
source folder: student/src/main/java

Step Efficient Scan Viz.png

Warmup

Sequential Sum Scan

Client

class: StepEfficientParallelSumScannerClient.java CLIENT
package: scan.client
source folder: student/src/main/java
StepEfficientParallelSumScannerClient  
OutOfPlaceSumScanner sumScanner = new StepEfficientParallelSumScanner();
int[] data = {1, 2, 3, 4, 5, 6, 7, 8};
System.out.println(Arrays.toString(data));
int[] result = sumScanner.sumScan(data);
System.out.println(Arrays.toString(result));
StepEfficientParallelSumScannerClient Output  
[1, 2, 3, 4, 5, 6, 7, 8]
[1, 3, 6, 10, 15, 21, 28, 36]

Code To Use

PowersOf2Iterable

This exercise should come in handy here. Recall that we implemented a PowersOfTwoLessThan class in this exercise.

for(int v : new PowersOfTwoLessThan(71)) {
    System.out.println(v);
}

PhasableIntArrays

class PhasableIntArrays extends AbstractPhasable

srcForPhase(phaseIndex)
drcForPhase(phaseIndex)

One of the downsides to parallel scan requires memory. For our scans we add the additional requirement that we will not mutate the incoming array parameter. We could create log(n) arrays, one for each level but that would be wasteful. If we create two array buffers and switch which is the source to read from and which is the destination to write to at each power-of-two level of the scan, we should be good to go. Re-assigning two buffers back and forth as they switch between source and destination roles raises finality issues when attempting to access them inside of lambdas.

This is what PhasableIntArrays helps us with. By using its dstForPhase(int phaseIndex) and srcForPhase(int phaseIndex), we can get the source and destination array corresponding to the phase.

The table below shows which of the two buffer arrays, a or b, will be passed back for each phase index as the source or the destination array.

phase src dst power of 2
0 data a 1
1 a b 2
2 b a 4
3 a b 8
4 b a 16
5 a b 32
6 b a 64

NOTE: think about which array is the correct one to return from your scan method given how you write your code.

Code To Implement

class: StepEfficientParallelSumScanner.java Java.png
methods: sumScan
package: scan.exercise
source folder: student/src/main/java

method: int[] sumScan(int[] data) Parallel.svg (parallel implementation required)

Challenge Problem

Blelloch (Work-efficient) Scan

Testing Your Solution

class: __ScanTestSuite.java Junit.png
package: scan.exercise
source folder: testing/src/test/java

Pledge, Acknowledgments, Citations

file: exercise-scan-pledge-acknowledgments-citations.txt

More info about the Honor Pledge