Skip to content

Commit 9d4d9df

Browse files
committed
html update
1 parent 45477c7 commit 9d4d9df

File tree

198 files changed

+1311
-476
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

198 files changed

+1311
-476
lines changed
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
-1 Bytes
Binary file not shown.
Binary file not shown.
-1 Bytes
Binary file not shown.
-1 Bytes
Binary file not shown.
Binary file not shown.
-1 Bytes
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.

docs/.doctrees/changes.doctree

9.77 KB
Binary file not shown.

docs/.doctrees/environment.pickle

61.3 KB
Binary file not shown.

docs/.doctrees/index.doctree

17 Bytes
Binary file not shown.

docs/.doctrees/intro.doctree

-1 Bytes
Binary file not shown.

docs/.doctrees/module_1.doctree

-1 Bytes
Binary file not shown.

docs/.doctrees/module_2.doctree

-1 Bytes
Binary file not shown.
-1 Bytes
Binary file not shown.

docs/.doctrees/module_3.doctree

-1 Bytes
Binary file not shown.
-1 Bytes
Binary file not shown.

docs/.doctrees/module_4.doctree

-1 Bytes
Binary file not shown.

docs/.doctrees/module_5.doctree

-1 Bytes
Binary file not shown.

docs/Module1_GettingStartedWithPython/Exercises/Informal_Intro_Python.html

+1
Original file line numberDiff line numberDiff line change
@@ -97,6 +97,7 @@
9797
<li class="toctree-l1"><a class="reference internal" href="../../module_3_problems.html">Module 3: Problems</a></li>
9898
<li class="toctree-l1"><a class="reference internal" href="../../module_4.html">Module 4: Object Oriented Programming</a></li>
9999
<li class="toctree-l1"><a class="reference internal" href="../../module_5.html">Module 5: Odds and Ends</a></li>
100+
<li class="toctree-l1"><a class="reference internal" href="../../changes.html">Changelog</a></li>
100101
</ul>
101102

102103

docs/Module1_GettingStartedWithPython/GettingStartedWithPython.html

+2-1
Original file line numberDiff line numberDiff line change
@@ -116,6 +116,7 @@
116116
<li class="toctree-l1"><a class="reference internal" href="../module_3_problems.html">Module 3: Problems</a></li>
117117
<li class="toctree-l1"><a class="reference internal" href="../module_4.html">Module 4: Object Oriented Programming</a></li>
118118
<li class="toctree-l1"><a class="reference internal" href="../module_5.html">Module 5: Odds and Ends</a></li>
119+
<li class="toctree-l1"><a class="reference internal" href="../changes.html">Changelog</a></li>
119120
</ul>
120121

121122

@@ -294,7 +295,7 @@ <h2>Why Python?<a class="headerlink" href="#Why-Python?" title="Permalink to thi
294295

295296
<span class="kt">int</span> <span class="nf">main</span><span class="p">()</span> <span class="p">{</span>
296297
<span class="n">std</span><span class="o">::</span><span class="n">vector</span><span class="o">&lt;</span><span class="kt">int</span><span class="o">&gt;</span> <span class="n">a</span> <span class="o">=</span> <span class="p">{</span><span class="mi">0</span><span class="p">,</span> <span class="mi">1</span><span class="p">,</span> <span class="mi">2</span><span class="p">,</span> <span class="mi">3</span><span class="p">,</span> <span class="mi">4</span><span class="p">,</span> <span class="mi">5</span><span class="p">,</span> <span class="mi">6</span><span class="p">,</span> <span class="mi">7</span><span class="p">,</span> <span class="mi">8</span><span class="p">,</span> <span class="mi">9</span><span class="p">};</span>
297-
<span class="n">std</span><span class="o">::</span><span class="n">cout</span> <span class="o">&lt;&lt;</span> <span class="n">std</span><span class="o">::</span><span class="n">accumulate</span><span class="p">(</span><span class="n">a</span><span class="p">.</span><span class="n">begin</span><span class="p">(),</span> <span class="n">e</span><span class="p">.</span><span class="n">end</span><span class="p">(),</span> <span class="mi">0</span><span class="p">)</span> <span class="o">&lt;&lt;</span> <span class="n">std</span><span class="o">::</span><span class="n">endl</span><span class="p">;</span>
298+
<span class="n">std</span><span class="o">::</span><span class="n">cout</span> <span class="o">&lt;&lt;</span> <span class="n">std</span><span class="o">::</span><span class="n">accumulate</span><span class="p">(</span><span class="n">a</span><span class="p">.</span><span class="n">begin</span><span class="p">(),</span> <span class="n">a</span><span class="p">.</span><span class="n">end</span><span class="p">(),</span> <span class="mi">0</span><span class="p">)</span> <span class="o">&lt;&lt;</span> <span class="n">std</span><span class="o">::</span><span class="n">endl</span><span class="p">;</span>
298299
<span class="p">}</span>
299300
</pre></div>
300301
</div>

