doc/user/tutorials/tutorial-keep-get.html.textile.liquid

   1 ---
   2 layout: default
   3 navsection: userguide
   4 title: "Downloading data"
   5 ...
   6
   7 This tutorial describes how to list and download Arvados data collections using the command line tools @arv-ls@ and @arv-get@.  It is also possible to download files from a collection from the Workbench page for the collection, covered in "running a pipeline using Workbench":{{site.baseurl}}/user/tutorials/tutorial-pipeline-workbench.html
   8
   9 {% include 'tutorial_expectations' %}
  10
  11 You can view the contents of a collection using @arv-ls@:
  12
  13 <notextile>
  14 <pre><code>~$ <span class="userinput">arv-ls c1bad4b39ca5a924e481008009d94e32+210</span>
  15 var-GS000016015-ASM.tsv.bz2
  16 </code></pre>
  17
  18 <pre><code>~$ <span class="userinput">arv-ls 887cd41e9c613463eab2f0d885c6dd96+83</span>
  19 alice.txt
  20 bob.txt
  21 carol.txt
  22 </code></pre>
  23 </notextile>
  24
  25 Use @-s@ to print file sizes rounded up to the nearest kilobyte:
  26
  27 <notextile>
  28 <pre><code>~$ <span class="userinput">arv-ls -s c1bad4b39ca5a924e481008009d94e32+210</span>
  29 221887 var-GS000016015-ASM.tsv.bz2
  30 </code></pre>
  31 </notextile>
  32
  33 Use @arv-get@ to download the contents of a collection and place it in the directory specified in the second argument (in this example, @.@ for the current directory):
  34
  35 <notextile>
  36 <pre><code>~$ <span class="userinput">arv-get c1bad4b39ca5a924e481008009d94e32+210/ .</span>
  37 ~$ <span class="userinput">ls var-GS000016015-ASM.tsv.bz2</span>
  38 var-GS000016015-ASM.tsv.bz2
  39 </code></pre>
  40 </notextile>
  41
  42 You can also download individual files:
  43
  44 <notextile>
  45 <pre><code>~$ <span class="userinput">arv-get 887cd41e9c613463eab2f0d885c6dd96+83/alice.txt .</span>
  46 </code></pre>
  47 </notextile>