index.html 25.9 KB
Newer Older
maneesha's avatar
maneesha committed
1
2
3
4
5
6
7
8
<!-- ****IMPORTANT REMINDER****   -->


<!-- After generating your workshop's page you MUST email the link to admin@software-carpentry.org for us to update our records. Without this we will not be able to provide any other support for your workshop such as surveys or registration, nor will it show up on our main website.
 -->
 
<!-- See instructions in the comments below for how to edit specific sections of this workshop template. -->

9
---
10
layout: workshop
11
root: .
12
13
venue: FIXME      # brief name of host site without address (e.g., "Euphoric State University")
address: FIXME    # street address of workshop (e.g., "123 Forth Street, Blimingen, Euphoria")
14
15
country: FIXME    # country (lowercase two-letter ISO code such as "fr" - see https://en.wikipedia.org/wiki/ISO_3166-1)
language: FIXME   # language (lowercase two-letter ISO code such as "fr" - see https://en.wikipedia.org/wiki/ISO_639-1)
16
17
18
19
20
latlng: FIXME     # fractional latitude and longitude (e.g., "41.7901128,-87.6007318"; you can use http://www.latlong.net/)
humandate: FIXME  # human-readable date (e.g., "Feb 17-18, 2020")
humantime: FIXME  # human-readable time (e.g., "9:00 am - 4:30 pm")
startdate: FIXME  # use YYYY-MM-DD format like "2015-01-01"
enddate: FIXME    # use YYYY-MM-DD format like" 2015-01-02"
21
22
instructor: FIXME # list of names like ["Kay McNulty", "Betty Jennings", "Betty Snyder"]
helper: FIXME     # list of names like ["Marlyn Wescoff", "Fran Bilas", "Ruth Lichterman"]
23
contact: FIXME    # contact email address for workshop organizer, such as "grace@hopper.org"
24
etherpad:         # optional (insert the URL for your Etherpad if you're using one)
25
eventbrite:       # optional (insert the alphanumeric key for Eventbrite registration, e.g., "1234567890AB")
26
---
27
<!--
28
29
  HEADER

30
31
32
33
  Edit the values in the block above to be appropriate for your workshop.
  If the value is not 'true', 'false', 'null', or a number, please use
  double quotation marks around the value, unless specified otherwise.
  And run 'tools/check' *before* committing to make sure that changes are good.
34
35
36
-->

<!--
37
38
  EVENTBRITE

39
40
41
42
43
  This block includes the Eventbrite registration widget if
  'eventbrite' has been set in the header.  You can delete it if you
  are not using Eventbrite, or leave it in, since it will not be
  displayed if the 'eventbrite' field in the header is not set.
-->
44
45
{% if page.eventbrite %}
<iframe
46
  src="https://www.eventbrite.com/tickets-external?eid={{page.eventbrite}}&ref=etckt"
47
  frameborder="0"
48
  width="100%"
49
  height="248px"
50
51
52
53
  scrolling="auto">
</iframe>
{% endif %}

54
<h2 id="general">General Information</h2>
55

56
<!--
57
58
  INTRODUCTION

59
60
61
  Edit the general explanatory paragraph below if you want to change
  the pitch.
-->
62
63
64
65
66
67
68
69
70
71
<p>
  <a href="{{site.swc_site}}">Software Carpentry</a>'s mission
  is to help scientists and engineers get more research done in less
  time and with less pain by teaching them basic lab skills for
  scientific computing.  This hands-on workshop will cover basic
  concepts and tools, including program design, version control, data
  management, and task automation.  Participants will be encouraged to
  help one another and to apply what they have learned to their own
  research problems.
</p>
72
73
74
75
76
77
78
<p align="center">
  <em>
    For more information on what we teach and why,
    please see our paper
    "<a href="http://journals.plos.org/plosbiology/article?id=10.1371/journal.pbio.1001745">Best Practices for Scientific Computing</a>".
  </em>
</p>
79

80
<!--
81
82
  AUDIENCE