docs/Module1_GettingStartedWithPython/Getting_Started_With_IDEs_and_Notebooks.html

+9-8
Original file line numberDiff line numberDiff line change
@@ -116,6 +116,7 @@
116116
<li class="toctree-l1"><a class="reference internal" href="../module_3_problems.html">Module 3: Problems</a></li>
117117
<li class="toctree-l1"><a class="reference internal" href="../module_4.html">Module 4: Object Oriented Programming</a></li>
118118
<li class="toctree-l1"><a class="reference internal" href="../module_5.html">Module 5: Odds and Ends</a></li>
119+
<li class="toctree-l1"><a class="reference internal" href="../changes.html">Changelog</a></li>
119120
</ul>
120121

121122

@@ -238,33 +239,33 @@ <h3>Recommended IDEs<a class="headerlink" href="#Recommended-IDEs" title="Permal
238239
<li>works well out-of-the-box</li>
239240
<li>long-supported by professionals and thus is very reliable</li>
240241
<li>highly configurable</li>
241-
<li>fully-featured</li>
242+
<li>fully-featured, with an excellent debugger, context-dependent “intellisense”, type-inference, and more</li>
243+
<li>the free “community version” is extremely robust and feature-rich.</li>
242244
</ul>
243245
<p><strong>Cons</strong></p>
244246
<ul class="simple">
245247
<li>can be resource-heavy, especially for a laptop</li>
246248
<li>may be overwhelming to new users (but has good documentation and tutorials)</li>
249+
<li>Jupyter notebook support requires the premium version of PyCharm, making it inaccessible to newcomers</li>
247250
</ul>
248251
<p><a class="reference external" href="https://code.visualstudio.com/">Visual Studio Code</a> with the <a class="reference external" href="https://code.visualstudio.com/docs/languages/python">Python extension</a>: A lightweight, highly customizable IDE.</p>
249252
<p><strong>Pros</strong></p>
250253
<ul class="simple">
251254
<li>lightweight and elegant</li>
252-
<li>works with many different languages, so you only need to familiarize yourself with one IDE</li>
255+
<li>completely free</li>
256+
<li>works with many different languages, so you only need to familiarize yourself with one IDE if you are a polyglot programmer</li>
253257
<li>a huge number of extensions can be downloaded to add functionality to the editor; these are created by a large community of open-source developers.</li>
258+
<li><a class="reference external" href="https://code.visualstudio.com/docs/python/jupyter-support">has native support for Jupyter notebooks</a>, meaning that you get VSCode’s intellisense, debugger, and ability to inspect variables, all in a notebook.</li>
254259
</ul>
255260
<p><strong>Cons</strong></p>
256261
<ul class="simple">
257-
<li>currently less polished and less powerful than PyCharm, although Microsoft is now formally supporting the Python extension</li>
258-
<li>can require some tinkering to get features working</li>
262+
<li>configuring VSCode for python development can have a moderate learning curve for newcomers</li>
263+
<li>many features, like context-aware intellisense and type-inference, are simply more polished and powerful in PyCharm</li>
259264
</ul>
260265
<div class="admonition note">
261266
<p class="admonition-title fa fa-exclamation-circle"><strong>Takeaway</strong>:</p>
262267
<p>Integrated Development Environments (IDEs) provide powerful tools for helping you write well-formatted and typo-free code. We recommend using PyCharm Community Edition or Visual Studio Code (with the Python extension installed) for your Python IDE.</p>
263268
</div>
264-
<div class="admonition warning">
265-
<p class="admonition-title fa fa-exclamation-circle"><strong>Jupyter Lab</strong>:</p>
266-
<p><a class="reference external" href="https://jupyterlab.readthedocs.io/en/stable/getting_started/overview.html">Jupyter Lab</a> is a new IDE that is being developed by the same team that develops the Jupyter Notebook. It aims to mix the polish and power of a traditional IDE, along with the convenience and great utility of the notebook environment. As of writing this, Jupyter Lab is still in the beta release phase. Given the massive popularity of Jupyter Notebook, Jupyter Lab will likely become a widely used IDE, quickly.</p>
267-
</div>
268269
</div>
269270
</div>
270271
</div>

