Skip to content
Merged
Changes from 1 commit
Commits
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
40 changes: 5 additions & 35 deletions learners/setup.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,12 +11,7 @@
## Install Python

In this lesson, we will be using Python 3 with some of its most popular scientific libraries.
Although one can install a plain-vanilla Python and all required libraries by hand,
we recommend installing [Anaconda][anaconda-website],
a Python distribution that comes with everything we need for the lesson.
Detailed installation instructions for various operating systems can be found
on The Carpentries [template website for workshops][anaconda-instructions]
and in [Anaconda documentation][anaconda-install].
One can install a plain-vanilla Python and all required libraries by hand.

## Obtain lesson materials

Expand All @@ -39,30 +34,7 @@
## Option A: Jupyter Notebook

A Jupyter Notebook provides a browser-based interface for working with Python.
If you installed Anaconda, you can launch a notebook in two ways:

::::::::::::::::: spoiler

## Anaconda Navigator

1. Launch Anaconda Navigator.
It might ask you if you'd like to send anonymized usage information to Anaconda developers:
![](fig/anaconda-navigator-first-launch.png){alt='Anaconda Navigator first launch'}
Make your choice and click "Ok, and don't show again" button.
2. Find the "Notebook" tab and click on the "Launch" button:
![](fig/anaconda-navigator-notebook-launch.png){alt='Anaconda Navigator Notebook launch'}
Anaconda will open a new browser window or tab with a Notebook Dashboard showing you the
contents of your Home (or User) folder.
3. Navigate to the `data` directory by clicking on the directory names leading to it:
`Desktop`, `swc-python`, then `data`:
![](fig/jupyter-notebook-data-directory.png){alt='Anaconda Navigator Notebook directory'}
4. Launch the notebook by clicking on the "New" button and then selecting "Python 3":
![](fig/jupyter-notebook-launch-notebook.png){alt='Anaconda Navigator Notebook directory'}

:::::::::::::::::::::::::


::::::::::::::::: spoiler
You can launch a notebook from the command line:

## Command line (Terminal)

Expand All @@ -79,7 +51,7 @@
cd ~/Desktop/swc-python/data
```

:::::::::::::::::::::::::

Check warning on line 54 in learners/setup.md

View workflow job for this annotation

GitHub Actions / Build markdown source files if valid

check for the corresponding open tag

Check warning on line 54 in learners/setup.md

View workflow job for this annotation

GitHub Actions / Build markdown source files if valid

check for the corresponding open tag

::::::::::::::::: spoiler

Expand All @@ -94,7 +66,7 @@
cd /D %userprofile%\Desktop\swc-python\data
```

:::::::::::::::::::::::::

Check warning on line 69 in learners/setup.md

View workflow job for this annotation

GitHub Actions / Build markdown source files if valid

check for the corresponding open tag

Check warning on line 69 in learners/setup.md

View workflow job for this annotation

GitHub Actions / Build markdown source files if valid

check for the corresponding open tag

2\. Start Jupyter server

Expand All @@ -106,7 +78,7 @@
jupyter notebook
```

:::::::::::::::::::::::::

Check warning on line 81 in learners/setup.md

View workflow job for this annotation

GitHub Actions / Build markdown source files if valid

check for the corresponding open tag

Check warning on line 81 in learners/setup.md

View workflow job for this annotation

GitHub Actions / Build markdown source files if valid

check for the corresponding open tag


::::::::::::::::: spoiler
Expand All @@ -117,13 +89,13 @@
python -m notebook
```

:::::::::::::::::::::::::

Check warning on line 92 in learners/setup.md

View workflow job for this annotation

GitHub Actions / Build markdown source files if valid

check for the corresponding open tag

Check warning on line 92 in learners/setup.md

View workflow job for this annotation

GitHub Actions / Build markdown source files if valid

check for the corresponding open tag

3\. Launch the notebook by clicking on the "New" button on the right and selecting "Python 3"
from the drop-down menu:
![](fig/jupyter-notebook-launch-notebook2.png){alt='Anaconda Navigator Notebook directory'}

:::::::::::::::::::::::::

Check warning on line 98 in learners/setup.md

View workflow job for this annotation

GitHub Actions / Build markdown source files if valid

check for the corresponding open tag

Check warning on line 98 in learners/setup.md

View workflow job for this annotation

GitHub Actions / Build markdown source files if valid

check for the corresponding open tag

  <!-- vertical spacer -->

Expand All @@ -131,8 +103,8 @@

IPython is an alternative solution situated somewhere in between the plain-vanilla Python
interpreter and Jupyter Notebook. It provides an interactive command-line based interpreter with
various convenience features and commands. You should have IPython on your system if you installed
[Anaconda][anaconda-instructions].
various convenience features and commands. You can install IPython on your system
[system](https://ipython.org/install.html).

To start using IPython, execute:

Expand All @@ -156,9 +128,7 @@
winpty python
```

[anaconda-website]: https://www.anaconda.com/
[anaconda-instructions]: https://carpentries.github.io/workshop-template/install_instructions/#python
[anaconda-install]: https://docs.anaconda.com/anaconda/install

[zipfile1]: data/python-novice-inflammation-data.zip
[zipfile2]: ../episodes/files/code/python-novice-inflammation-code.zip
[gitbash]: https://gitforwindows.org
Expand Down
Loading