-
Notifications
You must be signed in to change notification settings - Fork 3
/
prerequisites.html
129 lines (128 loc) · 10.5 KB
/
prerequisites.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
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<meta name="generator" content="pandoc">
<title>Software Prerequisites</title>
<link rel="shortcut icon" type="image/x-icon" href="http://software-carpentry.org/v5/favicon.ico" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<link rel="stylesheet" type="text/css" href="css/bootstrap/bootstrap.css" />
<link rel="stylesheet" type="text/css" href="css/swc.css" />
<link rel="alternate" type="application/rss+xml" title="The Software Carpentry Blog" href="http://software-carpentry.org/feed.xml"/>
<meta charset="UTF-8" />
<!-- HTML5 shim, for IE6-8 support of HTML5 elements -->
<!--[if lt IE 9]>
<script src="http://html5shim.googlecode.com/svn/trunk/html5.js"></script>
<![endif]-->
</head>
<body class="lesson">
<div class="container card">
<div class="banner">
<a href="http://software-carpentry.org" title="Software Carpentry">
<img alt="Software Carpentry banner" src="http://software-carpentry.org/img/software-carpentry-banner.png" />
</a>
</div>
<article>
<div class="row">
<div class="col-md-10 col-md-offset-1">
<h1 class="title">Software Prerequisites</h1>
<p><strong>Prior to the workshop, it is vital that you install some software on your laptop and create an account at Github by following the instructions below!</strong></p>
<p>There is little time during the workshop to deal with installation problems, so it makes the day run much more smoothly if you arrive with your software already installed.</p>
<h2 id="help">Help!</h2>
<p>We maintain a list of common problems that can occur during installation and ways of solving them. Take a look at the <a href="https://github.com/swcarpentry/workshop-template/wiki/Configuration-Problems-and-Solutions">Configuration Problems and Solutions wiki page</a> for help.</p>
<p>If you still have trouble, we will run a <strong>Software Installation surgery from 09.30 AM until 12.30 PM</strong> on <strong><em>Monday, December 14, 2015</em></strong>. This will take place in room 3013 (Simon Hettrick’s office), Building 32, Highfield campus. If you would like to come along to the surgery, <script type="text/javascript">
<!--
h='soton.ac.uk';a='@';n='rsg-info';e=n+a+h;
document.write('<a h'+'ref'+'="ma'+'ilto'+':'+e+'">'+'email us to arrange a time'+'<\/'+'a'+'>');
// -->
</script><noscript>email us to arrange a time (rsg-info at soton dot ac dot uk)</noscript>.</p>
<h2 id="bash">Bash</h2>
<p>Among many other things, Bash allows you to automate dull and boring tasks. We use it during the command line section of the course.</p>
<h4 id="windows">Windows</h4>
<p>Bash will be provided as part of the Git for Windows installation as described below.</p>
<h4 id="mac-os-x">Mac OS X</h4>
<p>The Bash shell is accessed by opening the “Terminal” application. The Terminal application can be found in the “Utilities” folder which is in your “Applications” folder.</p>
<h4 id="linux">Linux</h4>
<p>The Bash shell is accessed via the Terminal application.</p>
<h2 id="text-editor">Text Editor</h2>
<p>A text editor is the piece of software you use to view and write code. If you have a preferred text editor, please use it. If you don't have one, we recommend the following.</p>
<h4 id="windows-1">Windows</h4>
<p><a href="https://notepad-plus-plus.org/download/v6.8.7.html">Notepad++</a>. Just download the installer and run it.</p>
<h4 id="mac-os-x-and-linux">Mac OS X and Linux</h4>
<p>Nano is a text editor that is installed by default on Mac OS X and Linux.</p>
You can verify you have nano installed by opening a terminal and entering:
</p>
<pre class="code"><code>nano</code></pre>
<p>If nano is not installed, you will receive an error. If it is installed, nano will open (appearing not dissimilar to the terminal window, but with menu items at the bottom of the window).</p>
<p>To exit nano press CTRL+X (you might be prompted you to save or discard modified buffer - just type “N” to exit without saving).</p>
<h2 id="python">Python</h2>
<p>We use Python 3.4, because it is generally the most widely used version of Python. We will also use the numpy and matplotlib libraries and the nose unit testing framework. Fortunately, these do not need to be installed separately! The “Python3.4 Anaconda” installation provides everything Python-related you will need for the workshop. To install Anaconda, follow the instructions below.</p>
<h4 id="windows-2">Windows</h4>
<p>Download the <a href="https://repo.continuum.io/archive/Anaconda3-2.3.0-Windows-x86_64.exe">Python3.4 Anaconda installer</a>. Double click the installer and follow the instructions.</p>
<h4 id="mac-os-x-1">Mac OS X</h4>
<p>Download the <a href="https://repo.continuum.io/archive/Anaconda3-2.3.0-MacOSX-x86_64.pkg">Python 3.4 Anaconda MAC OS X Graphical installer</a>. Double click the <code>.pkg</code> file and follow the instructions.</p>
<h4 id="linux-1">Linux</h4>
<p>Download the <a href="https://repo.continuum.io/archive/Anaconda3-2.3.0-Linux-x86_64.sh">Python3.4 Anaconda installation script</a>. Install via the terminal like this:</p>
<pre class="code"><code>bash Anaconda3-2.3.0-Linux-x86_64.sh</code></pre>
<h2 id="git">Git</h2>
<p>Git is the version control software we will use. It allows you to keep track of your software and the edits made to it.</p>
<h4 id="create-a-github-account">Create a Github account</h4>
<p><strong>You should must create a Github account before attending the workshop!</strong></p>
<p>To create an account, <a href="https://github.com/join">go to the Github website</a> and provide your details. It’s quick and it’s free. Once you have your account, you need to install the Git software as described below.</p>
<h4 id="windows-3">Windows</h4>
<p>Download and install <a href="http://git-scm.com/download/win">Git for Windows</a>. <strong>Please note</strong> that you can accept the default installation options, <strong>with one exception</strong> - at the step ‘Configuring the terminal emulator to use with Git Bash’ you <strong>must</strong> select ‘Use Windows default console window’.</p>
<h4 id="mac-os-x-2">Mac OS X</h4>
<p>On Mac OS X 10.9 Mavericks and 10.10 Yosemite, Git will be installed automatically the first time you try to run it. Open a terminal and enter:</p>
<pre class="code"><code>git</code></pre>
<p>There may be a short delay whilst the installer operates. You can then follow the prompts to install the Apple command line development tools.</p>
<p>On Mac OS X 10.6 Snow Leoapard, Mac OS X 10.7 Lion and 10.8 Mountain Lion, download and open the <a href="http://downloads.sourceforge.net/project/git-osx-installer/git-2.3.5-intel-universal-snow-leopard.dmg?r=http%3A%2F%2Fsourceforge.net%2Fprojects%2Fgit-osx-installer%2Ffiles%2F&ts=1441637770&use_mirror=kent">Git installer image</a>. Double click the <code>.pkg</code> file and follow the instructions.</p>
<p>If you intend to use an earlier version of Mac OS X, please contact us before the event.</p>
<h4 id="linux-2">Linux</h4>
<p>Install via a terminal like this:</p>
<p>Ubuntu 14.04LTS and derivatives:</p>
<pre class="code"><code>sudo apt-get install git</code></pre>
<p>Fedora 22:</p>
<pre class="code"><code>su -
dnf install git</code></pre>
<h2 id="verify-your-setup">Verify your setup</h2>
<p>To make sure that everything has installed correctly, we have written a simple Python script to test the prerequisites.</p>
<p><strong>Close your existing terminal and reopen it (this is important!)</strong>.</p>
<p>Enter the command below into your terminal. It will download the python script and run it to check your prerequisites.</p>
<h4 id="windows-4">Windows</h4>
<p>From the Git folder in the Start Menu, open the Git Bash terminal.</p>
<pre class="code"><code>curl -L http://goo.gl/HuPJu3 | python</code></pre>
<h4 id="mac-os-x-linux">Mac OS X, Linux</h4>
<p>Close your existing terminal and reopen it. <strong>This is important!</strong></p>
<pre class="code"><code>curl -L http://goo.gl/HuPJu3 | python3.4</code></pre>
<p>On Windows, Mac OS X and Linux, the script will run and output some text. If everything has installed correctly, within the text you will see eight passes and no failures, like this:</p>
<pre class="code"><code>check command line shell (virtual-shell)... pass
check Git (git)... pass
check Nose (nosetests)... pass
check Nose Python package (nose)... pass
check Python version (python)... pass
check Argparse (argparse)... pass
check NumPy (numpy)... pass
check Matplotlib (matplotlib)... pass</code></pre>
<p>If anything fails, please <script type="text/javascript">
<!--
h='soton.ac.uk';a='@';n='rsg-info';e=n+a+h;
document.write('<a h'+'ref'+'="ma'+'ilto'+':'+e+'">'+'contact us'+'<\/'+'a'+'>');
// -->
</script><noscript>contact us (rsg-info at soton dot ac dot uk)</noscript> before the workshop.</p>
<h2 id="during-the-workshop">During the workshop</h2>
<p>We will make use of the <a href="https://public.etherpad-mozilla.org/p/SWC-Soton-Dec2015">Etherpad</a> collaboration tool during the workshop (Etherpad allows a group to edit documents online collaboratively in real-time). Please use this to keep collaborative notes and ask (and answer!) each others questions.</p>
</div>
</div>
</article>
<div class="footer">
<a class="label swc-blue-bg" href="http://software-carpentry.org">Software Carpentry</a>
<a class="label swc-blue-bg" href="https://github.com/Southampton-RSG/2015-12-15-Southampton">Source</a>
<a class="label swc-blue-bg" href="mailto:[email protected]">Contact</a>
<a class="label swc-blue-bg" href="LICENSE.html">License</a>
</div>
</div>
<!-- Javascript placed at the end of the document so the pages load faster. -->
<script src="{{page.root}}/js/jquery-1.9.1.min.js"></script>
<script src="{{page.root}}/css/bootstrap/bootstrap-js/bootstrap.js"></script>
</body>
</html>