doc/user/tutorials/tutorial-parallel.textile

   1 ---
   2 layout: default
   3 navsection: userguide
   4 navmenu: Tutorials
   5 title: "Parallel Crunch tasks"
   6 navorder: 15
   7 ...
   8
   9 h1. Parallel Crunch tasks
  10
  11 In the tutorial "writing a crunch script,":tutorial-firstscript.html our script used a "for" loop to compute the md5 hashes for each file in sequence.  This approach, while simple, is not able to take advantage of the compute cluster with multiple nodes and cores to speed up computation by running tasks in parallel.  This tutorial will demonstrate how to create parallel Crunch tasks.
  12
  13 Start by entering the @crunch_scripts@ directory of your git repository:
  14
  15 <notextile>
  16 <pre><code>$ <span class="userinput">cd you/crunch_scripts</span>
  17 </code></pre>
  18 </notextile>
  19
  20 Next, using your favorite text editor, create a new file called @parallel-hash.py@ in the @crunch_scripts@ directory.  Add the following code to compute the md5 hash of each file in a collection:
  21
  22 <pre><code class="userinput">{% include parallel_hash_script.py %}</code></pre>
  23
  24 Make the file executable:
  25
  26 notextile. <pre><code>$ <span class="userinput">chmod +x parallel-hash.py</span></code></pre>
  27
  28 Next, add the file to @git@ staging, commit and push:
  29
  30 <notextile>
  31 <pre><code>$ <span class="userinput">git add parallel-hash.py</span>
  32 $ <span class="userinput">git commit -m"parallel hash"</span>
  33 $ <span class="userinput">git push origin master</span>
  34 </code></pre>
  35 </notextile>
  36
  37 You should now be able to run your new script using Crunch, with "script" referring to our new "parallel-hash.py" script.  We will use a different input from our previous examples.  We will use @887cd41e9c613463eab2f0d885c6dd96+83@ which consists of three files, "alice.txt", "bob.txt" and "carol.txt" (the example collection used previously in "fetching data from Arvados using Keep":tutorial-keep.html).
  38
  39 <notextile>
  40 <pre><code>$ <span class="userinput">cat &gt;the_job &lt;&lt;EOF
  41 {
  42  "script": "parallel-hash.py",
  43  "script_version": "you:master",
  44  "script_parameters":
  45  {
  46   "input": "887cd41e9c613463eab2f0d885c6dd96+83"
  47  }
  48 }
  49 EOF</span>
  50 $ <span class="userinput">arv -h job create --job "$(cat the_job)"</span>
  51 {
  52  ...
  53  "uuid":"qr1hi-xxxxx-xxxxxxxxxxxxxxx"
  54  ...
  55 }
  56 $ <span class="userinput">arv -h job get --uuid qr1hi-xxxxx-xxxxxxxxxxxxxxx</span>
  57 {
  58  ...
  59  "output":"e2ccd204bca37c77c0ba59fc470cd0f7+162",
  60  ...
  61 }
  62 </code></pre>
  63 </notextile>
  64
  65 Because the job ran in parallel, each instance of parallel-hash creates a separate @md5sum.txt@ as output.  Arvados automatically collates theses files into a single collection, which is the output of the job:
  66
  67 <notextile>
  68 <pre><code>$ <span class="userinput">arv keep get e2ccd204bca37c77c0ba59fc470cd0f7+162</span>
  69 md5sum.txt
  70 md5sum.txt
  71 md5sum.txt
  72 $ <span class="userinput">arv keep get e2ccd204bca37c77c0ba59fc470cd0f7+162/md5sum.txt</span>
  73 0f1d6bcf55c34bed7f92a805d2d89bbf alice.txt
  74 504938460ef369cd275e4ef58994cffe bob.txt
  75 8f3b36aff310e06f3c5b9e95678ff77a carol.txt
  76 </code></pre>
  77 </notextile>
  78
  79 h2. The one job per file pattern
  80
  81 This example demonstrates how to schedule a new task per file.  Because this is a common pattern, the Crunch Python API contains a convenience function to "queue a task for each input file":{{site.basedoc}}/sdk/python/crunch-utility-libraries.html#one_task_per_input which reduces the amount of boilerplate code required to handle parallel jobs.