docs/Module1_GettingStartedWithPython/Informal_Intro_Python.html

+1
Original file line numberDiff line numberDiff line change
@@ -114,6 +114,7 @@
114114
<li class="toctree-l1"><a class="reference internal" href="../module_3_problems.html">Module 3: Problems</a></li>
115115
<li class="toctree-l1"><a class="reference internal" href="../module_4.html">Module 4: Object Oriented Programming</a></li>
116116
<li class="toctree-l1"><a class="reference internal" href="../module_5.html">Module 5: Odds and Ends</a></li>
117+
<li class="toctree-l1"><a class="reference internal" href="../changes.html">Changelog</a></li>
117118
</ul>
118119

119120

docs/Module1_GettingStartedWithPython/Installing_Python.html

+1
Original file line numberDiff line numberDiff line change
@@ -114,6 +114,7 @@
114114
<li class="toctree-l1"><a class="reference internal" href="../module_3_problems.html">Module 3: Problems</a></li>
115115
<li class="toctree-l1"><a class="reference internal" href="../module_4.html">Module 4: Object Oriented Programming</a></li>
116116
<li class="toctree-l1"><a class="reference internal" href="../module_5.html">Module 5: Odds and Ends</a></li>
117+
<li class="toctree-l1"><a class="reference internal" href="../changes.html">Changelog</a></li>
117118
</ul>
118119

119120

docs/Module1_GettingStartedWithPython/Jupyter_Notebooks.html

+18-3
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@
66
<head>
77
<meta charset="utf-8">
88
<meta content="Topic: Jupyter notebooks, Difficulty: Easy, Category: Tutorial" name="description" />
9-
<meta content="jupyter, notebook, kernel, basics, server, console, command line, plot, beginner, data science" name="keywords" />
9+
<meta content="jupyter, jupyter lab, notebook, kernel, basics, server, console, plot, beginner, data science" name="keywords" />
1010

1111
<meta name="viewport" content="width=device-width, initial-scale=1.0">
1212