83
84
85
  Explain who your audience is.  (In particular, tell readers if the
  workshop is only open to people from a particular institution.
-->
86
<p id="who">
87
88
  <strong>Who:</strong>
  The course is aimed at graduate students and other researchers.
89
90
  <strong>You don't need to have any previous knowledge of the tools that will
    be presented at the workshop.</strong>
91
92
</p>

93
<!--
94
95
  LOCATION

96
97
98
99
100
  This block displays the address and links to maps showing directions
  if the latitude and longitude of the workshop have been set.  You
  can use http://itouchmap.com/latlong.html to find the lat/long of an
  address.
-->
101
{% if page.latlng %}
102
<p id="where">
103
  <strong>Where:</strong>
104
  {{page.address}}.
105
  Get directions with
106
  <a href="//www.openstreetmap.org/?mlat={{page.latlng | replace:',','&mlon='}}&zoom=16">OpenStreetMap</a>
107
  or
108
  <a href="//maps.google.com/maps?q={{page.latlng}}">Google Maps</a>.
109
110
111
</p>
{% endif %}

112
<!--
113
114
  SPECIAL REQUIREMENTS

115
116
  Modify the block below if there are any special requirements.
-->
117
<p id="requirements">
118
  <strong>Requirements:</strong> Participants must bring a laptop with
119
120
121
  a few specific software packages installed (listed
  <a href="#setup">below</a>). They are also required to abide by
  Software Carpentry's
122
123
124
  <a href="{{site.swc_site}}/conduct.html">Code of Conduct</a>.
</p>

125
<!--
126
127
  CONTACT EMAIL ADDRESS

128
129
130
131
  Display the contact email address set in the header.  If an address
  isn't set in the header, the Software Carpentry admin address is
  used.
-->
132
<p id="contact">
133
134
135
136
137
138
139
140
141
142
143
144
  <strong>Contact</strong>:
  Please mail
  {% if page.contact %}
    <a href='mailto:{{page.contact}}'>{{page.contact}}</a>
  {% else %}
    <a href='mailto:{{site.contact}}'>{{site.contact}}</a>
  {% endif %}
  for more information.
</p>

<hr/>

145
<!--
146
147
  SCHEDULE

148
149
150
151
  Show the workshop's schedule.  Edit the items and times in the table
  to match your plans.  You may also want to change 'Day 1' and 'Day
  2' to be actual dates or days of the week.
-->
152
<h2 id="schedule">Schedule</h2>
153

154
155
<div class="row">
  <div class="col-md-6">
156
157
    <h3>Day 1</h3>
    <table class="table table-striped">
Jason Williams's avatar
Jason Williams committed
158
      <tr> <td>Arrival</td>  <td><a href='{{ site.swc_pre_survey }}{{ site.github.project_title }}'>Pre-workshop Survey</a></td> </tr>
159
      <tr> <td>09:00</td>  <td>Automating tasks with the Unix shell</td> </tr>
160
      <tr> <td>10:30</td> <td>Coffee</td> </tr>
161
162
163
164
      <tr> <td>12:00</td>  <td>Lunch break</td> </tr>
      <tr> <td>13:00</td>  <td>Building programs with Python</td> </tr>
      <tr> <td>14:30</td>  <td>Coffee</td> </tr>
      <tr> <td>16:00</td>  <td>Wrap-up</td> </tr>
165
166
    </table>
  </div>
167
  <div class="col-md-6">
168
169
    <h3>Day 2</h3>
    <table class="table table-striped">
170
171
172
173
174
175
      <tr> <td>09:00</td>  <td>Version control with Git</td> </tr>
      <tr> <td>10:30</td>  <td>Coffee</td> </tr>
      <tr> <td>12:00</td>  <td>Lunch break</td> </tr>
      <tr> <td>13:00</td>  <td>Managing data with SQL</td> </tr>
      <tr> <td>14:30</td>  <td>Coffee</td> </tr>
      <tr> <td>16:00</td>  <td>Wrap-up</td> </tr>
Jason Williams's avatar
Jason Williams committed
176
      <tr> <td>Dismissal</td>  <td><a href='{{ site.swc_post_survey }}{{ site.github.project_title }}'>Post-workshop Survey</a></td> </tr>
177
178
179
180
    </table>
  </div>
</div>

181
<!--
182
183
  ETHERPAD

Raniere Silva's avatar
Raniere Silva committed
184
185
  At `_misc/etherpad.txt` you will find a template for the etherpad.

186
187
188
  Display the Etherpad for the workshop.  You can set this up in
  advance or on the first day; either way, make sure you push changes
  to GitHub after you have its URL.  To create an Etherpad, go to
189

190
      http://pad.software-carpentry.org/YYYY-MM-DD-site
191

192
193
  where 'YYYY-MM-DD-site' is the identifier for your workshop,
  e.g., '2015-06-10-esu'.
194
195
-->
{% if page.etherpad %}
196
<p id="etherpad">
197
198
199
200
201
202
  <strong>Etherpad:</strong> <a href="{{page.etherpad}}">{{page.etherpad}}</a>.
  <br/>
  We will use this Etherpad for chatting, taking notes, and sharing URLs and bits of code.
</p>
{% endif %}

203
204
<hr/>

205
<!--
206
207
  SYLLABUS

208
209
210
211
212
213
214
  Show what topics will be covered.

  1. If your workshop is R rather than Python, remove the comment
     around that section and put a comment around the Python section.
  2. Some workshops will delete SQL.
  3. Please make sure the list of topics is synchronized with what you
     intend to teach.
215
216
  4. You may need to move the div's with class="col-md-6" around inside
     the div's with class="row" to balance the multi-column layout.
217
218
219
220
221

  This is one of the places where people frequently make mistakes, so
  please preview your site before committing, and make sure to run
  'tools/check' as well.
-->
222
<h2 id="syllabus">Syllabus</h2>
223

224
225
<div class="row">
  <div class="col-md-6">
226
    <h3 id="syllabus-shell">The Unix Shell</h3>
227
    <ul>
228
      <li>Files and directories</li>
229
230
231
232
      <li>History and tab completion</li>
      <li>Pipes and redirection</li>
      <li>Looping over files</li>
      <li>Creating and running shell scripts</li>
233
      <li>Finding things</li>
Raniere Silva's avatar
Raniere Silva committed
234
      <li><a href="{{site.swc_githubio}}/shell-novice/reference.html">Reference...</a></li>
235
236
    </ul>
  </div>
237
  <div class="col-md-6">
238
    <h3 id="syllabus-python">Programming in Python</h3>
239
240
241
242
243
    <ul>
      <li>Using libraries</li>
      <li>Working with arrays</li>
      <li>Reading and plotting data</li>
      <li>Creating and using functions</li>
244
      <li>Loops and conditionals</li>
245
246
      <li>Defensive programming</li>
      <li>Using Python from the command line</li>
Raniere Silva's avatar
Raniere Silva committed
247
      <li><a href="{{site.swc_githubio}}/python-novice-inflammation/reference.html">Reference...</a></li>
248
249
    </ul>
  </div>
250
251
  <!--
  <div class="col-md-6">
252
    <h3 id="syllabus-r">Programming in R</h3>
253
254
255
256
    <ul>
      <li>Working with vectors and data frames</li>
      <li>Reading and plotting data</li>
      <li>Creating and using functions</li>
257
      <li>Loops and conditionals</li>
258
      <li>Using R from the command line</li>
Raniere Silva's avatar
Raniere Silva committed
259
      <li><a href="{{site.swc_githubio}}/r-novice-inflammation/reference.html">Reference...</a></li>
260
261
    </ul>
  </div>
262
  -->
263
264
  <!--
  <div class="col-md-6">
265
    <h3 id="syllabus-matlab">Programming in MATLAB</h3>
266
267
268
269
270
271
272
273
274
275
    <ul>
      <li>Working with arrays</li>
      <li>Reading and plotting data</li>
      <li>Creating and using functions</li>
      <li>Loops and conditionals</li>
      <li>Defensive programming</li>
      <li><a href="{{site.swc_githubio}}/matlab-novice-inflammation/reference.html">Reference...</a></li>
     </ul>
   </div>
   -->
276
277
</div>

278
279
<div class="row">
  <div class="col-md-6">
280
    <h3 id="syllabus-git">Version Control with Git</h3>
281
282
283
284
285
286
287
288
289
    <ul>
      <li>Creating a repository</li>
      <li>Recording changes to files: <code>add</code>, <code>commit</code>, ...</li>
      <li>Viewing changes: <code>status</code>, <code>diff</code>, ...</li>
      <li>Ignoring files</li>
      <li>Working on the web: <code>clone</code>, <code>pull</code>, <code>push</code>, ...</li>
      <li>Resolving conflicts</li>
      <li>Open licenses</li>
      <li>Where to host work, and why</li>
Raniere Silva's avatar
Raniere Silva committed
290
      <li><a href="{{site.swc_githubio}}/git-novice/reference.html">Reference...</a></li>
291
292
    </ul>
  </div>
293
  <div class="col-md-6">
294
    <h3 id="syllabus-sql">Managing Data with SQL</h3>
295
296
297
298
299
300
301
302
303
    <ul>
      <li>Reading and sorting data</li>
      <li>Filtering with <code>where</code></li>
      <li>Calculating new values on the fly</li>
      <li>Handling missing values</li>
      <li>Combining values using aggregation</li>
      <li>Combining information from multiple tables using <code>join</code></li>
      <li>Creating, modifying, and deleting data</li>
      <li>Programming with databases</li>
Raniere Silva's avatar
Raniere Silva committed
304
      <li><a href="{{site.swc_githubio}}/sql-novice-survey/reference.html">Reference...</a></li>
305
306
307
308
309
310
    </ul>
  </div>
</div>

<hr/>

311
<!--
312
313
  SETUP

314
315
316
  Delete irrelevant sections from the setup instructions.  Each
  section is inside a 'div' without any classes to make the beginning
  and end easier to find.
317

318
319
320
321
  This is the other place where people frequently make mistakes, so
  please preview your site before committing, and make sure to run
  'tools/check' as well.
-->
322

323
<h2 id="setup">Setup</h2>
324

325
<p>
326
327
  To participate in a Software Carpentry workshop, you will need
  access to the software described below. In addition, you will
328
  need an up-to-date web browser.
329
330
</p>
<p>
David LeBauer's avatar
David LeBauer committed
331
332
  We maintain a list of common issues that occur during installation as a reference for instructors
  that may be useful on the
333
  <a href = "https://github.com/swcarpentry/workshop-template/wiki/Configuration-Problems-and-Solutions">Configuration Problems and Solutions wiki page</a>.
334
335
</p>

336
<div id="shell"> <!-- Start of 'shell' section. -->
337
  <h3>The Bash Shell</h3>
338

339
340
341
342
  <p>
    Bash is a commonly-used shell that gives you the power to do simple
    tasks more quickly.
  </p>
343

344
345
  <div class="row">
    <div class="col-md-4">
346
      <h4 id="shell-windows">Windows</h4>
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
      <ol>
        <li>Download the Git for Windows <a href="https://git-for-windows.github.io/">installer</a>.</li>
        <li>Run the installer and follow the steps bellow:
          <ol>
            <!-- Git 2.6.1 Setup -->
            <!-- Welcome to the Git Setup Wizard -->
            <li>Click on "Next".</li>
            <!-- Information -->
            <li>Click on "Next".</li>
            <!-- Select Destination Location -->
            <li>Click on "Next".</li>
            <!-- Select Components -->
            <li>Click on "Next".</li>
            <!-- Select Start Menu Folder -->
            <li>Click on "Next".</li>
            <!-- Adjusting your PATH environment -->
            <li>
              <strong>
                Select "Use Git from the Windows Command Prompt" and click on "Next".
              </strong>
                If you forgot to do this programs that you need for the workshop will not work properly.
                If this happens rerun the installer and select the appropriate option.
            </li>
            <!-- Configuring the line ending conversions -->
371
372
373
374
375
376
            <li>
              Click on "Next".
              <strong>
                Keep "Checkout Windows-style, commit Unix-style line endings" selected.
              </strong>
            </li>
377
            <!-- Configuring the terminal emulator to use with Git Bash -->
378
379
380
381
382
            <li>
              <strong>
                Select "Use Windows' default console window" and click on "Next".
              </strong>
            </li>
383
384
385
386
387
388
389
390
391
            <!-- Configuring experimental performance tweaks -->
            <li>Click on "Next".</li>
            <!-- Installing -->
            <!-- Completing the Git Setup Wizard -->
            <li>Click on "Finish".</li>
          </ol>
        </li>
      </ol>
      <p>This will provide you with both Git and Bash in the Git Bash program.</p>
392
    </div>
393
    <div class="col-md-4">
394
      <h4 id="shell-macosx">Mac OS X</h4>
395
      <p>
396
397
        The default shell in all versions of Mac OS X is Bash, so no
        need to install anything.  You access Bash from the Terminal
398
        (found in
399
        <code>/Applications/Utilities</code>). You may want to keep
400
        Terminal in your dock for this workshop.
401
402
      </p>
    </div>
403
    <div class="col-md-4">
404
      <h4 id="shell-linux">Linux</h4>
405
      <p>
406
407
408
409
        The default shell is usually Bash, but if your
        machine is set up differently you can run it by opening a
        terminal and typing <code>bash</code>.  There is no need to
        install anything.
410
411
      </p>
    </div>
412
  </div>
Raniere Silva's avatar
Raniere Silva committed
413
</div> <!-- End of 'shell' section. -->
414

415
416
<div id='git'> <!-- Start of 'Git' section. GitHub browser compatability
           is given at https://help.github.com/articles/supported-browsers/-->
417
  <h3>Git</h3>
418

419
420
421
422
  <p>
    Git is a version control system that lets you track who made changes
    to what when and has options for easily updating a shared or public
    version of your code
423
    on <a href="https://github.com/">github.com</a>. You will need a
424
425
    <a href="https://help.github.com/articles/supported-browsers/">supported</a>
    web browser (current versions of Chrome, Firefox or Safari,
426
    or Internet Explorer version 9 or above).
427
  </p>
428

429
430
  <div class="row">
    <div class="col-md-4">
431
      <h4 id="git-windows">Windows</h4>
432
      <p>
433
434
        Git should be installed on your computer as part of your Bash
        install (described above).
435
436
      </p>
    </div>
437
    <div class="col-md-4">
438
      <h4 id="git-macosx">Mac OS X</h4>
439
      <p>
Greg Wilson's avatar
Merging    
Greg Wilson committed
440
441
442
443
        <strong>For OS X 10.9 and higher</strong>, install Git for Mac
        by downloading and running the most recent "mavericks" installer from
        <a href="http://sourceforge.net/projects/git-osx-installer/files/">this list</a>.
        After installing Git, there will not be anything in your <code>/Applications</code> folder,
444
        as Git is a command line program.
Greg Wilson's avatar
Merging    
Greg Wilson committed
445
446
447
        <strong>For older versions of OS X (10.5-10.8)</strong> use the
        most recent available installer labelled "snow-leopard"
        <a href="http://sourceforge.net/projects/git-osx-installer/files/">available here</a>.
448
449
      </p>
    </div>
450
    <div class="col-md-4">
451
      <h4 id="git-linux">Linux</h4>
452
      <p>
453
454
        If Git is not already available on your machine you can try to
        install it via your distro's package manager. For Debian/Ubuntu run
455
456
        <code>sudo apt-get install git</code> and for Fedora run
        <code>sudo yum install git</code>.
457
458
      </p>
    </div>
459
  </div>
460
</div> <!-- End of 'Git' section. -->
461

Raniere Silva's avatar
Raniere Silva committed
462
463
464
465
466
467
468
469
470
<div id="editor"> <!-- Start of 'editor' section. -->
  <h3>Text Editor</h3>

  <p>
    When you're writing code, it's nice to have a text editor that is
    optimized for writing code, with features like automatic
    color-coding of key words.  The default text editor on Mac OS X and
    Linux is usually set to Vim, which is not famous for being
    intuitive.  if you accidentally find yourself stuck in it, try
Raniere Silva's avatar
Raniere Silva committed
471
    typing the escape key, followed by <code>:q!</code> (colon, lower-case 'q',
Raniere Silva's avatar
Raniere Silva committed
472
473
474
475
476
477
478
    exclamation mark), then hitting Return to return to the shell.
  </p>

  <div class="row">
    <div class="col-md-4">
      <h4 id="editor-windows">Windows</h4>
      <p>
479
        nano is a basic editor and the default that instructors use in the workshop.
480
        To install it,
Raniere Silva's avatar
Raniere Silva committed
481
482
483
484
485
        download the <a href="{{site.swc_installer}}">Software Carpentry Windows installer</a>
        and double click on the file to run it.
        <strong>This installer requires an active internet connection.</strong>
      </p>
      <p>
Raniere Silva's avatar
Raniere Silva committed
486
        Others editors that you can use are
487
488
        <a href="http://notepad-plus-plus.org/">Notepad++</a> or
        <a href="http://www.sublimetext.com/">Sublime Text</a>.
Raniere Silva's avatar
Raniere Silva committed
489
490
        <strong>Be aware that you must
          add its installation directory to your system path.</strong>
491
        Please ask your instructor to help you do this.
Raniere Silva's avatar
Raniere Silva committed
492
493
494
495
496
      </p>
    </div>
    <div class="col-md-4">
      <h4 id="editor-macosx">Mac OS X</h4>
      <p>
497
        nano is a basic editor and the default that instructors use in the workshop.
Raniere Silva's avatar
Raniere Silva committed
498
499
500
        It should be pre-installed.
      </p>
      <p>
Raniere Silva's avatar
Raniere Silva committed
501
        Others editors that you can use are
502
503
        <a href="http://www.barebones.com/products/textwrangler/">Text Wrangler</a> or
        <a href="http://www.sublimetext.com/">Sublime Text</a>.
Raniere Silva's avatar
Raniere Silva committed
504
505
506
507
508
      </p>
    </div>
    <div class="col-md-4">
      <h4 id="editor-linux">Linux</h4>
      <p>
509
        nano is a basic editor and the default that instructors use in the workshop.
Raniere Silva's avatar
Raniere Silva committed
510
511
512
        It should be pre-installed.
      </p>
      <p>
Raniere Silva's avatar
Raniere Silva committed
513
        Others editors that you can use are
Raniere Silva's avatar
Raniere Silva committed
514
        <a href="https://wiki.gnome.org/Apps/Gedit">Gedit</a>,
515
516
        <a href="http://kate-editor.org/">Kate</a> or
        <a href="http://www.sublimetext.com/">Sublime Text</a>.
Raniere Silva's avatar
Raniere Silva committed
517
518
519
520
521
      </p>
    </div>
  </div>
</div> <!-- End of 'editor' section. -->

522
<div id="python"> <!-- Start of 'Python' section. Remove the third paragraph if
523
524
525
           the workshop will teach Python using something other than
           the IPython notebook.
           Details at http://ipython.org/ipython-doc/2/install/install.html#browser-compatibility -->
526
  <h3>Python</h3>
527

528
529
530
531
  <p>
    <a href="http://python.org">Python</a> is a popular language for
    scientific computing, and great for general-purpose programming as
    well.  Installing all of its scientific packages individually can be
532
    a bit difficult, so we recommend
533
    <a href="https://www.continuum.io/anaconda">Anaconda</a>,
534
    an all-in-one installer.
535
  </p>
536

Greg Wilson's avatar
Greg Wilson committed
537
538
    <p>
      Regardless of how you choose to install it,
539
540
      <strong>please make sure you install Python version 3.x</strong>
      (e.g., 3.4 is fine).
Greg Wilson's avatar
Greg Wilson committed
541
    </p>
542

543
544
545
    <p>
      We will teach Python using the IPython notebook, a programming environment
      that runs in a web browser. For this to work you will need a reasonably
546
      up-to-date browser. The current versions of the Chrome, Safari and
547
548
549
      Firefox browsers are all <a
      href='http://ipython.org/ipython-doc/2/install/install.html#browser-compatibility'>supported</a>
      (some older browsers, including Internet Explorer version 9
550
      and below, are not).
551
552
    </p>

553
554
  <div class="row">
    <div class="col-md-4">
555
      <h4 id="python-windows">Windows</h4>
556
557
      <ol>
        <li>Open <a href="http://continuum.io/downloads">http://continuum.io/downloads</a> with your web browser.</li>
558
        <li>Download the Python 3 installer for Windows.</li>
559
560
        <li>Install Python 3 using all of the defaults for installation <em>except</em> make sure to check <strong>Make Anaconda the default Python</strong>.</li>
      </ol>
561
    </div>
562
    <div class="col-md-4">
563
      <h4 id="python-macosx">Mac OS X</h4>
564
565
      <ol>
        <li>Open <a href="http://continuum.io/downloads">http://continuum.io/downloads</a> with your web browser.</li>
566
        <li>Download the Python 3 installer for OS X.</li>
567
568
        <li>Install Python 3 using all of the defaults for installation.</li>
      </ol>
569
    </div>
570
    <div class="col-md-4">
571
      <h4 id="python-linux">Linux</h4>
572
573
      </p>
      <ol>
574
        <li>Open <a href="http://continuum.io/downloads">http://continuum.io/downloads</a> with your web browser.</li>
575
        <li>Download the Python 3 installer for Linux.</li>
576
577
578
579
        <li>Install Python 3 using all of the defaults for installation.
        (Installation requires using the shell. If you aren't
        comfortable doing the installation yourself
        stop here and request help at the workshop.)</li>
580
        <li>
581
          Open a terminal window.
582
583
        </li>
        <li>
584
585
586
          Type <pre>bash Anaconda-</pre> and then press
          tab. The name of the file you just downloaded should
          appear.
587
588
        </li>
        <li>
589
590
591
592
593
594
595
          Press enter. You will follow the text-only prompts.  When
          there is a colon at the bottom of the screen press the down
          arrow to move down through the text. Type <code>yes</code> and
          press enter to approve the license. Press enter to approve the
          default location for the files. Type <code>yes</code> and
          press enter to prepend Anaconda to your <code>PATH</code>
          (this makes the Anaconda distribution the default Python).
596
        </li>
597
598
      </ol>
    </div>
599
  </div>
600
601
602
603
604
  <p>
  Once you are done installing the software listed above,
  please go to <a href="setup/index.html">this page</a>,
  which has instructions on how to test that everything was installed correctly.
  </p>
605
</div> <!-- End of 'Python' section. -->
606

607
<div id="r"> <!-- Start of 'R' section. -->
608
  <h3>R</h3>
609

610
611
612
613
614
615
  <p>
    <a href="http://www.r-project.org">R</a> is a programming language
    that is especially powerful for data exploration, visualization, and
    statistical analysis. To interact with R, we use
    <a href="http://www.rstudio.com/">RStudio</a>.
  </p>
616

617
618
  <div class="row">
    <div class="col-md-4">
619
      <h4 id="r-windows">Windows</h4>
620
      <p>
621
622
623
624
625
        Install R by downloading and running
        <a href="http://cran.r-project.org/bin/windows/base/release.htm">this .exe file</a>
        from <a href="http://cran.r-project.org/index.html">CRAN</a>.
        Also, please install the
        <a href="http://www.rstudio.com/ide/download/desktop">RStudio IDE</a>.
626
627
      </p>
    </div>
628
    <div class="col-md-4">
629
      <h4 id="r-macosx">Mac OS X</h4>
630
      <p>
631
632
633
634
635
        Install R by downloading and running
        <a href="http://cran.r-project.org/bin/macosx/R-latest.pkg">this .pkg file</a>
        from <a href="http://cran.r-project.org/index.html">CRAN</a>.
        Also, please install the
        <a href="http://www.rstudio.com/ide/download/desktop">RStudio IDE</a>.
636
637
      </p>
    </div>
638
    <div class="col-md-4">
639
      <h4 id="r-linux">Linux</h4>
640
      <p>
641
642
643
644
        You can download the binary files for your distribution
        from <a href="http://cran.r-project.org/index.html">CRAN</a>. Or
        you can use your package manager (e.g. for Debian/Ubuntu
        run <code>sudo apt-get install r-base</code> and for Fedora run
645
        <code>sudo yum install R</code>).  Also, please install the
646
        <a href="http://www.rstudio.com/ide/download/desktop">RStudio IDE</a>.
647
648
      </p>
    </div>
649
  </div>
650
</div> <!-- End of 'R' section. -->
651

652
<div id="sql"> <!-- Start of 'SQLite' section. -->
653
  <h3>SQLite</h3>
654

655
656
657
658
659
  <p>
    SQL is a specialized programming language used with databases.  We
    use a simple database manager called
    <a href="http://www.sqlite.org/">SQLite</a> in our lessons.
  </p>
660

661
662
  <div class="row">
    <div class="col-md-4">
663
      <h4 id="sql-windows">Windows</h4>
664
      <p>
665
666
667
        The <a href="{{site.swc_github}}/windows-installer">Software Carpentry Windows Installer</a>
        installs SQLite for Windows.
        If you used the installer to configure nano, you don't need to run it again.
668
669
      </p>
    </div>
670
    <div class="col-md-4">
671
      <h4 id="sql-macosx">Mac OS X</h4>
672
      <p>
673
        SQLite comes pre-installed on Mac OS X.
674
675
      </p>
    </div>
676
    <div class="col-md-4">
677
      <h4 id="sql-linux">Linux</h4>
678
      <p>
679
        SQLite comes pre-installed on Linux.
680
681
      </p>
    </div>
682
  </div>
683
684

  <p><strong>If you installed Anaconda, it also has a copy of SQLite
Raniere Silva's avatar
Raniere Silva committed
685
    <a href="https://github.com/ContinuumIO/anaconda-issues/issues/307">without support to <code>readline</code></a>.
686
    Instructors will provide a workaround for it if needed.</strong></p>
687
</div> <!-- End of 'SQLite' section. -->
688

689
690
<!--
  Uncomment this section if you are using our virtual machine.
691

692
<div id="vm">
693
  <h3>Virtual Machine</h3>
694

695
696
697
698
699
700
701
702
703
704
  <p>
    Some instructors prefer to have learners use a virtual machine (VM)
    rather than install software on their own computers.  If your
    instructors have chosen to do this, please:
  </p>
  <ol>
    <li>
      Install <a href="https://www.virtualbox.org/">VirtualBox</a>.
    </li>
    <li>
705
      Download our <a href="{{site.swc_vm}}">VM image</a>.
706
707
708
709
710
711
712
713
714
715
      <strong>Warning:</strong> this file is 1.7 GByte, so please
      download it <em>before</em> coming to your workshop.
    </li>
    <li>
      Load the VM into VirtualBox by selecting "Import Appliance" and
      loading the <code>.ova</code> file.
    </li>
  </ol>
</div>
-->