generated from rstudio/bookdown-demo
-
Notifications
You must be signed in to change notification settings - Fork 1
/
Copy path04-otherwin.Rmd
265 lines (167 loc) · 10.7 KB
/
04-otherwin.Rmd
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
# Windows 10 Home/pre-10 {#otherWin .unnumbered}
This guide covers the installation of Python on machines running Windows 10 Home Edition or versions of Windows prior to Windows 10 (e.g. Windows 7). With this approach, you will install Python "natively", that is running directly on your operating system.
<div class="alert alert-success" style="font-size:120%">
<b>TIP</b>: <br>
If you are unsure what version of Windows you are running, please check out [this guide](#windows-version) first.
</div>
## Installation {#otherWin_install .unnumbered}
This process involves a few steps:
1. [Requirements](#otherwin_reqs): gather everything you will need before getting started
1. [Miniconda Install](miniconda_install): install the programme that will allow you to install Python
1. [GDS Environment](#otherWin_gds): turbo charge your Python installation
1. [Extra addon's](#otherWin_addons): put the final touches on the install
1. [Success check](#otherWin_check): certify everything went smoothly
Make sure you complete each of them successfully before moving on to the next one.
### Requirements {#otherwin_reqs .unlisted .unnumbered}
To complete this installation route successfully, you will need the following:
- A good internet connection
- The `jl_setup.bat` file that you can download on [this link](jl_setup.bat). Right click and "Save Link As" to download it to your computer, as illustrated in the blue box below.
<div class="alert alert-info" style="font-size:120%">
<b>TIP</b>: <br>
To download these files, follow these steps with each:
1. Right-click on the link to each file and select "Save link as"
```{r fig4a, echo=FALSE, fig.align="center"}
knitr::include_graphics("figs/chp4/download_file.png")
```
</div>
- A copy of Miniconda for Windows and Python 3.8. Make sure you check [which architecture of Windows you are running](#windows-arch) before proceeding.
<div class="alert alert-info" style="font-size:120%">
<b>TIP</b>: <br>
To download Miniconda, follow these steps:
1. Head over to the [Download Page](https://docs.conda.io/en/latest/miniconda.html#windows-installers) and select Python 3.8:
```{r mc1, echo=FALSE, fig.align="center"}
knitr::include_graphics("figs/chp4/Picture10.png")
```
2. We are using **Python 3.8**, so depending on which windows version you are using (32-bit or 64-bit), click on the relevant file in the Python 3.8 section (highlighted in red).
3. This will download the Miniconda installation file. Depending on your setup and browser, you will need to select where to place it (the Desktop folder would be a good option) or it will go straight into a default location (e.g. the Downloads folder)
</div>
For the sake of this guide, we will assume you download the `jl_setup.bat` file and the Miniconda installer on the Desktop folder (`C:\Users\username\Desktop`). You do not need to choose this folder but, if you use a different one, please adjust all instructions below accordingly.
### Minicoda Install {#miniconda_install .unlisted .unnumbered}
The next step is to install the copy of Miniconda we just downloaded. To do that, follow these steps:
1. Head over to the folder where you downloaded it (the Desktop in our case)
2. Double click the downloaded file will open an installation window:
```{r inst1, echo=FALSE, fig.align="center"}
knitr::include_graphics("figs/chp4/inst_1.PNG")
```
3. Click **_Next_** on the first step.
4. Click **_I Agree_** to the Terms and Conditions:
```{r Inst2, echo=FALSE, fig.align="center"}
knitr::include_graphics("figs/chp4/inst_2.PNG")
```
5. In the next window, we will select "Just Me" so no administrator rights are required:
```{r Inst_3, echo=FALSE, fig.align="center"}
knitr::include_graphics("figs/chp4/inst_3.PNG")
```
6. The next window will ask you where to install Miniconda. Unless you know what you are doing, leave the path (highlighted in blue) as is and click next:
```{r Inst4, echo=FALSE, fig.align="center"}
knitr::include_graphics("figs/chp4/inst_4.PNG")
```
7. The next window can be used for an advanced setup. Unless you know what you are doing, leave the default settings as they are (ie. box ticked at _Register Miniconda3 as my default Python 3.8_).
```{r Inst_5, echo=FALSE, fig.align="center"}
knitr::include_graphics("figs/chp4/inst_5.PNG")
```
7. Click **_Install_** and the installation process will begin:
```{r Inst6, echo=FALSE, fig.align="center"}
knitr::include_graphics("figs/chp4/inst_6.PNG")
```
8. Once the installation is complete, click **_Next_**.
9. Untick all boxes in the window (unless you want further information on Miniconda, which will open in your browser) and click **_Finish_**:
```{r Inst7, echo=FALSE, fig.align="center"}
knitr::include_graphics("figs/chp4/inst_7.PNG")
```
### Install GDS Environment {#otherWin_gds .unlisted .unnumbered}
Once we have Miniconda ready to go, the next step is to install what we will call the GDS environment. This is a set of software packages that will allow us to do very cool stuff with Python and geographic data. This is the step that will install _most_ of what you will need and hence also the longest one. Let's get started!
1. Head to the Windows icon on the bottom left of your screen and type **_Anaconda_**:
```{r fig20, echo=FALSE, fig.align="center"}
knitr::include_graphics("figs/chp4/Picture20.png")
```
2. Now click on **_Anaconda Prompt (miniconda3)_** (from now on we will refer to this as the **Anaconda Prompt**)
```{r fig21, echo=FALSE, fig.align="center"}
knitr::include_graphics("figs/chp4/Picture21.png")
```
3. This will launch a window that looks, more or less, like this:
```{r Conda1, echo=FALSE, fig.align="center"}
knitr::include_graphics("figs/chp4/Conda_1.PNG")
```
4. Now we need to "navigate" to the folder where you placed the `jl_setup.bat`file. In this illustration, we are using the Desktop folder, so you can run the following command:
```shell
cd Desktop
```
Note that you can move to a given folder by using the command `cd myFolder` to move forward through folders, and `cd ..` to move backwards. Once you have typed the command, press _Enter_.
5. Once you have navigated to the location of your files (e.g. _Desktop_), run the following command in the Anaconda Prompt, and press enter to execute it:
```shell
conda-env create -f https://github.com/darribas/gds_env/raw/v6.1/gds_py/gds_py.yml
```
<div class="alert alert-info" style="font-size:120%">
<b>TIP</b>: <br>
This step will take a while, depending on the speed of your connection but no less than 15-20 minutes. Grab a *cuppa* and be patient!
</div>
6. If everything has gone according to plan, your Anaconda Prompt should look a bit like this:
```{r Conda7, echo=FALSE, fig.align="center"}
knitr::include_graphics("figs/chp4/Conda_7.PNG")
```
This has created correctly the `gds` environment, congratulations! We are _almost_ there.
7. Now we need to _activate_ the environment. For this, run the following command:
```shell
conda activate gds
```
### Complete environment Setup {#otherWin_addons .unlisted .unnumbered}
The final step involves installing a few addon's that will make interacting with data a lot smoother and fun. Let's get to it!
1. Ensure you have the `gds` environment activated. You will be able to check this by looking at the name that appears in parenthesis in the beginning of the last line of the Anaconda Prompt. If yours reads `base`, activate the `gds` environment by running:
```shell
conda activate gds
```
You can see that the start of the line has changed from **(base)** to **(gds)**.
2. On this very Anaconda Prompt window, let's run the `jl_setup.bat` script. For this type the following:
```shell
jl_setup.bat
```
And hit enter. Your Anaconda Prompt should display a series of commands that looks, more or less, as follows:
```{r Conda9, echo=FALSE, fig.align="center"}
knitr::include_graphics("figs/chp4/Conda_9.PNG")
```
<div class="alert alert-info" style="font-size:120%">
<b>TIP</b>: <br>
This step requires that `jl_setup.bat` exists in the same folder `C:\Users\username\Downloads` and will also take a while, depending on the speed of your connection but no less than 10-15 minutes. Be patient, we're almost there!
</div>
When this completes, you are all set to go, congratulations!!!
**NOTE:** Do not close the Anaconda prompt yet as we will need it again in the next section, to check everything is alright.
### Check Installation {#otherWin_check .unlisted .unnumbered}
To make sure that your installation was successful and all packages have been installed we need to run one more thing. Here're the steps to follow:
1. Download the [**check_py_stack.ipynb**](https://raw.githubusercontent.com/darribas/gds_env/master/gds_py/check_py_stack.ipynb) file by right clicking on it and selecting **_Save link as_**. Make sure to use the same folder we have been using so far.
2. From the same Anaconda Prompt as above, with the environment activated (you'll know that is the case if `(gds)` is at the top of the line in the command prompt), run:
```shell
jupyter nbconvert --to html --execute check_py_stack.ipynb
```
This will take a little bit and, if it succeeds, it will produce a file called `check_py_stack.html` that you can open in your browser to inspect. If there are no errors and every cell has been run correctly, your resulting file should look like [this one](check_py_stack.html). If the two look the same, you are all set!!!
## Running Python {#otherWin_run .unnumbered}
Now that you have successfully installed Python on your computer, you are ready to go! Now every time you want to launch the app, called Jupyter Lab, you will need to follow these steps:
1. Start by opening an Anaconda Prompt (remember: "Start Menu" --> "Anaconda Prompt (miniconda3)").
2. Navigate to the folder that you want to work in using the `cd` command (for example, your home directory: `C:\Users\username`).
3. Activate the GDS environment by running:
```shell
conda activate gds
```
4. Launch Jupyter lab by running the following command:
```shell
jupyter lab
```
This will launch Jupyter Lab in your default browser.
<div class="alert alert-info" style="font-size:120%">
<b>TIP</b>: <br>
It is recommended to use Firefox or Chrome.
If your default browser is neither of the recommended, you can:
1. Close the window that opens automatically
2. Open Firefox/Chrome and paste the URL from the Anaconda Prompt:
```{r Pciture24, echo=FALSE, fig.align="center"}
knitr::include_graphics("figs/chp4/Conda_13.PNG")
```
</div>
You should now be looking at an interface that looks very similar to this:
```{r Lab, echo=FALSE, fig.align="center"}
knitr::include_graphics("figs/chp4/jupyter_lab.png")
```
If that is the case, CONGRATULATIONS!!! You are ready to go and start hacking away!!!
<center>
<center>