forked from UW-Madison-ACI/2016-06-08-uwmadison
-
Notifications
You must be signed in to change notification settings - Fork 0
/
index.html
764 lines (698 loc) · 29.5 KB
/
index.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
---
layout: workshop # DON'T CHANGE THIS.
root: . # DON'T CHANGE THIS.
venue: "University of Wisconsin - Madison" # brief name of host site without address (e.g., "Euphoric State University")
address: "3rd Floor Teaching Lab, Discovery Building, 330 North Orchard St., Madison, WI" # street address of workshop (e.g., "123 Forth Street, Blimingen, Euphoria")
country: "us" # country (lowercase two-letter ISO code such as "fr" - see https://en.wikipedia.org/wiki/ISO_3166-1)
language: "en" # language (lowercase two-letter ISO code such as "fr" - see https://en.wikipedia.org/wiki/ISO_639-1)
latlng: "43.0725832,-89.4113731" # fractional latitude and longitude (e.g., "41.7901128,-87.6007318"; you can use http://www.latlong.net/)
humandate: "June 8-9, 2016" # human-readable date (e.g., "Feb 17-18, 2020")
humantime: "8:30 am - 4:00 pm" # human-readable time (e.g., "9:00 am - 4:30 pm")
startdate: 2016-06-08 # use YYYY-MM-DD format like 2015-01-01
enddate: 2016-06-09 # use YYYY-MM-DD format like 2015-01-02
instructor: ["Matt Garcia", "Lauren Michael", "Danielle Nielsen", "Sarah Stevens"] # list of names like ["Kay McNulty", "Betty Jennings", "Betty Snyder"]
helper: ["Karl Broman", "Ethan Nelson", "Andy Pohl"] # list of names like ["Marlyn Wescoff", "Fran Bilas", "Ruth Lichterman"]
contact: "[email protected]" # contact email address for workshop organizer, such as "[email protected]"
etherpad: http://pad.software-carpentry.org/2016-06-08-uwmadison # optional (insert the URL for your Etherpad if you're using one)
eventbrite: 24664043819
---
<!-- See instructions in the comments below for how to edit specific sections of this workshop template. -->
<!--
HEADER
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.
-->
<b>Registration is required and will be available just below,
starting at 5:00pm on Wednesday, May 4.</b> Make sure to read
all details below before registering and to choose appropriately
between UW-Madison's Data Carpentry and Software Carpentry workshops.
<!--
EVENTBRITE
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.
-->
{% if page.eventbrite %}
<iframe
src="https://www.eventbrite.com/tickets-external?eid={{page.eventbrite}}&ref=etckt"
frameborder="0"
width="100%"
height="248px"
scrolling="auto">
</iframe>
{% endif %}
<h2 id="general">General Information</h2>
<!--
INTRODUCTION
Edit the general explanatory paragraph below if you want to change
the pitch.
-->
<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.
</br>
</br>
For researchers who have no prior experience with programming and just
want to get started in some basic skills for organizing, combining, and
visualizing data, our UW-Madison <a href="http://uw-madison-aci.github.io/2016-06-01-uwmadison/">
<i>Data Carpentry</i> workshop (June 1-2)</a> will likely be
more appropriate. These two workshops are <b>NOT</b> intended to be taken back-to-back,
and you can learn about future workshops at UW-Madison by joining the
<a href="http://wisc.us9.list-manage.com/subscribe?u=c3aae71670855b66d79d170b8&id=6d65510fb6">
mailing list</a> of UW-Madison's <a href="http://aci.wisc.edu/">Advanced Computing Initiative</a>.
</p>
<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>
<!--
AUDIENCE
Explain who your audience is. (In particular, tell readers if the
workshop is only open to people from a particular institution.
-->
<p id="who">
<strong>Who:</strong>
The course is aimed at UW-Madison graduate students and other UW-Madison researchers.
<strong>Some prior experience with programming is strongly recommended.</strong>
</p>
<!--
LOCATION
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.
-->
{% if page.latlng %}
<p id="where">
<strong>Where:</strong>
{{page.address}}.
Get directions with
<a href="//www.openstreetmap.org/?mlat={{page.latlng | replace:',','&mlon='}}&zoom=16">OpenStreetMap</a>
or
<a href="//maps.google.com/maps?q={{page.latlng}}">Google Maps</a>.
</p>
{% endif %}
<!--
SPECIAL REQUIREMENTS
Modify the block below if there are any special requirements.
-->
<p id="requirements">
<strong>Requirements:</strong> Participants must be affiliated with UW-Madison
and bring a laptop with a few specific software packages installed (listed
<a href="#setup">below</a>). An individual should only register if he/she
is able to attend ALL days of the workshop. While coffee and tea will be provided,
participants should eat a full breakfast and plan to bring or buy their own lunch nearby.
Attendees are also required to abide by Software Carpentry's
<a href="{{site.swc_site}}/conduct.html">Code of Conduct</a>.</br>
<b>Registration is required, and will be available just above General Information,
starting at 5:00 pm on Wednesday, May 4.</b>
</p>
<!--
ACCESSIBILITY
Modify the block below if there are any barriers to accessibility or
special instructions.
-->
<p id="accessibility">
<strong>Accessibility:</strong> We are committed to making this workshop
accessible to everybody.
The workshop organisers have checked that:
</p>
<ul>
<li>The room is wheelchair / scooter accessible.</li>
<li>Accessible restrooms are available.</li>
</ul>
<p>
If we can help making learning easier for
you or you have any concerns, please
{% if page.contact %}
<a href='mailto:{{page.contact}}'>contact us</a>
{% else %}
<a href='mailto:{{site.contact}}'>contact us</a>
{% endif %}
preferably by June 1, so that we have time to respond before the workshop.
</p>
<!--
CONTACT EMAIL ADDRESS
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.
-->
<p id="contact">
<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/>
<!--
SCHEDULE
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.
-->
<h2 id="schedule">Schedule</h2>
<!-- DO NOT EDIT SURVEY LINKS -->
<!--<p><em>Surveys</em></p>
<p>Please be sure to complete these surveys before and after the workshop.</p>
<p><a href='{{ site.swc_pre_survey }}{{ site.github.project_title }}'>Pre-workshop Survey</a></p>
<p><a href='{{ site.swc_post_survey }}{{ site.github.project_title }}'>Post-workshop Survey</a></p>-->
<div class="row">
<div class="col-md-6">
<h3>Day 1</h3>
<table class="table table-striped">
<tr> <td>8:30</td> <td><a href="https://github.com/UW-Madison-ACI/2016-06-08-uwmadison/blob/gh-pages/2016-06-08-BestPractices.pdf">Intro</a></td> </tr>
<tr> <td>09:00</td> <td><a href="http://swcarpentry.github.io/shell-novice/">Automating tasks with the Unix shell</a></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><a href="http://swcarpentry.github.io/python-novice-inflammation/">Building programs with Python</a></td> </tr>
<tr> <td>14:30</td> <td>Coffee</td> </tr>
<tr> <td>16:00</td> <td>Wrap-up</td> </tr>
</table>
</div>
<div class="col-md-6">
<h3>Day 2</h3>
<table class="table table-striped">
<tr> <td>09:00</td> <td><a href="http://swcarpentry.github.io/git-novice">Version control with Git</a></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><a href="https://github.com/UW-Madison-ACI/swcarpentry-workflows-in-practice">Workflows in Practice (mobility, collaboration)</a></td> </tr>
<tr> <td>14:30</td> <td>Coffee</td> </tr>
<tr> <td>14:45</td> <td><a href="https://github.com/UW-Madison-ACI/swcarpentry-workflows-in-practice/blob/master/resources.md">Resources</a></td></tr>
<tr> <td>16:00</td> <td>Wrap-up</td> </tr>
<!--<tr> <td>End</td> <td><a href='{{ site.swc_post_survey }}{{ site.github.project_title }}'>Post-workshop Survey</a></td></tr>-->
</table>
</div>
</div>
<!--
ETHERPAD
At `_misc/etherpad.txt` you will find a template for the etherpad.
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
http://pad.software-carpentry.org/YYYY-MM-DD-site
where 'YYYY-MM-DD-site' is the identifier for your workshop,
e.g., '2015-06-10-esu'.
-->
{% if page.etherpad %}
<p id="etherpad">
<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 %}
<hr/>
<!--
SYLLABUS
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.
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.
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.
-->
<h2 id="syllabus">Syllabus</h2>
<div class="row">
<div class="col-md-6">
<h3 id="syllabus-shell">The Unix Shell</h3>
<ul>
<li>Files and directories</li>
<li>History and tab completion</li>
<li>Pipes and redirection</li>
<li>Looping over files</li>
<li>Creating and running shell scripts</li>
<li>Finding things</li>
<li><a href="{{site.swc_githubio}}/shell-novice/reference.html">Reference...</a></li>
</ul>
</div>
<div class="col-md-6">
<h3 id="syllabus-python">Programming in Python</h3>
<ul>
<li>Using libraries</li>
<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>Using Python from the command line</li>
<li><a href="{{site.swc_githubio}}/python-novice-inflammation/reference.html">Reference...</a></li>
</ul>
</div>
<!--
<div class="col-md-6">
<h3 id="syllabus-r">Programming in R</h3>
<ul>
<li>Working with vectors and data frames</li>
<li>Reading and plotting data</li>
<li>Creating and using functions</li>
<li>Loops and conditionals</li>
<li>Using R from the command line</li>
<li><a href="{{site.swc_githubio}}/r-novice-inflammation/reference.html">Reference...</a></li>
</ul>
</div>
-->
<!--
<div class="col-md-6">
<h3 id="syllabus-matlab">Programming in MATLAB</h3>
<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>
-->
</div>
<div class="row">
<div class="col-md-6">
<h3 id="syllabus-git">Version Control with Git</h3>
<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>
<li><a href="{{site.swc_githubio}}/git-novice/reference.html">Reference...</a></li>
</ul>
</div>
</div>
<hr/>
<!--
SETUP
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.
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.
-->
<h2 id="setup">Setup</h2>
<p>
To participate in a Software Carpentry workshop, you will need
access to the software described below. In addition, you will
need an up-to-date web browser.
</p>
<p>
We maintain a list of common issues that occur during installation as a reference for instructors
that may be useful on the
<a href = "https://github.com/swcarpentry/workshop-template/wiki/Configuration-Problems-and-Solutions">Configuration Problems and Solutions wiki page</a>.
</p>
<div id="shell"> <!-- Start of 'shell' section. -->
<h3>The Bash Shell</h3>
<p>
Bash is a commonly-used shell that gives you the power to do simple
tasks more quickly.
</p>
<div class="row">
<div class="col-md-4">
<h4 id="shell-windows">Windows</h4>
<a href="https://www.youtube.com/watch?v=339AEqk9c-8">Video Tutorial</a>
<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 -->
<li>
Click on "Next".
<strong>
Keep "Checkout Windows-style, commit Unix-style line endings" selected.
</strong>
</li>
<!-- Configuring the terminal emulator to use with Git Bash -->
<li>
<strong>
Select "Use Windows' default console window" and click on "Next".
</strong>
</li>
<!-- 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>
</div>
<div class="col-md-4">
<h4 id="shell-macosx">Mac OS X</h4>
<p>
The default shell in all versions of Mac OS X is Bash, so no
need to install anything. You access Bash from the Terminal
(found in
<code>/Applications/Utilities</code>).
See the Git installation <a href="https://www.youtube.com/watch?v=9LQhwETCdwY ">video tutorial</a>
for an example on how to open the Terminal.
You may want to keep
Terminal in your dock for this workshop.
</p>
</div>
<div class="col-md-4">
<h4 id="shell-linux">Linux</h4>
<p>
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.
</p>
</div>
</div>
</div> <!-- End of 'shell' section. -->
<div id='git'> <!-- Start of 'Git' section. GitHub browser compatability
is given at https://help.github.com/articles/supported-browsers/-->
<h3>Git</h3>
<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
on <a href="https://github.com/">github.com</a>. You will need a
<a href="https://help.github.com/articles/supported-browsers/">supported</a>
web browser (current versions of Chrome, Firefox or Safari,
or Internet Explorer version 9 or above).
</p>
<div class="row">
<div class="col-md-4">
<h4 id="git-windows">Windows</h4>
<p>
Git should be installed on your computer as part of your Bash
install (described above).
</p>
</div>
<div class="col-md-4">
<h4 id="git-macosx">Mac OS X</h4>
<a href="https://www.youtube.com/watch?v=9LQhwETCdwY ">Video Tutorial</a>
<p>
<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,
as Git is a command line program.
<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>.
</p>
</div>
<div class="col-md-4">
<h4 id="git-linux">Linux</h4>
<p>
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
<code>sudo apt-get install git</code> and for Fedora run
<code>sudo yum install git</code>.
</p>
</div>
</div>
</div> <!-- End of 'Git' section. -->
<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
typing the escape key, followed by <code>:q!</code> (colon, lower-case 'q',
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>
<a href="https://www.youtube.com/watch?v=339AEqk9c-8">Video Tutorial</a>
<p>
nano is a basic editor and the default that instructors use in the workshop.
To install it,
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>
Others editors that you can use are
<a href="http://notepad-plus-plus.org/">Notepad++</a> or
<a href="http://www.sublimetext.com/">Sublime Text</a>.
<strong>Be aware that you must
add its installation directory to your system path.</strong>
Please ask your instructor to help you do this.
</p>
</div>
<div class="col-md-4">
<h4 id="editor-macosx">Mac OS X</h4>
<p>
nano is a basic editor and the default that instructors use in the workshop.
See the Git installation <a href="https://www.youtube.com/watch?v=9LQhwETCdwY ">video tutorial</a>
for an example on how to open nano.
It should be pre-installed.
</p>
<p>
Others editors that you can use are
<a href="http://www.barebones.com/products/textwrangler/">Text Wrangler</a> or
<a href="http://www.sublimetext.com/">Sublime Text</a>.
</p>
</div>
<div class="col-md-4">
<h4 id="editor-linux">Linux</h4>
<p>
nano is a basic editor and the default that instructors use in the workshop.
It should be pre-installed.
</p>
<p>
Others editors that you can use are
<a href="https://wiki.gnome.org/Apps/Gedit">Gedit</a>,
<a href="http://kate-editor.org/">Kate</a> or
<a href="http://www.sublimetext.com/">Sublime Text</a>.
</p>
</div>
</div>
</div> <!-- End of 'editor' section. -->
<div id="python"> <!-- Start of 'Python' section. Remove the third paragraph if
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 -->
<h3>Python</h3>
<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
a bit difficult, so we highly recommend
<a href="https://www.continuum.io/anaconda">Anaconda</a>,
an all-in-one installer with many of the most-often-used packages.
</p>
<p>
Regardless of how you choose to install it,
<strong>please make sure you install Python version 3.x</strong>
(e.g., 3.4 is fine). <strong>NOTE:</strong> if you already have installed Python version
2.x using the Anaconda installer, you need not download another installer for version 3.x.
You can set up a virtual installation of Python version 3, switch between your Python
versions, and remove the version 3 installation at any time. Ask your instructors how to
do this using the <strong>conda</strong> package manager that you already have installed.
</p>
<p>
We will teach Python using the Jupyter (formerly IPython) notebook, an interactive programming environment
that uses your web browser. For this to work you will need a reasonably
up-to-date browser. The current versions of the Chrome, Safari and
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
and below, are not).
</p>
<div class="row">
<div class="col-md-4">
<h4 id="python-windows">Windows</h4>
<a href="https://www.youtube.com/watch?v=xxQ0mzZ8UvA">Video Tutorial</a>
<ol>
<li>Open <a href="http://continuum.io/downloads">http://continuum.io/downloads</a> with your web browser.</li>
<li>Download the Python 3 installer for Windows.</li>
<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>
</div>
<div class="col-md-4">
<h4 id="python-macosx">Mac OS X</h4>
<a href="https://www.youtube.com/watch?v=TcSAln46u9U">Video Tutorial</a>
<ol>
<li>Open <a href="http://continuum.io/downloads">http://continuum.io/downloads</a> with your web browser.</li>
<li>Download the Python 3 installer for OS X.</li>
<li>Install Python 3 using all of the defaults for installation.</li>
</ol>
</div>
<div class="col-md-4">
<h4 id="python-linux">Linux</h4>
<ol>
<li>Open <a href="http://continuum.io/downloads">http://continuum.io/downloads</a> with your web browser.</li>
<li>Download the Python 3 installer for Linux.</li>
<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>
<li>
Open a terminal window.
</li>
<li>
Type <pre>bash Anaconda3-</pre> and then press
tab. The name of the file you just downloaded should
appear.
</li>
<li>
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).
</li>
</ol>
</div>
</div>
<!--
<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>
-->
</div> <!-- End of 'Python' section. -->
<!--<div id="r"> --> <!-- Start of 'R' section. -->
<!-- <h3>R</h3>
<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>
<div class="row">
<div class="col-md-4">
<h4 id="r-windows">Windows</h4>
<a href="https://www.youtube.com/watch?v=q0PjTAylwoU">Video Tutorial</a>
<p>
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>.
</p>
</div>
<div class="col-md-4">
<h4 id="r-macosx">Mac OS X</h4>
<a href="https://www.youtube.com/watch?v=5-ly3kyxwEg">Video Tutorial</a>
<p>
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>.
</p>
</div>
<div class="col-md-4">
<h4 id="r-linux">Linux</h4>
<p>
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
<code>sudo yum install R</code>). Also, please install the
<a href="http://www.rstudio.com/ide/download/desktop">RStudio IDE</a>.
</p>
</div>
</div>
</div> --><!-- End of 'R' section. -->
<!-- <div id="sql"> --> <!-- Start of 'SQLite' section. -->
<!-- <h3>SQLite</h3>
<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>
<div class="row">
<div class="col-md-4">
<h4 id="sql-windows">Windows</h4>
<p>
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.
</p>
</div>
<div class="col-md-4">
<h4 id="sql-macosx">Mac OS X</h4>
<p>
SQLite comes pre-installed on Mac OS X.
</p>
</div>
<div class="col-md-4">
<h4 id="sql-linux">Linux</h4>
<p>
SQLite comes pre-installed on Linux.
</p>
</div>
</div>
<p><strong>If you installed Anaconda, it also has a copy of SQLite
<a href="https://github.com/ContinuumIO/anaconda-issues/issues/307">without support to <code>readline</code></a>.
Instructors will provide a workaround for it if needed.</strong></p>
</div> --><!-- End of 'SQLite' section. -->
<!--
Uncomment this section if you are using our virtual machine.
<div id="vm">
<h3>Virtual Machine</h3>
<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>
Download our <a href="{{site.swc_vm}}">VM image</a>.
<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>
-->