Skip to content

Commit fca87d6

Browse files
committed
polish the episode
1 parent 8bffe03 commit fca87d6

File tree

1 file changed

+32
-55
lines changed

1 file changed

+32
-55
lines changed

_episodes/02-installation.md

Lines changed: 32 additions & 55 deletions
Original file line numberDiff line numberDiff line change
@@ -22,64 +22,54 @@ be found in the
2222
We will first install Conda, and then ESMValTool. We end this chapter by testing
2323
that the installation was successful.
2424

25-
## Install Conda
25+
## Install ESMValTool on Windows
2626

27-
ESMValTool is distributed using [Conda](https://conda.io/). We will be using the
28-
Miniconda minimal installer for conda. We suggest a Python 3 based installer,
29-
though if you happen to already have Conda installed it should also work with
30-
Python 2. For more information about installing conda, see [the conda
31-
installation
32-
documentation](https://docs.conda.io/projects/conda/en/latest/user-guide/install/index.html).
27+
ESMValTool does not directly support Windows, but succesful usage has been
28+
reported through the [Windows Subsystem for
29+
Linux(WSL)](https://docs.microsoft.com/en-us/windows/wsl/), available in Windows
30+
10.
3331

34-
### Linux
32+
To install the WSL please follow the instructions [on the Windows Documentation
33+
page](https://docs.microsoft.com/en-us/windows/wsl/install-win10).
3534

36-
1. Please download Miniconda3 by running:
35+
After installing the WSL, installation can be done using the same instructions for Linux/MacOSX.
3736

38-
```bash
39-
wget https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-x86_64.sh
40-
```
37+
## Install ESMValTool on Linux/MacOSX
4138

42-
It is also possible to download Miniconda3 for Linux on the [miniconda page](https://docs.conda.io/en/latest/miniconda.html). If you have problems with the 64 bit version in the next step(s) you can alternatively try a 32 bit version.
39+
### Install Conda
4340

44-
2. Next, run the installer from the place where you downloaded it
41+
ESMValTool is distributed using [Conda](https://conda.io/).
42+
Let's check if we already have Conda installed by running:
4543

46-
```bash
47-
bash Miniconda3-latest-Linux-x86_64.sh
48-
```
44+
```bash
45+
conda list
46+
```
4947

50-
3. Follow the instructions in the installer. The defaults should normally
51-
suffice.
48+
If conda is installed, we will see a list of packages.
49+
We recommend updating conda before esmvaltool installation. To do so, run:
5250

53-
4. You will need to restart your terminal for the changes to have effect.
51+
```bash
52+
conda update
53+
```
5454

55-
5. Verify you have a working conda installation by listing all installed
56-
packages
55+
If conda is **not** installed, We can use Miniconda minimal installer for conda.
56+
We recommend a Python 3 based installer. For more information about installing conda,
57+
see [the conda installation documentation](https://docs.conda.io/projects/conda/en/latest/user-guide/install/index.html).
5758

58-
```bash
59-
conda list
60-
```
59+
To install conda on ``Linux`` or ``MacOSX``, follow the instructions below:
6160

62-
Should output something like
61+
1. Please download Miniconda3 by running:
6362

63+
```bash
64+
wget https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-x86_64.sh
6465
```
65-
# packages in environment at ~/miniconda3:
66-
#
67-
# Name Version Build Channel
68-
...
69-
conda 4.8.3 py37_0
70-
...
71-
```
72-
{: .output}
7366

74-
### MacOSX
75-
76-
1. Please download Miniconda3 for MacOSX at [the miniconda
77-
page](https://docs.conda.io/en/latest/miniconda.html).
67+
If you have problems with the 64 bit version in the next step(s) you can alternatively try a 32 bit version.
7868

7969
2. Next, run the installer from the place where you downloaded it
8070

8171
```bash
82-
bash Miniconda3-latest-MacOSX-x86_64.sh
72+
bash Miniconda3-latest-Linux-x86_64.sh
8373
```
8474

8575
3. Follow the instructions in the installer. The defaults should normally
@@ -107,20 +97,7 @@ It is also possible to download Miniconda3 for Linux on the [miniconda page](htt
10797
{: .output}
10898

10999

110-
### Windows
111-
112-
ESMValTool does not directly support Windows, but succesful usage has been
113-
reported through the [Windows Subsystem for
114-
Linux(WSL)](https://docs.microsoft.com/en-us/windows/wsl/), available in Windows
115-
10.
116-
117-
To install the WSL please follow the instructions [on the Windows Documentation
118-
page](https://docs.microsoft.com/en-us/windows/wsl/install-win10).
119-
120-
After installing the WSL, installation can be done using the Linux installation
121-
instructions.
122-
123-
## Install Julia
100+
### Install Julia
124101

125102
Some ESMValTool diagnostics are written in the Julia programming language.
126103
If you want a full installation of ESMValTool including Julia diagnostics, you need
@@ -195,7 +172,7 @@ installation page](https://julialang.org/downloads/platform/#linux_and_freebsd).
195172
> to start the interactive Julia interpreter. Press `Ctrl+D` to exit.
196173
{: .solution}
197174
198-
## Install the ESMValTool package
175+
### Install the ESMValTool package
199176
200177
The ESMValTool package contains diagnostics scripts in four languages: R,
201178
Python, Julia and NCL. This introduces a lot of dependencies, and therefore the
@@ -239,7 +216,7 @@ installed in it.
239216
>
240217
{: .callout}
241218
242-
## Test that the installation was successful
219+
### Test that the installation was successful
243220
244221
To test that the installation was successful, run
245222

0 commit comments

Comments
 (0)