@@ -100,12 +100,14 @@
100100
<li class="toctree-l2"><a class="reference internal" href="Installing_Python.html">Installing Python</a></li>
101101
<li class="toctree-l2"><a class="reference internal" href="Informal_Intro_Python.html">An Informal Introduction to Python</a></li>
102102
<li class="toctree-l2 current"><a class="current reference internal" href="#">Jupyter Notebooks</a><ul>
103+
<li class="toctree-l3"><a class="reference internal" href="#Jupyter-Lab">Jupyter Lab</a></li>
103104
<li class="toctree-l3"><a class="reference internal" href="#Running-a-Notebook-Server-&amp;-Creating-a-Notebook">Running a Notebook Server &amp; Creating a Notebook</a></li>
104105
<li class="toctree-l3"><a class="reference internal" href="#Notebook-Cells">Notebook Cells</a></li>
105106
<li class="toctree-l3"><a class="reference internal" href="#An-Example-Notebook">An Example Notebook</a></li>
106107
<li class="toctree-l3"><a class="reference internal" href="#Familiarizing-Yourself-with-Jupyter-Notebooks">Familiarizing Yourself with Jupyter Notebooks</a><ul>
107108
<li class="toctree-l4"><a class="reference internal" href="#Markdown-Cells">Markdown Cells</a></li>
108109
<li class="toctree-l4"><a class="reference internal" href="#Using-Jupyter-Notebooks-with-Other-Languages">Using Jupyter Notebooks with Other Languages</a></li>
110+
<li class="toctree-l4"><a class="reference internal" href="#Jupyter-Notebook-Support-in-Visual-Studio-Code">Jupyter Notebook Support in Visual Studio Code</a></li>
109111
</ul>
110112
</li>
111113
</ul>
@@ -119,6 +121,7 @@
119121
<li class="toctree-l1"><a class="reference internal" href="../module_3_problems.html">Module 3: Problems</a></li>
120122
<li class="toctree-l1"><a class="reference internal" href="../module_4.html">Module 4: Object Oriented Programming</a></li>
121123
<li class="toctree-l1"><a class="reference internal" href="../module_5.html">Module 5: Odds and Ends</a></li>
124+
<li class="toctree-l1"><a class="reference internal" href="../changes.html">Changelog</a></li>
122125
</ul>
123126

124127

