Skip to content

Commit

Permalink
Merge pull request #228 from UBC-MDS/win-miniforge
Browse files Browse the repository at this point in the history
Win miniforge
  • Loading branch information
andytai7 authored Aug 22, 2024
2 parents 1a9cf4a + 9904aff commit c39d15a
Show file tree
Hide file tree
Showing 5 changed files with 89 additions and 68 deletions.
Binary file modified resources_pages/imgs/gitbash-terminal-profile.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified resources_pages/imgs/vscode-as-git-editor.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
40 changes: 20 additions & 20 deletions resources_pages/install_ds_stack_mac.md
Original file line number Diff line number Diff line change
Expand Up @@ -50,9 +50,9 @@ or a 32-bit (also called x86) version of the application **always** choose the 6

> **Important**
> Mac computers are transitioning from
> Intel processors to [Apple silicon](https://support.apple.com/en-us/HT211814).
> Intel processors to [Apple silicon](https://support.apple.com/en-us/HT211814).
> If you have a new laptop (Mac M1 or Mac M2)
> for some software
> for some software
> you will have to use a different installer
> than Macs with Intel processors.
Expand All @@ -61,7 +61,7 @@ make sure to follow the post-installation notes at the end
to check that all software is setup correctly.

## UBC Student Email
Please sign up for a UBC Student Email. This account will also grant you access to a range of UBC services, including Microsoft Teams and OneDrive. To do so navigate to [https://it.ubc.ca/services/email-voice-internet/ubc-student-email-service](https://it.ubc.ca/services/email-voice-internet/ubc-student-email-service) and follow the instructions under "Get Started".
Please sign up for a UBC Student Email. This account will also grant you access to a range of UBC services, including Microsoft Teams and OneDrive. To do so navigate to [https://it.ubc.ca/services/email-voice-internet/ubc-student-email-service](https://it.ubc.ca/services/email-voice-internet/ubc-student-email-service) and follow the instructions under "Get Started".

## Web browser

Expand Down Expand Up @@ -106,7 +106,7 @@ You will have to quit all instances of open Terminals and then **restart** the T

### Installing

The open-source text editor Visual Studio Code (VS Code) is both a powerful text editor and a full-blown Python IDE, which we will use for more complex analysis. You can download and install the macOS version of VS Code from the VS code website [https://code.visualstudio.com/download](https://code.visualstudio.com/download).
The open-source text editor Visual Studio Code (VS Code) is both a powerful text editor and a full-blown Python IDE, which we will use for more complex analysis. You can download and install the macOS version of VS Code from the VS code website [https://code.visualstudio.com/download](https://code.visualstudio.com/download).

Pay attention here if you have to download the "Intel Chip" or "Apple silicon" installer.

Expand Down Expand Up @@ -244,15 +244,15 @@ who might open up this file a few months from now =)

### Python and Conda

We will be using Python for a large part of the program, and `conda` as our Python package manager. To install Python and the `conda` package manager, we will use the [Miniforge platform (read more here)](https://github.com/conda-forge/miniforge).
We will be using Python for a large part of the program, and `conda` as our Python package manager. To install Python and the `conda` package manager, we will use the [Miniforge platform (read more here)](https://github.com/conda-forge/miniforge).

Select the appropiate link:
Select the appropriate link:

You can find the Mac ARM and Intel download links here: <https://conda-forge.org/miniforge/>.
Make sure you use the `Miniforge3` installers, not the other ones listed.
We will assume you downloaded the file into your `Downloads` folder.

Once downlaoded, open up a terminal and run the following command
Once downloaded, open up a terminal and run the following command

```bash
bash Miniforge3.sh -b -p "${HOME}/miniforge3"
Expand Down Expand Up @@ -300,7 +300,7 @@ which is good for stability,
but also means that new versions will be delayed and fewer packages are available overall.
There is a community-driven effort called the [conda-forge (read more here)](https://conda-forge.org/),
which provides more up to date packages.
Conda forge is already set up when we installed Miniforge3
Conda-forge is already set up when we installed Miniforge3

To install packages individually,
we can now use the following command:
Expand All @@ -326,7 +326,7 @@ The spellchecker helps us correcting typos in our writing.
Install them via the following commands:

```bash
conda install pandas jupyterlab jupyterlab-git jupyterlab-spellchecker
conda install pandas jupyterlab jupyterlab-git jupyterlab-spellchecker
```

We will grade part of your assignments in MDS using the Otter-Grader package. For your Jupyter-based assignments, you need to install Otter-Grader using the following command:
Expand Down Expand Up @@ -382,13 +382,13 @@ Some R packages rely on the dependency XQuartz which no longer ships with the Ma

### RStudio

Download the macOS Desktop version (not Pro) of RStudio [https://posit.co/download/rstudio-desktop/](https://posit.co/download/rstudio-desktop/). Open the file and follow the installer instructions.
Download the macOS Desktop version (not Pro) of RStudio [https://posit.co/download/rstudio-desktop/](https://posit.co/download/rstudio-desktop/). Open the file and follow the installer instructions.

To see if you were successful, try opening RStudio by clicking on its icon (from Finder, Applications or Launchpad). It should open and look something like this picture below:

![](/resources_pages/imgs/RStudio.png)

Now we are going to change RStudio’s *Insert Pipe* shortcut so that it inserts the [new native pipe operator `|>`](https://blog.rstudio.com/2021/06/09/rstudio-v1-4-update-whats-new/).
Now we are going to change RStudio’s *Insert Pipe* shortcut so that it inserts the [new native pipe operator `|>`](https://blog.rstudio.com/2021/06/09/rstudio-v1-4-update-whats-new/).
Go to `Tools > Global Options > Code > Editing` and tick the following option:

![](/resources_pages/imgs/new-pipe-rstudio.png)
Expand Down Expand Up @@ -434,12 +434,12 @@ Here's a snippet of the output you should see:

```
SAMPLING FOR MODEL '16a540c6086086816528e4524def24d9' NOW (CHAIN 4).
Chain 4:
Chain 4:
Chain 4: Gradient evaluation took 2e-06 seconds
Chain 4: 1000 transitions using 10 leapfrog steps per transition would take 0.02 seconds.
Chain 4: Adjust your expectations accordingly!
Chain 4:
Chain 4:
Chain 4:
Chain 4:
Chain 4: Iteration: 1 / 2000 [ 0%] (Warmup)
Chain 4: Iteration: 200 / 2000 [ 10%] (Warmup)
Chain 4: Iteration: 400 / 2000 [ 20%] (Warmup)
Expand All @@ -452,11 +452,11 @@ Chain 4: Iteration: 1400 / 2000 [ 70%] (Sampling)
Chain 4: Iteration: 1600 / 2000 [ 80%] (Sampling)
Chain 4: Iteration: 1800 / 2000 [ 90%] (Sampling)
Chain 4: Iteration: 2000 / 2000 [100%] (Sampling)
Chain 4:
Chain 4:
Chain 4: Elapsed Time: 0.003828 seconds (Warm-up)
Chain 4: 0.003417 seconds (Sampling)
Chain 4: 0.007245 seconds (Total)
Chain 4:
Chain 4:
```


Expand Down Expand Up @@ -497,12 +497,12 @@ You will see two panels,
the right-most panel allows you to perform advanced modification
of keyboards shortcuts in JupyterLab
and it already contains quite a few shortcuts.
Please do not delete any of these shortcuts.
Please do not delete any of these shortcuts.
We're going to add two more shortcuts,
by pasting a text snippet just before the first existing shortcut.
Go ahead and create a new line just after the line that says `"shortcuts": [`
and paste the following:


```json
{
Expand Down Expand Up @@ -549,7 +549,7 @@ but this is all that is required for MDS.

## Quarto CLI

Quarto is an open-source scientific and technical publishing system that you can access from VSCode, Jupyter Lab, RStudio, or the terminal.
Quarto is an open-source scientific and technical publishing system that you can access from VSCode, Jupyter Lab, RStudio, or the terminal.

The [RStudio version that you have downloaded](https://quarto.org/docs/tools/rstudio.html) is already equipped with the last version of Quarto. You can check this by opening a new document in `File -> New File -> Quarto Document`.

Expand Down Expand Up @@ -687,7 +687,7 @@ you should see something like this if you were successful:
```
Unable to find image 'hello-world:latest' locally
latest: Pulling from library/hello-world
1b930d010525: Pull complete
1b930d010525: Pull complete
Digest: sha256:451ce787d12369c5df2a32c85e5a03d52cbcef6eb3586dd03075f3034f10adcd
Status: Downloaded newer image for hello-world:latest
Expand Down
38 changes: 19 additions & 19 deletions resources_pages/install_ds_stack_ubuntu.md
Original file line number Diff line number Diff line change
Expand Up @@ -199,15 +199,15 @@ git config --global core.editor "code --wait"

### Python and Conda

We will be using Python for a large part of the program, and `conda` as our Python package manager. To install Python and the `conda` package manager, we will use the [Miniforge platform (read more here)](https://github.com/conda-forge/miniforge).
We will be using Python for a large part of the program, and `conda` as our Python package manager. To install Python and the `conda` package manager, we will use the [Miniforge platform (read more here)](https://github.com/conda-forge/miniforge).

Select the appropiate link:
Select the appropriate link:

You can find the Mac ARM and Intel download links here: <https://conda-forge.org/miniforge/>.
Make sure you use the `Miniforge3` installers, not the other ones listed.
We will assume you downloaded the file into your `Downloads` folder.

Once downlaoded, open up a terminal and run the following command
Once downloaded, open up a terminal and run the following command

```bash
bash Miniforge3.sh -b -p "${HOME}/miniforge3"
Expand Down Expand Up @@ -255,7 +255,7 @@ which is good for stability,
but also means that new versions will be delayed and fewer packages are available overall.
There is a community-driven effort called the [conda-forge (read more here)](https://conda-forge.org/),
which provides more up to date packages.
Conda forge is already set up when we installed Miniforge3
Conda-forge is already set up when we installed Miniforge3

To install packages individually,
we can now use the following command:
Expand Down Expand Up @@ -362,7 +362,7 @@ To see if you were successful, try opening RStudio by clicking on its icon or ty

> **Note:** Since we installed RStudio directly from a deb file rather than from a repository or a snap package, it will not be updated when we run `sudo apt upgrade` and not automatically as for snap packages. Instead, RStudio will notify you of any available updates when the program is launched.
Now we are going to change RStudio’s *Insert Pipe* shortcut so that it inserts the [new native pipe operator `|>`](https://blog.rstudio.com/2021/06/09/rstudio-v1-4-update-whats-new/).
Now we are going to change RStudio’s *Insert Pipe* shortcut so that it inserts the [new native pipe operator `|>`](https://blog.rstudio.com/2021/06/09/rstudio-v1-4-update-whats-new/).
Go to `Tools > Global Options > Code > Editing` and tick the following option:

![](/resources_pages/imgs/new-pipe-rstudio.png)
Expand Down Expand Up @@ -413,12 +413,12 @@ Here's a snippet of the output you should see:

```
SAMPLING FOR MODEL '16a540c6086086816528e4524def24d9' NOW (CHAIN 4).
Chain 4:
Chain 4:
Chain 4: Gradient evaluation took 2e-06 seconds
Chain 4: 1000 transitions using 10 leapfrog steps per transition would take 0.02 seconds.
Chain 4: Adjust your expectations accordingly!
Chain 4:
Chain 4:
Chain 4:
Chain 4:
Chain 4: Iteration: 1 / 2000 [ 0%] (Warmup)
Chain 4: Iteration: 200 / 2000 [ 10%] (Warmup)
Chain 4: Iteration: 400 / 2000 [ 20%] (Warmup)
Expand All @@ -431,11 +431,11 @@ Chain 4: Iteration: 1400 / 2000 [ 70%] (Sampling)
Chain 4: Iteration: 1600 / 2000 [ 80%] (Sampling)
Chain 4: Iteration: 1800 / 2000 [ 90%] (Sampling)
Chain 4: Iteration: 2000 / 2000 [100%] (Sampling)
Chain 4:
Chain 4:
Chain 4: Elapsed Time: 0.003828 seconds (Warm-up)
Chain 4: 0.003417 seconds (Sampling)
Chain 4: 0.007245 seconds (Total)
Chain 4:
Chain 4:
```

### IRkernel
Expand Down Expand Up @@ -476,7 +476,7 @@ You will see two panels,
the right-most panel allows you to perform advanced modification
of keyboards shortcuts in JupyterLab
and it already contains quite a few shortcuts.
Please do not delete any of these shortcuts.
Please do not delete any of these shortcuts.
We're going to add two more shortcuts,
by pasting a text snippet just before the first existing shortcut.
Go ahead and create a new line just after the line that says `"shortcuts": [`
Expand Down Expand Up @@ -632,7 +632,7 @@ pip install "nbconvert[webpdf]"
playwright install chromium
```

Now you can try exporting by going to
Now you can try exporting by going to
`File -> Save and Export Notebook As... -> WebPDF`.

## PostgreSQL
Expand Down Expand Up @@ -823,22 +823,22 @@ this means that you are missing the required version of that program or package.
Either it is not installed at all or the wrong version is installed.
The required version is indicated with a number and an asterisk (*),
e.g. 4.* means that all versions starting with 4 are accepted (4.0.1, 4.2.5, etc).
You can run the following commands to find out which version
of a program or package is installed (if any):
```
name_of_program --version # For system programs
conda list # For Python packages
R -q -e "as.data.frame(installed.packages()[,3])" # For R packages
```
Checking program and package versions...
## Operating system
Operating System: Ubuntu 22.04.1 LTS
Architecture: x86-64
Kernel: Linux 6.2.0-26-generic
## System programs
OK psql 14.9 (Ubuntu 14.9-0ubuntu0.22.04.1)
OK rstudio 2023.06.2+561
Expand All @@ -852,7 +852,7 @@ OK latex 3.141592653-2.6-1.40.25 (TeX Live 2023)
OK tlmgr 5:21 +0200)
OK docker 24.0.5, build ced0996
OK code 1.81.1
## Python packages
OK otter-grader=5.1.3
OK pandas=2.0.3
Expand All @@ -864,7 +864,7 @@ OK jupyterlab-spellchecker=0.8.4
OK jupyterlab PDF-generation was successful.
OK jupyterlab WebPDF-generation was successful.
OK jupyterlab HTML-generation was successful.
## R packages
OK tidyverse=2.0.0
OK markdown=1.8
Expand All @@ -879,7 +879,7 @@ OK ottr=1.1.3
OK canlang=0.0.1
OK rmarkdown PDF-generation was successful.
OK rmarkdown HTML-generation was successful.
The above output has been saved to the file /home/vboxuser/check-setup-mds.log
together with system configuration details and any detailed error messages about PDF and HTML generation.
You can open this folder in your file browser by typing `xdg-open .` (without the surrounding backticks).
Expand Down
Loading

0 comments on commit c39d15a

Please sign in to comment.