forked from rsokl/Learning_Python
-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathintro.html
295 lines (178 loc) · 13.7 KB
/
intro.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
<!DOCTYPE html>
<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Python Like You Mean It — Python Like You Mean It</title>
<script type="text/javascript" src="_static/js/modernizr.min.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script>
<script type="text/javascript" src="_static/jquery.js"></script>
<script type="text/javascript" src="_static/underscore.js"></script>
<script type="text/javascript" src="_static/doctools.js"></script>
<script type="text/javascript" src="_static/language_data.js"></script>
<script type="text/javascript" src="https://www.googletagmanager.com/gtag/js?id=UA-115029372-1"></script>
<script type="text/javascript" src="_static/gtag.js"></script>
<script async="async" type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.5/latest.js?config=TeX-AMS-MML_HTMLorMML"></script>
<script type="text/x-mathjax-config">MathJax.Hub.Config({"tex2jax": {"inlineMath": [["$", "$"], ["\\(", "\\)"]], "processEscapes": true, "ignoreClass": "document", "processClass": "math|output_area"}})</script>
<script type="text/javascript" src="_static/js/theme.js"></script>
<link rel="stylesheet" href="_static/css/theme.css" type="text/css" />
<link rel="stylesheet" href="_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="_static/my_theme.css" type="text/css" />
<link rel="index" title="Index" href="genindex.html" />
<link rel="search" title="Search" href="search.html" />
<link rel="next" title="Module 1: Getting Started with Python" href="module_1.html" />
<link rel="prev" title="Python Like You Mean It" href="index.html" />
</head>
<body class="wy-body-for-nav">
<div class="wy-grid-for-nav">
<nav data-toggle="wy-nav-shift" class="wy-nav-side">
<div class="wy-side-scroll">
<div class="wy-side-nav-search" >
<a href="index.html" class="icon icon-home"> Python Like You Mean It
</a>
<div class="version">
1.4
</div>
<div role="search">
<form id="rtd-search-form" class="wy-form" action="search.html" method="get">
<input type="text" name="q" placeholder="Search docs" />
<input type="hidden" name="check_keywords" value="yes" />
<input type="hidden" name="area" value="default" />
</form>
</div>
</div>
<div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
<p class="caption"><span class="caption-text">Table of Contents:</span></p>
<ul class="current">
<li class="toctree-l1 current"><a class="current reference internal" href="#">Python Like You Mean It</a><ul>
<li class="toctree-l2"><a class="reference internal" href="#what-this-is">What this is</a></li>
<li class="toctree-l2"><a class="reference internal" href="#what-this-isn-t">What this isn’t</a></li>
<li class="toctree-l2"><a class="reference internal" href="#what-about-python-textbooks">What about Python textbooks?</a></li>
<li class="toctree-l2"><a class="reference internal" href="#python-shouldn-t-be-too-easy">Python shouldn’t be <em>too</em> easy</a></li>
<li class="toctree-l2"><a class="reference internal" href="#plymi-is-on-github">PLYMI is on GitHub</a></li>
<li class="toctree-l2"><a class="reference internal" href="#contributors">Contributors</a></li>
<li class="toctree-l2"><a class="reference internal" href="#about-me">About Me</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="module_1.html">Module 1: Getting Started with Python</a></li>
<li class="toctree-l1"><a class="reference internal" href="module_2.html">Module 2: The Essentials of Python</a></li>
<li class="toctree-l1"><a class="reference internal" href="module_2_problems.html">Module 2: Problems</a></li>
<li class="toctree-l1"><a class="reference internal" href="module_3.html">Module 3: The Essentials of NumPy</a></li>
<li class="toctree-l1"><a class="reference internal" href="module_3_problems.html">Module 3: Problems</a></li>
<li class="toctree-l1"><a class="reference internal" href="module_4.html">Module 4: Object Oriented Programming</a></li>
<li class="toctree-l1"><a class="reference internal" href="module_5.html">Module 5: Odds and Ends</a></li>
<li class="toctree-l1"><a class="reference internal" href="changes.html">Changelog</a></li>
</ul>
</div>
</div>
</nav>
<section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
<nav class="wy-nav-top" aria-label="top navigation">
<i data-toggle="wy-nav-top" class="fa fa-bars"></i>
<a href="index.html">Python Like You Mean It</a>
</nav>
<div class="wy-nav-content">
<div class="rst-content">
<div role="navigation" aria-label="breadcrumbs navigation">
<ul class="wy-breadcrumbs">
<li><a href="index.html">Docs</a> »</li>
<li>Python Like You Mean It</li>
<li class="wy-breadcrumbs-aside">
<a href="_sources/intro.rst.txt" rel="nofollow"> View page source</a>
</li>
</ul>
<hr/>
</div>
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
<div itemprop="articleBody">
<style>
/* CSS overrides for sphinx_rtd_theme */
/* 24px margin */
.nbinput.nblast,
.nboutput.nblast {
margin-bottom: 19px; /* padding has already 5px */
}
/* ... except between code cells! */
.nblast + .nbinput {
margin-top: -19px;
}
.admonition > p:before {
margin-right: 4px; /* make room for the exclamation icon */
}
/* Fix math alignment, see https://github.com/rtfd/sphinx_rtd_theme/pull/686 */
.math {
text-align: unset;
}
</style>
<div class="section" id="python-like-you-mean-it">
<h1>Python Like You Mean It<a class="headerlink" href="#python-like-you-mean-it" title="Permalink to this headline">¶</a></h1>
<blockquote>
<div><p>Written by <a class="reference external" href="https://scholar.google.com/citations?hl=en&user=coXsftgAAAAJ&view_op=list_works&gmla=AJsN-F7Eg769ERNBQDKZ5-5xmT9qh2G2chKgH0Lwbd3zujR7FAPiWmVp_57dFPKG_h7ghPeLG8oGysj5YWziwXib4oHb6kr2HA">Ryan Soklaski</a> (Twitter/GitHub:<a class="reference external" href="https://twitter.com/rsokl">@rsokl</a>)</p>
<p>Edited by <a class="reference external" href="https://davidmascharka.com/">David Mascharka</a></p>
<p><a class="reference external" href="https://cn.pythonlikeyoumeanit.com/">中文版</a> (Chinese Version)</p>
</div></blockquote>
<div class="section" id="what-this-is">
<h2>What this is<a class="headerlink" href="#what-this-is" title="Permalink to this headline">¶</a></h2>
<p>Python Like You Mean It (PLYMI) is a free resource for learning the basics of Python & NumPy, and moreover, becoming a competent Python user. The features of the Python language that are emphasized here were chosen to help those who are particularly interested in STEM applications (data analysis, machine learning, numerical work, etc.).</p>
<p>I want this to be a lean, one-stop resource for learning the essentials of Python from scratch. The reader will begin by learning about what Python is and what installing Python even means, and will hopefully walk away with a solid understanding of a substantial core of the language and its premiere numerical library, NumPy. I am also placing an emphasis on best practices throughout this site and am teaching to the latest version of Python (version 3.8, as of writing this).</p>
</div>
<div class="section" id="what-this-isn-t">
<h2>What this isn’t<a class="headerlink" href="#what-this-isn-t" title="Permalink to this headline">¶</a></h2>
<p>This is not even close to being an exhaustive treatment of the Python language, and is not sufficient to become a “complete” Python user. But it will hopefully provide a solid enough foundation that acquiring those missing pieces will be relatively easy.</p>
<p>This is also not a deep “Python for Data Science” resource. It will not teach you how to use machine learning and data analysis libraries like sci-kit learn and Pandas. That being said, NumPy is such a critically-important library that it has deeply influenced essentially all of the other major STEM-related Python libraries (e.g. sci-kit, TensorFlow, PyTorch, Pandas). The NumPy content presented here will serve as a cornerstone for working with all of these libraries down the road.</p>
</div>
<div class="section" id="what-about-python-textbooks">
<h2>What about Python textbooks?<a class="headerlink" href="#what-about-python-textbooks" title="Permalink to this headline">¶</a></h2>
<p>Books and blogs can be great. I personally think that programming books can overwhelming because they are required to be so complete; it is hard for a someone new to a language to distill the essentials of the Python language from hundreds of pages of text. Furthermore, it simply makes more sense to make this sort of material available digitally; users should be able to easily search the site, view it on mobile devices, copy code snippets, and know that the content is being kept up-to-date.</p>
</div>
<div class="section" id="python-shouldn-t-be-too-easy">
<h2>Python shouldn’t be <em>too</em> easy<a class="headerlink" href="#python-shouldn-t-be-too-easy" title="Permalink to this headline">¶</a></h2>
<p>Python is a relatively easy language to pick up, and it doesn’t require much rigor to make code work. Unfortunately, this means that there are many Python users out there who know enough to just get by, but lack a sound understanding of the language. You don’t want to get caught in the “know enough Python to be dangerous” zone; therein lies complacency, stagnation, and the genesis of a lot of bad code. You’ve got to Python like you mean it!</p>
</div>
<div class="section" id="plymi-is-on-github">
<h2>PLYMI is on GitHub<a class="headerlink" href="#plymi-is-on-github" title="Permalink to this headline">¶</a></h2>
<p>If you have questions about the reading, think that you have spotted some mistakes, or would like to contribute to PLYMI, please visit <a class="reference external" href="https://github.com/rsokl/Learning_Python">our GitHub page</a>. You will need to create a GitHub account in order to post an issue; this process is free and easy. We would love for you to join us to discuss the website!</p>
</div>
<div class="section" id="contributors">
<h2>Contributors<a class="headerlink" href="#contributors" title="Permalink to this headline">¶</a></h2>
<p>The following people made significant contributions to PLYMI, adding problems with worked solutions and valuable feedback on the text:</p>
<ul class="simple">
<li><a class="reference external" href="https://github.com/alexding123">@alexding123</a></li>
<li>AJ Federici (GitHub:<a class="reference external" href="https://github.com/AFederici">@Federici</a>)</li>
<li>Annabelle Lew (GitHub:<a class="reference external" href="https://github.com/AnnabelleLew">@AnnabelleLew</a>)</li>
<li>Petar Griggs (GitHub:<a class="reference external" href="https://github.com/petarmhg">@petarmhg</a>)</li>
<li>Sam Carpenter (GitHub:<a class="reference external" href="https://github.com/HardBoiled800">@HardBoiled800</a>)</li>
</ul>
</div>
<div class="section" id="about-me">
<h2>About Me<a class="headerlink" href="#about-me" title="Permalink to this headline">¶</a></h2>
<p>I started learning to use Python in graduate school for my physics research, and I was <em>so</em> bad at using it. Fortunately, one of my labmates was more experienced and had the good sense to tell me that my code and work flow was terrible. He pointed me to tooling, style guides, and documentation pages so that I could improve (I’d like to think that this resource would have been a huge help to me back then). I’ve been coding in Python for at least six years now, and I’ve taken to following the language, along with its new features and changes, quite closely. Currently I do machine learning research, and have served as a core developer for a machine learning library. I also love to teach, so this has been a fun project for me to take on!</p>
</div>
</div>
</div>
</div>
<footer>
<div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
<a href="module_1.html" class="btn btn-neutral float-right" title="Module 1: Getting Started with Python" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right"></span></a>
<a href="index.html" class="btn btn-neutral float-left" title="Python Like You Mean It" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left"></span> Previous</a>
</div>
<hr/>
<div role="contentinfo">
<p>
© Copyright 2019, Ryan Soklaski
</p>
</div>
Built with <a href="http://sphinx-doc.org/">Sphinx</a> using a <a href="https://github.com/rtfd/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
</footer>
</div>
</div>
</section>
</div>
<script type="text/javascript">
jQuery(function () {
SphinxRtdTheme.Navigation.enable(true);
});
</script>
</body>
</html>