@@ -414,11 +417,19 @@ <h1>Jupyter Notebooks<a class="headerlink" href="#Jupyter-Notebooks" title="Perm
414417
syntax</a>), for presenting and explaining the contents of the notebook.</p>
415418
<p>In this way, the Jupyter Notebook stands out as an excellent tool for many practical applications. You could work on a notebook while you are working through sections of this website, for instance, testing out snippets of code, and answering reading-comprehension questions as you proceed through the text, and using markdown-headers to visually separate different portions of the notebook. When I do research, I am always creating Jupyter notebooks in which I write code that analyzes data, I plot
416419
various results, presented in different ways, and I write detailed markdown-text blocks to document my work. The end result is something that I can share with my labmates, and easily revisit months later without having to struggle to recall what I had done.</p>
417-
<p>Enough gushing about Jupyter notebooks. Let’s start using them!</p>
420+
<div class="section" id="Jupyter-Lab">
421+
<h2>Jupyter Lab<a class="headerlink" href="#Jupyter-Lab" title="Permalink to this headline"></a></h2>
422+
<p><a class="reference external" href="https://jupyterlab.readthedocs.io/">Jupyter lab</a> is a new web interface from Project Jupyter that provides a rich web-based interface for managing and running Jupyter notebooks, console terminals, and text editors, all within your browser. Among its useful features and polished user interface - compared to that a Jupyter notebook server - Jupyter lab provides moveable panes for viewing data, images, and code output apart from the rest of the notebook. This is facilitates effective data
423+
science work flows.</p>
424+
<p>It is recommended that you peruse the <a class="reference external" href="https://jupyterlab.readthedocs.io/en/stable/getting_started/overview.html">Jupyter lab documentation</a> to get a feel for all of its added capabilities.</p>
425+
<p>The following instructions are laid out for running a Jupyter notebook server. That being said, the process for running a Jupyter lab server and working with notebooks therein is nearly identical. Both Jupyter notebook and Jupyter lab should already be <a class="reference external" href="https://www.pythonlikeyoumeanit.com/Module1_GettingStartedWithPython/Installing_Python.html">installed via Anaconda</a>.</p>
426+
</div>
418427
<div class="section" id="Running-a-Notebook-Server-&amp;-Creating-a-Notebook">
419428
<h2>Running a Notebook Server &amp; Creating a Notebook<a class="headerlink" href="#Running-a-Notebook-Server-&-Creating-a-Notebook" title="Permalink to this headline"></a></h2>
429+
<p>Enough gushing about Jupyter notebooks. Let’s start using them!</p>
420430
<p>In your terminal, navigate to a directory (a.k.a folder) that you are okay creating files in. If you don’t know how to do this, Google it!</p>
421431
<p>Once you are in the desired directory, execute in your terminal (type the following, and then hit <code class="docutils literal notranslate"><span class="pre">&lt;ENTER&gt;</span></code>): <code class="docutils literal notranslate"><span class="pre">jupyter</span> <span class="pre">notebook</span></code></p>
432+
<p>Alternatively, if you want to work in Jupyter lab, run: <code class="docutils literal notranslate"><span class="pre">jupyter</span> <span class="pre">lab</span></code></p>
422433
<p>You should see some text appear in your terminal:</p>
423434
<p><img alt="Starting a jupyter notebook server on your machine" src="../_images/jupyter_login.PNG" /></p>
424435
<p>This is a “notebook server” that is running on your machine - it basically handles all of the communication between your browser and your machine. A new window or tab should open in your web browser, which looks like a file explorer.</p>
@@ -514,7 +525,7 @@ <h2>An Example Notebook<a class="headerlink" href="#An-Example-Notebook" title="
514525
<div class="prompt empty docutils container">
515526
</div>
516527
<div class="output_area docutils container">
517-
<img alt="../_images/Module1_GettingStartedWithPython_Jupyter_Notebooks_9_0.png" src="../_images/Module1_GettingStartedWithPython_Jupyter_Notebooks_9_0.png" />
528+
<img alt="../_images/Module1_GettingStartedWithPython_Jupyter_Notebooks_10_0.png" src="../_images/Module1_GettingStartedWithPython_Jupyter_Notebooks_10_0.png" />
518529
</div>
519530
</div>
520531
<p>Notice that this notebook interface is great for making adjustments to this plot. You can easily change the color or line-style of the plot and redraw it without having to recompute the functions. You simply re-execute the cell containing the plot code. This is especially nice when the numerical computations required to generate the curves are costly.</p>
@@ -562,6 +573,10 @@ <h3>Using Jupyter Notebooks with Other Languages<a class="headerlink" href="#Usi
562573
</ul>
563574
<p>The ever-growing list of available kernels for use with Jupyter can be found <a class="reference external" href="https://github.com/jupyter/jupyter/wiki/Jupyter-kernels">here</a>. It should be noted that these efforts are not all equally mature. For instance, whereas the Python and Julia kernels are robust, the Haskell kernel cannot run natively on Windows machines, and the C++ kernel is still in early development, as of writing this.</p>
564575
</div>
576+
<div class="section" id="Jupyter-Notebook-Support-in-Visual-Studio-Code">
577+
<h3>Jupyter Notebook Support in Visual Studio Code<a class="headerlink" href="#Jupyter-Notebook-Support-in-Visual-Studio-Code" title="Permalink to this headline"></a></h3>
578+
<p>Native Jupyter notebook support was <a class="reference external" href="https://devblogs.microsoft.com/python/announcing-support-for-native-editing-of-jupyter-notebooks-in-vs-code/">recently added to Visual Studio Code</a>. This means that you can now edit Jupyter notebooks within the <a class="reference external" href="https://www.pythonlikeyoumeanit.com/Module1_GettingStartedWithPython/Getting_Started_With_IDEs_and_Notebooks.html">Visual Studio Code IDE</a>, and that you will benefit from added features like code-completion, debugging, and variable inspection.</p>
579+
</div>
565580
</div>
566581
</div>
567582

docs/Module1_GettingStartedWithPython/Numerical_Work_In_Python.html

+1
Original file line numberDiff line numberDiff line change
@@ -97,6 +97,7 @@
9797
<li class="toctree-l1"><a class="reference internal" href="../module_3_problems.html">Module 3: Problems</a></li>
9898
<li class="toctree-l1"><a class="reference internal" href="../module_4.html">Module 4: Object Oriented Programming</a></li>
9999
<li class="toctree-l1"><a class="reference internal" href="../module_5.html">Module 5: Odds and Ends</a></li>
100+
<li class="toctree-l1"><a class="reference internal" href="../changes.html">Changelog</a></li>
100101
</ul>
101102

102103

docs/Module1_GettingStartedWithPython/SiteFormatting.html

