-
Notifications
You must be signed in to change notification settings - Fork 0
/
index.html
726 lines (661 loc) · 25.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
---
layout: workshop
root: .
venue: Woods Hole Oceanographic Institution and USGS Woods Hole # brief name of host site
address: WHOI Quissett Campus, 360 Woods Hole Rd., Woods Hole MA 02543 # street address of home location
country: United-States # country (hyphenated if need be, like 'United-Kingdom')
language: en # language code like 'en' or 'fr'
latlng: 41.535081, -70.649093 # fractional latitude and longitude like 41.7901128,-87.6007318
humandate: Sep 3-4, 2015 # use the format 'Feb 17-18, 2020' (without the quotes)
humantime: '9:00 am - 4:30 pm' # use the format '9:00 am - 4:30 pm' (without the quotes)
startdate: 2015-09-03 # use YYYY-MM-DD format like 2015-01-01
enddate: 2015-09-04 # use YYYY-MM-DD format like 2015-01-02
instructor: ["Harriet Alexander", "Janet Riley"] # list of names like ["Kay McNulty", "Betty Jennings", "Betty Snyder"]
helper: ["Isabela Le Bras", "Kathleen Pitz"] # list of names like ["Marlyn Wescoff", "Fran Bilas", "Ruth Lichterman"]
contact: [email protected] # contact email address for workshop organizer
etherpad: https://etherpad.mozilla.org/2015-09-03-WHOI-swcarpentry # optional (insert the URL for your Etherpad if you're using one)
eventbrite: # optional (delete this if not used, otherwise uncomment and provide 1234567890AB key for Eventbrite registration)
---
<!--
HEADER
Edit the values in the block above to be appropriate for your
workshop. Run 'tools/check' *before* committing to make sure that
changes are good.
-->
<!--
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="206px"
scrolling="auto">
</iframe>
{% endif %}
<h2>Navigation Shortcuts</h2>
Jump to...
<ul>
<li><a href="#resources">Additional Resources</a></li>
<li><a href="#thursday">Thursday's schedule</a></li>
<li><a href="#friday">Friday's schedule</a></li>
<li><a href="#etherpad">MoPad Etherpad notes</a></li>
<li><a href="#setup">Setup</a></li>
</ul>
<h2>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.
</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>
<p>
This workshop is sponsored by WHOI Ocean Informatics initiative, USGS Woods Hole, and MBLWHOI Library.
</p>
<!--
AUDIENCE
Explain who your audience is. (In particular, tell readers if the
workshop is only open to people from a particular institution.
-->
<p>
<strong>Who:</strong>
The course is aimed at staff and students of the Woods Hole Oceanographic Institution and USGS Woods Hole.
</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>
<strong>Where:</strong>
{{page.address}}
</p>
<p>
<strong>Building and room:</strong> Clark 5-07
</p>
<p>
Get directions with
<ul>
<li>
<a href="http://www.whoi.edu/directions/">WHOI's driving directions</a> and <a href="http://www.whoi.edu/page.do?pid=8957">Quissett Campus map</a>
</li>
<li>
<a href="//www.openstreetmap.org/?mlat={{page.latlng | replace:',','&mlon='}}&zoom=16">OpenStreetMap</a>, or
</li>
<li> <a href="//maps.google.com/maps?q={{page.latlng}}">Google Maps</a>.
</li>
</ul>
See <a href="http://www.whoi.edu/main/visitor-information">the WHOI visitor page</a> for more information.
</p>
{% endif %}
<!--
SPECIAL REQUIREMENTS
Modify the block below if there are any special requirements.
-->
<p>
<strong>Requirements:</strong> Participants must bring a laptop with
a few specific software packages installed (listed
<a href="#setup">below</a>). They are also required to abide by
Software Carpentry's
<a href="{{site.swc_site}}/conduct.html">Code of Conduct</a>.
</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>
<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.
-->
<a name="schedule"></a><h2>Schedule</h2>
<div class="row">
<div class="col-md-12">
<a name="thursday"></a><h3>Thursday</h3>
<table class="table table-striped">
<tr> <td>09:00 <a name="shell"></a></td>
<td><h4>Automating tasks with the Unix shell</h4>
<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>
</ul>
</td>
<td>
<h4>Links</h4>
<a href="./data/shell-novice-data.zip">Data files: shell-novice-data.zip</a><br/>
<a href="{{site.swc_lessons}}/ref/01-shell.html">Reference...</a>
</td>
</tr>
<tr> <td>10:30</td> <td colspan="2">Break</td> </tr>
<tr> <td>12:00</td> <td colspan="2">Lunch</td> </tr>
<tr> <td>13:00 <a name="git"></a></td>
<td>
<h4>Version Control with Git</h4>
<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>
</ul>
</td>
<td><h4>Links</h4>
<a href="https://github.com/janetriley/whoi-swc-workshop">Our git repo</a><br/>
<a href="{{site.swc_lessons}}/ref/02-git.html">Reference</a>
</td>
</tr>
<tr> <td>14:30</td> <td colspan="2">Break</td> </tr>
<tr> <td>16:00</td> <td colspan="2">Wrap-up</td> </tr>
</table>
</div>
<div class="col-md-12">
<a name="friday"></a><h3>Friday</h3>
<table class="table table-striped">
<tr> <td>09:00 <a name="intro_python"></a></td>
<td><h4>Programming in Python</h4>
<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>
</ul>
</td>
<td>
<h4>Links</h4>
For today:<BR/>
<UL>
<li><a href="./data/calc_current_speed.py">Example script: calculate current speed</a><BR/></li>
<li><a href="./data/python-novice-inflammation-data.zip">Data: python-novice-inflammation-data.zip</a></li>
<li><a href="{{site.swc_lessons}}/ref/03-python.html">Glossary and Reference</a></li>
</UL><BR/>
For next steps:<BR/>
<ul>
<li><a href="https://automatetheboringstuff.com/">Automate The Boring Stuff with Python:
Practical Programming for Total Beginners by Al Sweigart</a> free online, also in print</a></li>
<li><a href="http://www.greenteapress.com/thinkpython/thinkpython.html">Think Python by Allen Downey</a>
is a more traditional intro - free online, also in print</li>
<li><a href="https://developers.google.com/edu/python/">Google's Python class</a> includes videos and exercises</a></li>
<li>Official Python tutorial for <a href="https://docs.python.org/2.7/tutorial/index.html
https://docs.python.org/3.5/tutorial/index.html
">Python 2.7</a> and
<li><a href="https://docs.python.org/3.5/tutorial/index.html">Python 3.5</a></li>
<li><a href="https://www.python.org/dev/peps/pep-0008/">PEP8 Python Style Guide</a>
</ul>
</td>
</tr>
<tr> <td>10:30</td> <td colspan="2">Break</td> </tr>
<tr> <td>12:00</td> <td colspan="2">Lunch</td> </tr>
<tr> <td>13:00 <a name="adv_python"></a></td>
<td><h4>Advanced Python Topics: Data Analysis with Python</h4>
<ul>
<li>Starting with data</li>
<li>Index slice subset</li>
<li>Data types and format</li>
<li>Merging data</li>
<li>Data analysis automation: loops and functions</li>
<li>Plotting with matplotlib</li>
<li>Putting it all together</li>
</ul>
</td>
<td>
<h4>Links</h4>
Data:<a href="./data/python-ecology-data.zip">python-ecology-data.zip</a>
</td>
</tr>
<tr> <td>14:30</td> <td colspan="2">Break</td> </tr>
<tr> <td>16:00</td> <td colspan="2">Wrap-up</td> </tr>
</table>
</div>
<div class="col-md-12">
<p>Coffee provided courtesy of the MBLWHO Library at 8:30 and 1:00.</p>
<p>Bring a bag lunch or grab lunch on campus at <a href="http://www.whoi.edu/buttery/">The Buttery</a>.</p>
</div>
</div>
<a name="resources"></a><h2>Additional Resources</h2>
<div class="row">
<div class="col-md-12">
<ul>
<li><a href="https://gist.github.com/janetriley/356d9a6ac3b1007d1c04#file-general_resources-md">General</li>
<!--
<li><a href="">Shell Scripting</a></li>
-->
<li><a href="https://gist.github.com/janetriley/356d9a6ac3b1007d1c04#file-git_resources-md">git resources</a> and <a href="https://gist.github.com/janetriley/356d9a6ac3b1007d1c04#file-reverting_git_mistakes-md">walkthrough for how to get back an old version of a file</a> </li>
<li><a href="https://gist.github.com/janetriley/356d9a6ac3b1007d1c04#file-python_resources-md">Python resources</a></li>
<!--
<li><a href="">Data Analysis resources</a></li>
-->
</ul>
</div> <!-- end row -->
</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://etherpad.mozilla.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 %}
<hr/>
<a name="etherpad"></a><h2>Etherpad notes</h2>
<p>
We will use <a href="{{page.etherpad}}">the shared Etherpad at {{page.etherpad}}</a> 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>Syllabus</h2>
<div class="row">
<div class="col-md-6">
<h3>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_lessons}}/ref/01-shell.html">Reference...</a></li>
</ul>
</div>
<div class="col-md-6">
<h3>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_lessons}}/ref/02-git.html">Reference...</a></li>
</ul>
</div>
</div>
<div class="row">
<div class="col-md-6">
<h3>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_lessons}}/ref/03-python.html">Reference...</a></li>
</ul>
</div>
<div class="col-md-6">
<h3>Advanced Python Topics: Data Analysis with Python</h3>
<ul>
<li>Starting with data</li>
<li>Index slice subset</li>
<li>Data types and format</li>
<li>Merging data</li>
<li>Data analysis automation: loops and functions</li>
<li>Plotting with matplotlib</li>
<li>Putting it all together</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.
-->
<a name="setup"></a><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>
<p>
Install Git for Windows by downloading and running
<a href="http://msysgit.github.io/">the installer</a>.
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>). 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>
<p>
We'll use GitHub's server to practice collaborating with git during the workshop.
Please sign up for a free GitHub account at <a href="http://github.com">http://github.com</a> if you don't already have one.
Then add your GitHub username to <a href="http://goo.gl/forms/ybdaamHaaO">our list</a> We need to add each person to the GitHub project so they can edit files,
and we'd like to do that before the workshop to make best use of everyone's time.
</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>
<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, you need a text editor that will save
files as-is without adding proprietary formatting, as Word or other word processors do.
It's nice to have an editor optimized for writing code, with features like automatic
color-coding of key words.
</p>
<p>
For this workshop, we'll use Sublime Text. If you already have a favorite plain-text editor
you may use it instead.</p>
<p> During the workshop, especially in the git unit, your laptop may launch its default text editor
to complete a task The default text editor on Mac OS X and
Linux is usually Vi, 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>
<p>
We will use <a href="http://www.sublimetext.com/2">Sublime Text 2</a> for the workshop.
</p>
<p>
Another editor is <a href="http://notepad-plus-plus.org/">Notepad++</a>
<strong>Be aware that you must add the installation directory to your system path.</strong>
Please ask your instructor to help you do this.
</p>
<p>
nano is another popular basic editor. 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>
</div>
<div class="col-md-4">
<h4 id="editor-macosx">Mac OS X</h4>
<p>
We will use <a href="http://www.sublimetext.com/2">Sublime Text 2</a> for the workshop.
</p>
<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="http://www.barebones.com/products/textwrangler/">Text Wrangler</a> or
nano, which is pre-installed.
</p>
</div>
<div class="col-md-4">
<h4 id="editor-linux">Linux</h4>
<p>
We will use <a href="http://www.sublimetext.com/2">Sublime Text 2</a> for the workshop.
</p>
<p>
nano is a basic editor that should be pre-installed.
</p>
<p>
Others editors that you can use are
<a href="https://wiki.gnome.org/Apps/Gedit">Gedit</a> or
<a href="http://kate-editor.org/">Kate</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 recommend Anaconda, an all-in-one installer.
</p>
<p>
Regardless of how you choose to install it,
<strong>please make sure you install Python version 2.x and not version 3.x</strong>
(e.g., 2.7 is fine but not 3.4).
Python 3 introduced changes that will break some of the code we teach during the workshop.
</p>
<p>
We will teach the advanced Python module using the IPython notebook, a programming environment
that runs in a 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>
<ul>
<li>
Download and
install <a href="https://store.continuum.io/cshop/anaconda/">Anaconda</a>.
<BR/>
Download the Python 2.7 installer (do not follow the link to Python 3).
Accept the default configuration options. On the advanced options screen,
check both options: add Anaconda to your PATH,
and register Anaconda as the default Python.
</li>
</ul>
</div>
<div class="col-md-4">
<h4 id="python-macosx">Mac OS X</h4>
<ul>
<li>
Download and
install <a href="https://store.continuum.io/cshop/anaconda/">Anaconda</a>.
<BR/>
Download the default Python 2.7 installer (do not follow the link to Python 3).
Use all of the defaults for installation.
</li>
</ul>
</div>
<div class="col-md-4">
<h4 id="python-linux">Linux</h4>
<p>
We recommend the all-in-one scientific Python installer
<a href="http://continuum.io/downloads.html">Anaconda</a>.
(Installation requires using the shell and if you aren't
comfortable doing the installation yourself just
download the installer and we'll help you at the workshop.)
</p>
<ol>
<li>
Download the installer that matches your operating
system and save it in your home folder.
Download the default Python 2.7 installer (do not follow the link to Python 3).
</li>
<li>
Open a terminal window.
</li>
<li>
Type <pre>bash Anaconda-</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. -->
<!--
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>
-->