setup.md

title	Setup

{% comment %} Start of 'Python' section. Remove the third paragraph if the workshop will teach Python using something other than the Jupyter notebook. Details at https://jupyter-notebook.readthedocs.io/en/stable/notebook.html#browser-compatibility {% endcomment %}

Python

In this lesson, we will use Python with the Numpy and Numba libaries, and we will interact with Python via the Jupyter notebook interface, a programming environment that runs in a web browser. You can install each of these by hand, but we would recommend that you download Anaconda, an all-in-one installer including all these prerequisites.

Regardless of how you choose to install it, please make sure you install Python version 3.x (e.g., 3.6 is fine).

For the Jupyter Notebook to work you will need a reasonably up-to-date browser. The current versions of the Chrome, Safari and Firefox browsers are all supported (some older browsers, including Internet Explorer version 9 and below, are not).

• Windows
• MacOS
• Linux

<div class="tab-content">
  <article role="tabpanel" class="tab-pane active" id="python-windows">
    <a href="https://www.youtube.com/watch?v=xxQ0mzZ8UvA">Video Tutorial</a>
    <ol>
      <li>Open <a href="https://www.anaconda.com/download/#windows">https://www.anaconda.com/download/#windows</a> with your web browser.</li>
      <li>Download the Python 3 installer for Windows.</li>
      <li>Install Python 3 using all of the defaults for installation <em>except</em> make sure to check <strong>Add Anaconda to my PATH environment variable</strong>.</li>
    </ol>
  </article>
  <article role="tabpanel" class="tab-pane active" id="python-macos">
    <a href="https://www.youtube.com/watch?v=TcSAln46u9U">Video Tutorial</a>
    <ol>
      <li>Open <a href="https://www.anaconda.com/download/#macos">https://www.anaconda.com/download/#macos</a> with your web browser.</li>
      <li>Download the Python 3 installer for OS X.</li>
      <li>Install Python 3 using all of the defaults for installation.</li>
    </ol>
  </article>
  <article role="tabpanel" class="tab-pane active" id="python-linux">
    <ol>
      <li>Open <a href="https://www.anaconda.com/download/#linux">https://www.anaconda.com/download/#linux</a> with your web browser.</li>
      <li>Download the Python 3 installer 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.
      </li>
      <li>
        Type <pre>bash Anaconda3-</pre> and then press
        <kbd>Tab</kbd>. The name of the file you just downloaded should
        appear. If it does not, navigate to the folder where you
        downloaded the file, for example with:
        <pre>cd Downloads</pre>
        Then, try again.
      </li>
      <li>
        Press <kbd>Return</kbd>. 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 enter to approve the
        default location for the files. Type <code>yes</code> and
        press enter to prepend Anaconda to your <code>PATH</code>
        (this makes the Anaconda distribution the default Python).
      </li>
      <li>
        Close the terminal window.
      </li>
    </ol>
  </article>
</div>

{% comment %}

Once you are done installing the software listed above, please go to this page, which has instructions on how to test that everything was installed correctly.

{% endcomment %}

{% comment %} End of 'Python' section. {% endcomment %}

{% include links.md %}