+1
Original file line numberDiff line numberDiff line change
@@ -109,6 +109,7 @@
109109
<li class="toctree-l1"><a class="reference internal" href="../module_3_problems.html">Module 3: Problems</a></li>
110110
<li class="toctree-l1"><a class="reference internal" href="../module_4.html">Module 4: Object Oriented Programming</a></li>
111111
<li class="toctree-l1"><a class="reference internal" href="../module_5.html">Module 5: Odds and Ends</a></li>
112+
<li class="toctree-l1"><a class="reference internal" href="../changes.html">Changelog</a></li>
112113
</ul>
113114

114115

docs/Module2_EssentialsOfPython/Basic_Objects.html

+1
Original file line numberDiff line numberDiff line change
@@ -150,6 +150,7 @@
150150
<li class="toctree-l1"><a class="reference internal" href="../module_3_problems.html">Module 3: Problems</a></li>
151151
<li class="toctree-l1"><a class="reference internal" href="../module_4.html">Module 4: Object Oriented Programming</a></li>
152152
<li class="toctree-l1"><a class="reference internal" href="../module_5.html">Module 5: Odds and Ends</a></li>
153+
<li class="toctree-l1"><a class="reference internal" href="../changes.html">Changelog</a></li>
153154
</ul>
154155

155156

docs/Module2_EssentialsOfPython/ConditionalStatements.html

+1
Original file line numberDiff line numberDiff line change
@@ -128,6 +128,7 @@
128128
<li class="toctree-l1"><a class="reference internal" href="../module_3_problems.html">Module 3: Problems</a></li>
129129
<li class="toctree-l1"><a class="reference internal" href="../module_4.html">Module 4: Object Oriented Programming</a></li>
130130
<li class="toctree-l1"><a class="reference internal" href="../module_5.html">Module 5: Odds and Ends</a></li>
131+
<li class="toctree-l1"><a class="reference internal" href="../changes.html">Changelog</a></li>
131132
</ul>
132133

133134

docs/Module2_EssentialsOfPython/DataStructures.html

+1
Original file line numberDiff line numberDiff line change
@@ -125,6 +125,7 @@
125125
<li class="toctree-l1"><a class="reference internal" href="../module_3_problems.html">Module 3: Problems</a></li>
126126
<li class="toctree-l1"><a class="reference internal" href="../module_4.html">Module 4: Object Oriented Programming</a></li>
127127
<li class="toctree-l1"><a class="reference internal" href="../module_5.html">Module 5: Odds and Ends</a></li>
128+
<li class="toctree-l1"><a class="reference internal" href="../changes.html">Changelog</a></li>
128129
</ul>
129130

130131

docs/Module2_EssentialsOfPython/DataStructures_III_Sets_and_More.html

+1
Original file line numberDiff line numberDiff line change
@@ -133,6 +133,7 @@
133133
<li class="toctree-l1"><a class="reference internal" href="../module_3_problems.html">Module 3: Problems</a></li>
134134
<li class="toctree-l1"><a class="reference internal" href="../module_4.html">Module 4: Object Oriented Programming</a></li>
135135
<li class="toctree-l1"><a class="reference internal" href="../module_5.html">Module 5: Odds and Ends</a></li>
136+
<li class="toctree-l1"><a class="reference internal" href="../changes.html">Changelog</a></li>
136137
</ul>
137138

138139

docs/Module2_EssentialsOfPython/DataStructures_II_Dictionaries.html

+1
Original file line numberDiff line numberDiff line change
@@ -134,6 +134,7 @@
134134
<li class="toctree-l1"><a class="reference internal" href="../module_3_problems.html">Module 3: Problems</a></li>
135135
<li class="toctree-l1"><a class="reference internal" href="../module_4.html">Module 4: Object Oriented Programming</a></li>
136136
<li class="toctree-l1"><a class="reference internal" href="../module_5.html">Module 5: Odds and Ends</a></li>
137+
<li class="toctree-l1"><a class="reference internal" href="../changes.html">Changelog</a></li>
137138
</ul>
138139

139140

0 commit comments

Comments
 (0)