|
4 | 4 |
|
5 | 5 | ### Python and Jupyter Notebooks |
6 | 6 |
|
7 | | -- [Python](https://python.org) is a popular language for |
8 | | - scientific computing, and great for general-purpose programming as |
9 | | - well. For this workshop we use Python version 3.x. |
10 | | - Installing all of its scientific packages individually can be |
11 | | - a bit difficult, so we recommend an all-in-one installer. |
12 | | - We will use Anaconda or Miniconda. |
13 | | - They both use [Conda](https://conda.io/en/latest/), the main difference is |
14 | | - that Anaconda comes with a lot of packages pre-installed. |
15 | | - With Miniconda you will need to install the required packages. |
16 | | - We recommend using the Anaconda installation instructions. |
17 | | - |
18 | | -:::::::::::::::: spoiler |
19 | | - |
20 | | -## Anaconda installation |
21 | | - |
22 | | -Download and install [Anaconda](https://www.anaconda.com/distribution/#download-section). |
23 | | -Remember to choose the installer for Python 3.x. |
24 | | -Anaconda does not include the plotting package plotnine. To install this package, open your terminal application and |
25 | | -type: |
| 7 | +[Python](https://python.org) is a popular language for scientific computing, and great for general-purpose programming as well. |
| 8 | +For this workshop we use Python version 3.x. |
| 9 | +Installing all of its scientific packages individually can be a bit difficult, so we provide an environment file to help you take care of them all together. |
| 10 | +We will use the _Miniforge_ distribution of Python. |
26 | 11 |
|
27 | | -```bash |
28 | | -conda install -c conda-forge plotnine |
29 | | -``` |
30 | | - |
31 | | -::::::::::::::::::::::::: |
32 | | - |
33 | | -:::::::::::::::: spoiler |
| 12 | +Please refer to the [Python section of the workshop website for installation instructions](https://carpentries.github.io/workshop-template/install_instructions/#python). |
34 | 13 |
|
35 | | -## Miniconda installation |
| 14 | +#### Launching Jupyter |
36 | 15 |
|
37 | | -Miniconda is a "light" version of Anaconda. If you install and use Miniconda |
38 | | -you will also need to install the workshop packages. |
| 16 | +:::::::::::::::::::::::::::::::::::::::::: spoiler |
39 | 17 |
|
40 | | -Download and install [Miniconda](https://docs.conda.io/en/latest/miniconda.html) |
41 | | -following the instructions. Remember to choose the installer for |
42 | | -Python 3.x. |
| 18 | +##### Windows |
43 | 19 |
|
44 | | -From your terminal application, type: |
| 20 | +After following the instructions above, search for the application 'Miniforge Prompt' and open it. |
| 21 | +Type the following commands, pressing <kbd>Enter</kbd> after each one: |
45 | 22 |
|
46 | 23 | ```bash |
47 | | -conda list |
| 24 | +conda activate carpentries |
| 25 | +jupyter notebook |
48 | 26 | ``` |
49 | 27 |
|
50 | | -To install the packages we'll be using in the workshop, type: |
| 28 | +:::::::::::::::::::::::::::::::::::::::::::::::::: |
| 29 | + |
| 30 | +:::::::::::::::::::::::::::::::::::::::::: spoiler |
| 31 | + |
| 32 | +##### MacOS |
| 33 | + |
| 34 | +After following the instructions above, open the Terminal application (inside Applications/Utilities). |
| 35 | +Type the following commands, pressing <kbd>Enter</kbd> after each one: |
51 | 36 |
|
52 | 37 | ```bash |
53 | | -conda install -y numpy pandas matplotlib jupyter |
54 | | -conda install -c conda-forge plotnine |
| 38 | +conda activate carpentries |
| 39 | +jupyter notebook |
55 | 40 | ``` |
| 41 | +:::::::::::::::::::::::::::::::::::::::::::::::::: |
| 42 | + |
| 43 | +:::::::::::::::::::::::::::::::::::::::::: spoiler |
56 | 44 |
|
57 | | -::::::::::::::::::::::::: |
| 45 | +##### Linux |
58 | 46 |
|
59 | | -After installing either Anaconda or Miniconda and the workshop packages, |
60 | | -launch a Jupyter notebook by typing this command from the terminal: |
| 47 | +After following the instructions above, search for the application 'Miniforge Prompt' and open it. |
| 48 | +Type the following commands, pressing <kbd>Enter</kbd> after each one: |
61 | 49 |
|
62 | 50 | ```bash |
| 51 | +conda activate carpentries |
63 | 52 | jupyter notebook |
64 | 53 | ``` |
65 | 54 |
|
66 | | -The notebook should open automatically in your browser. If it does not or you |
67 | | -wish to use a different browser, open this link: [http://localhost:8888](https://localhost:8888). |
68 | | - |
69 | | -For a brief introduction to Jupyter Notebooks, please consult our |
70 | | -[Introduction to Jupyter Notebooks](https://datacarpentry.org/python-ecology-lesson/jupyter_notebooks) page. |
| 55 | +:::::::::::::::::::::::::::::::::::::::::::::::::: |
71 | 56 |
|
| 57 | +The notebook should open automatically in your browser. |
| 58 | +If it does not or you wish to use a different browser, open this link: [http://localhost:8888](https://localhost:8888). |
72 | 59 |
|
| 60 | +For a brief introduction to Jupyter Notebooks, please consult our |
| 61 | +[Introduction to Jupyter Notebooks](https://datacarpentry.org/python-ecology-lesson/jupyter_notebooks/) page. |
0 commit comments