Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

WIP: Replace anaconda installation with vanilla Python and pip #837

Draft
wants to merge 1 commit into
base: gh-pages
Choose a base branch
from
Draft

WIP: Replace anaconda installation with vanilla Python and pip #837

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
95 changes: 51 additions & 44 deletions _includes/install_instructions/python.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -11,10 +11,9 @@ <h3>Python</h3>
<p>
<a href="https://python.org">Python</a> is a popular language for
research computing, and great for general-purpose programming as
well. Installing all of its research packages individually can be
a bit difficult, so we recommend
<a href="https://www.anaconda.com/download/success">Anaconda</a>,
an all-in-one installer.
well. We'll be using some standard tools to first install Python
and then the packages required for this workshop using
<a href="https://pip.pypa.io/en/stable/installation/">pip</a>.
</p>

<p>
Expand All @@ -29,8 +28,8 @@ <h3>Python</h3>
if you do not plan to use Jupyter Notebook environment.
{% endcomment %}
<p>
We will teach Python using the <a href="https://jupyter.org/">Jupyter Notebook</a>,
a programming environment that runs in a web browser (Jupyter Notebook will be installed by Anaconda). For this to work you will need a reasonably
We will teach Python using the <a href="https://jupyter.org/">Jupyter Lab notebooks</a>,
a programming environment that runs in a web browser (Jupyter Lab will be installed by pip). 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="https://jupyter-notebook.readthedocs.io/en/stable/notebook.html#browser-compatibility">supported</a>
Expand All @@ -48,9 +47,23 @@ <h3>Python</h3>
<div class="tab-content">
<article role="tabpanel" class="tab-pane active" id="python-windows">
<ol>
<li>Open <a href="https://www.anaconda.com/download/success">https://www.anaconda.com/download/success</a> with your web browser.</li>
<li>Download the Anaconda for Windows installer with Python 3. (If you are not sure which version to choose, you probably want the 64-bit Graphical Installer <em>Anaconda3-...-Windows-x86_64.exe</em>)</li>
<li>Install Python 3 by running the Anaconda Installer, using all of the defaults for installation <em>except</em> make sure to check <strong>Add Anaconda to my PATH environment variable</strong>.</li>
<li>Open <a href="https://www.python.org/downloads/">https://www.python.org/downloads/</a> with your web browser.</li>
<li>Click on <kbd>Download Python 3.x.y</kbd> under "Download the latest version for Windows" near the top.</li>
<li>Click on the downloaded installer and run it.</li>
<li>You'll see a popup window from the installer. Check the "Add python.exe to PATH" box near the bottom
and then click <kbd>Install Now</kbd>.</li>
<li>To confirm that it's installed, open git-bash (installed per the instructions above)
and type <kbd>python --version</kbd>. This should print something like:"Python 3.12.5".</li>
<li>Next we'll install Jupyter Lab and the various Python packages we'll be using.
These will all be installed in a Python "Virtual Environment" (venv). Type these commands in the git-bash shell:
<pre>
cd ~/Desktop
python -m venv venv
source venv/Scripts/activate
pip install jupyterlab ipywidgets pandas matplotlib
</pre>
That last step will take a while and will print a lot of progress output showing the packages being installed.
</li>
</ol>
<h4>Video Tutorial</h4>
<div class="yt-wrapper2">
Expand All @@ -61,10 +74,23 @@ <h4>Video Tutorial</h4>
</article>
<article role="tabpanel" class="tab-pane" id="python-macos">
<ol>
<li>Open <a href="https://www.anaconda.com/download/success">https://www.anaconda.com/download/success</a> with your web browser.</li>
<li>Download the Anaconda Installer with Python 3 for macOS (you can either use the Graphical or the Command Line Installer).</li>
<li>Install Python 3 by running the Anaconda Installer using all of the defaults for installation.</li>
<li>Open <a href="https://www.python.org/downloads/">https://www.python.org/downloads/</a> with your web browser.</li>
<li>Click on <kbd>Download Python 3.x.y</kbd> under "Download the latest version for macOS" near the top.</li>
<li>Click on the downloaded installer and run it, responding to the license agreement prompt, and so on.</li>
<li>To confirm that it's installed, open Terminal
and type <kbd>python --version</kbd>. This should print something like:"Python 3.12.5".</li>
<li>Next we'll install Jupyter Lab and the various Python packages we'll be using.
These will all be installed in a Python "Virtual Environment" (venv). Type these commands in the git-bash shell:
<pre>
cd ~/Desktop
python -m venv venv
source venv/bin/activate
pip install jupyterlab ipywidgets pandas matplotlib
</pre>
That last step will take a while and will print a lot of progress output showing the packages being installed.
</li>
</ol>

<h4>Video Tutorial</h4>
<div class="yt-wrapper2">
<div class="yt-wrapper">
Expand All @@ -73,39 +99,20 @@ <h4>Video Tutorial</h4>
</div>
</article>
<article role="tabpanel" class="tab-pane" id="python-linux">
Python is usually already installed on most Linux distributions.
<ol>
<li>Open <a href="https://www.anaconda.com/download/success">https://www.anaconda.com/download/success</a> with your web browser.</li>
<li>Download the Anaconda Installer with Python 3 for Linux.<br>
(The installation requires using the shell. If you aren't
comfortable doing the installation yourself
stop here and request help at the workshop.)
</li>
<li>
Open a terminal window and navigate to the directory where
the executable is downloaded (e.g., `cd ~/Downloads`).
</li>
<li>
Type <pre>bash Anaconda3-</pre> and then press
<kbd>Tab</kbd> to autocomplete the full file name. The name of
file you just downloaded should appear.
</li>
<li>
Press <kbd>Enter</kbd>
(or <kbd>Return</kbd> depending on your keyboard).
You will follow the text-only prompts.
To move through the text, press <kbd>Spacebar</kbd>.
Type <code>yes</code> and press enter to approve the license.
Press <kbd>Enter</kbd> (or <kbd>Return</kbd>)
to approve the default location
for the files.
Type <code>yes</code> and press
<kbd>Enter</kbd> (or <kbd>Return</kbd>)
to prepend Anaconda to your <code>PATH</code>
(this makes the Anaconda distribution the default Python).
</li>
<li>
Close the terminal window.
</li>
<li>To confirm that it's installed, open a terminal
and type <kbd>python3 --version</kbd>. This should print something like:"Python 3.12.5".</li>
<li>Next we'll install Jupyter Lab and the various Python packages we'll be using.
These will all be installed in a Python "Virtual Environment" (venv). Type these commands in the git-bash shell:
<pre>
cd
python3 -m venv venv
source venv/bin/activate
pip install jupyterlab ipywidgets pandas matplotlib
</pre>
That last step will take a while and will print a lot of progress output showing the packages being installed.
</li>
</ol>
</article>
</div>
Expand Down