-
Notifications
You must be signed in to change notification settings - Fork 14
/
Copy pathresources.html
168 lines (115 loc) · 9.93 KB
/
resources.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
<!DOCTYPE html>
<html lang="en">
<head>
<meta name="description" content ="STAT 94: Foundations of Data Science" />
<meta name="keywords" content ="DS8, Data Science, Berkeley" />
<meta name="author" content ="Ani Adhikari, John DeNero, Michael I. Jordan, Tapan Parikh, David Wagner, Henry Milner, Ross Boczar, Sam Lau" />
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
<meta name="viewport" content="width=device-width">
<link href="https://fonts.googleapis.com/css?family=Lato" rel="stylesheet" type="text/css">
<link rel="stylesheet" type="text/css" href="./assets/css/style.css">
<link rel="icon" href="./assets/images/favicon.ico">
<link rel="stylesheet" type="text/css" href="assets/css/article.css"/>
<title>Resources | STAT 94 Fall 2015</title>
</head>
<body id="index" class="home">
<div class="head">
<h2>
<a href="http://data8.org/">
<span class="coursename">STAT 94</span>
</a>
</h2>
<p> Foundations of Data Science <br> Fall 2015</p>
<p>
<div class="instructors">
<span class="category">Principal Instructor:</span> <br> Ani Adhikari
</div>
<div class="instructors">
<span class="category">Co-Instructors:</span><br>
John DeNero<br>Michael I. Jordan<br>Tapan Parikh<br>David Wagner
</div>
</p>
<hr/>
<ul class="navigation">
<a href="./"><li>Calendar</li></a>
<a href="./resources.html"><li>Resources</li></a>
</ul>
<hr/>
<ul class="navigation">
<a href="./about.html"><li>Course Info</li></a>
<a href="./staff.html"><li>Staff</li></a>
<a href="./datascience/"><li><code>datascience</code> Reference</li></a>
<a href="https://piazza.com/berkeley/fall2015/ds10"><li>Piazza</li></a>
<a href="https://bcourses.berkeley.edu/courses/1377166"><li>bCourses</li></a>
</ul>
<hr/>
</div>
<div id="content">
<h2 id="piazza">Piazza</h2>
<p><a href="http://piazza.com/">Piazza</a> is a platform where we (instructors and students) can post announcements, have discussions, and ask questions. To add the course on Piazza, go to "Students Get Started" on piazza.com, find UC Berkeley, and find Statistics 94. Create a student account with your Berkeley email.</p>
<p>Feel free to ask questions by email, but staff will check Piazza more frequently, and often other students will answer more quickly than we can. Plus, you'll help out other students who have the same question.</p>
<h2 id="bcourses">bCourses</h2>
<p><a href="https://bcourses.berkeley.edu">bCourses</a> is where we will post information that can't go on the public Internet. Currently it only contains your grades. By enrolling in the class, you should be automatically signed up for the bCourses page.</p>
<h2 id="tips-on-using-jupyter-notebooks">Tips on using Jupyter notebooks</h2>
<p>Labs and course projects will be done in Jupyter notebooks (also called iPython notebooks). A notebook is a mix of text and computer code that you can edit. (Editing is disabled for parts of some notebooks, but this is just to make sure you don't accidentally mess them up.)</p>
<p>You can create and edit notebooks yourself by installing software on any computer. But it's easier (and in the case of labs and projects, necessary) to edit notebooks using <a href="https://ds8.berkeley.edu">the course webpage</a>.</p>
<h3 id="the-first-lab">The first lab</h3>
<p>For example, here are the steps to get started on the first lab:</p>
<ol>
<li>Open a web browser on any computer. <strong>Currently, the only supported web browser is Chrome.</strong> (There's a problem with using the site in Safari, and possibly other browsers. We're working on it.)</li>
<li>Go to https://ds8.berkeley.edu .</li>
<li>You should be prompted to log in to your Cal Google account. (For example, [email protected] .)</li>
<li>Click the green “My Server” button.</li>
<li>Navigate to labs/lab01 and click “Lab 1 - Python and Jupyter.ipynb”. (Future labs will be under labs/labXY, and projects will be under projects/projectXY.)</li>
<li>The lab notebook has instructions for completing it. Lab 1 has more detailed tips for editing notebooks.</li>
</ol>
<h3 id="testing-and-being-done">Testing and being done</h3>
<p>Near the top-right corner of the Jupyter interface is a button that says "run ok tests". This runs an "autograder" program, which is the main mechanism for both you and the course instructors to check whether you've completed the labs correctly. When you click the button, each question in the lab will be checked for correctness. If a question is correct, you'll see something like this below the output for that cell:</p>
<pre><code>=====================================================================
Assignment: Lab 1
OK, version v1.4.1
=====================================================================
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Running tests
---------------------------------------------------------------------
Test summary
1 test cases passed! No cases failed.
Checking for software updates...
OK is up to date</code></pre>
<p>If the autograder thinks you haven't given the right answer, you'll see something like this instead:</p>
<pre><code>=====================================================================
Assignment: Lab 1
OK, version v1.4.1
=====================================================================
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Running tests
---------------------------------------------------------------------
Question 1 > Suite 1 > Case 1
from submission import *
>>> data-science
7
# Error: expected
# 8
# but got
# 7
---------------------------------------------------------------------
Test summary
0 test cases passed before encountering first failed test case
Checking for software updates...
OK is up to date</code></pre>
<p>The autograder message is somewhat verbose, but it is telling you that, in question 1, the correct output was 8, but your cell's output was 7. (At this point, you could just copy the expected output 8 into the end of your cell, but then you wouldn't learn anything. The labs aren't graded for correctness anyway.)</p>
<p>Once all of the autograder tests pass, you've finished the lab. Congratulations! Typically you can leave the lab section when you're done, unless there's something else on the agenda.</p>
<h3 id="errors-and-getting-an-account">Errors and getting an account</h3>
<p>When you go to https://ds8.berkeley.edu and sign in for the first time, you may see the error message "403 Access Forbidden". That just means we haven't created an account for you yet on that part of the website. If you've signed up recently for the course, this is likely to happen to you.</p>
<p>If you see this, just send one of the course <a href="staff.html">GSIs</a> an email telling us your @berkeley.edu email address, and we'll add you as soon as we can. (If you're in lab, you can ask your lab GSI.)</p>
<p>If you have other difficulties accessing course material, post about it on Piazza (publicly, if you're comfortable) or send a GSI an email.</p>
<h3 id="if-something-goes-wrong">If something goes wrong</h3>
<p>A notebook is really just a file (named, for example, "Lab 1 — Python & Jupyter.ipynb") that lives in a folder that's been set up for you on the course servers. You are accessing and modifying notebook files when you open them on ds8.berkeley.edu.</p>
<p>Initially, everyone has the same copy of the assignment notebooks, but as you fill it in with your code and text, your copy diverges from the original. It's possible, with a little ingenuity, to mess up your copy. If this happens, you can ask course staff to give you a new copy of the original assignment notebook, without any of your changes. (Unfortunately, you might lose whatever progress you've made on the assignment, unless it can be recovered.)</p>
<h3 id="editing-text-cells">Editing text cells</h3>
<p>In the first lab, you're only asked to edit and run the cells with code in them. You may notice that double-clicking on the text of the lab opens a similar editing interface. In fact, we've put the lab text in cells just like the code, but text cells are marked as such, so the notebook knows to treat them differently.</p>
<p>Actually, the text cells are not just ordinary text; they're in a language called <a href="http://daringfireball.net/projects/markdown/">Markdown</a>, which is similar to HTML but much more readable. You can edit them if you like, though you might destroy the lab instructions if you do!</p>
<p>In any case, if you're done playing with the Markdown editing interface for a text cell (or you accidentally double-clicked some text), just click the Run button near the top left (which will also run code cells). Running a Markdown cell converts it back to nicer-looking text.</p>
</div>
</body>
</html>