4926: improved image quality
[arvados.git] / doc / user / tutorials / tutorial-keep-get.html.textile.liquid
1 ---
2 layout: default
3 navsection: userguide
4 title: "Downloading data"
5 ...
6
7 {% include 'tutorial_expectations' %}
8
9 h2. Downloading using arv commands
10
11 You can download Arvados data collections using the command line tools @arv-ls@ and @arv-get@.
12
13 Use @arv-ls@ to view the contents of a collection:
14
15 <notextile>
16 <pre><code>~$ <span class="userinput">arv-ls c1bad4b39ca5a924e481008009d94e32+210</span>
17 var-GS000016015-ASM.tsv.bz2
18 </code></pre>
19
20 <pre><code>~$ <span class="userinput">arv-ls 887cd41e9c613463eab2f0d885c6dd96+83</span>
21 alice.txt
22 bob.txt
23 carol.txt
24 </code></pre>
25 </notextile>
26
27 Use @-s@ to print file sizes rounded up to the nearest kilobyte:
28
29 <notextile>
30 <pre><code>~$ <span class="userinput">arv-ls -s c1bad4b39ca5a924e481008009d94e32+210</span>
31 221887 var-GS000016015-ASM.tsv.bz2
32 </code></pre>
33 </notextile>
34
35 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):
36
37 <notextile>
38 <pre><code>~$ <span class="userinput">arv-get c1bad4b39ca5a924e481008009d94e32+210/ .</span>
39 ~$ <span class="userinput">ls var-GS000016015-ASM.tsv.bz2</span>
40 var-GS000016015-ASM.tsv.bz2
41 </code></pre>
42 </notextile>
43
44 You can also download individual files:
45
46 <notextile>
47 <pre><code>~$ <span class="userinput">arv-get 887cd41e9c613463eab2f0d885c6dd96+83/alice.txt .</span>
48 </code></pre>
49 </notextile>
50
51 h2. Downloading using Workbench
52
53 You can also download Arvados data collections using the Workbench.
54
55 Visit the Workbench *Dashboard*. Click on *Projects*<span class="caret"></span> dropdown menu in the top navigation menu, select your *Home* project. You will see the *Data collections* tab, which lists the collections in this project.
56
57 You can access the contents of a collection by clicking on the *<i class="fa fa-fw fa-archive"></i> Show* button next to the collection. This will take you to the collection's page. Using this page you can see the collection's contents, download individual files, and set sharing options.
58
59 You can now download the collection by clicking on the <span class="btn btn-sm btn-info"><i class="fa fa-download"></i></span> button.
60
61 h2. Downloading a shared collection using Workbench
62
63 Collections can be shared to allow downloads by anonymous users.
64
65 To share a collection with anonymous users, visit the collections page using Workbench as described in the above section. Once on the collection's page, click on the <span class="btn btn-sm btn-primary" >Create sharing link</span> button.
66
67 This will create a sharing link for the collection as shown below. You can copy the sharing link in this page and share it with other users.
68
69 !{display: block;margin-left: 25px;margin-right: auto;border:1px solid lightgray;}{{ site.baseurl }}/images/shared-collection.png!
70
71 A user with this url can download this collection by simply accessing this url. It will present a downloadable version of the collection as shown below.
72
73 !{display: block;margin-left: 25px;margin-right: auto;border:1px solid lightgray;}{{ site.baseurl }}/images/download-shared-collection.png!
74
75