-
Notifications
You must be signed in to change notification settings - Fork 12
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge pull request #491 from StatCan/image-selection-guide
Image selection guide
- Loading branch information
Showing
3 changed files
with
118 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,55 @@ | ||
# Selecting an Image for your Notebook Server | ||
|
||
Depending on your project or use case of the Notebook Server, some images may be | ||
more suitable than others. The following will go through the main features of | ||
each to help you pick the most appropriate image for you. | ||
|
||
When selecting an image, you have 3 main options: | ||
|
||
- Jupyter Notebook (CPU, TensorFlow, PyTorch) | ||
- RStudio | ||
- Remote Desktop (r, geomatics) | ||
|
||
## Jupyter Notebooks | ||
|
||
[Jupyter Notebooks](https://jupyter.org/) are used to create and share | ||
interactive documents that contain a mix of live code, visualizations, and text. | ||
These can be written in `Python`, `Julia`, or `R`. | ||
|
||
![Jupyter Notebooks](../images/jupyter_in_action.png) | ||
|
||
<!-- prettier-ignore --> | ||
??? info "Common uses include:" | ||
data transformation, numerical simulation, statistical | ||
modelling, machine learning and more. | ||
|
||
The jupyter notebooks are great launchpads for analytics including machine | ||
learning. The `jupyterlab-cpu` image gives a good core experience for python, | ||
including common packages such as `numpy`, `pandas` and `scikit-learn`. If | ||
you're interested specifically in using **_TensorFlow_** or **_PyTorch_**, we | ||
also have `jupyterlab-tensorflow` and `jupyterlab-pytorch` which come with those | ||
tools pre-installed. | ||
|
||
Each image comes pre-loaded with VS Code in the browser if you prefer a full IDE | ||
experience. | ||
|
||
### RStudio | ||
|
||
**[RStudio](RStudio/)** gives you an integrated development environment | ||
specifically for `R`. If you're coding in `R`, this is typically the Notebook | ||
Server to use. Use the `rstudio` image to get an RStudio environment. | ||
|
||
![RStudio](../images/rstudio_visual.png) | ||
|
||
### Remote-Desktop | ||
|
||
For a full Ubuntu desktop experience, two versions of Remote Desktop are | ||
available. These come pre-loaded with Python and R, but are delivered in a | ||
typical desktop experience that also comes with Firefox, VS Code, and open | ||
office tools. The operating system is **[Ubuntu](https://ubuntu.com/about)** | ||
18.04 with the **[XFCE](https://www.xfce.org/about)** desktop environment. | ||
|
||
`remote-desktop-r` includes R and RStudio but If you need Geomatics tooling for | ||
R, choose the `remote-desktop-geomatics` flavour of this image. | ||
|
||
![Screenshot of the Virtual Desktop](../images/rd_desktop.png) |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -4,3 +4,6 @@ l'EAA | |
Linting | ||
R-Dashboards | ||
R-Shiny | ||
TensorFlow | ||
PyTorch | ||
Geomatics |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,60 @@ | ||
# Sélectionner une Image pour votre Serveur Bloc-Notes | ||
|
||
Selon votre projet ou votre utilisation souhaitée du serveur bloc-notes, | ||
certaines images seront plus appropriées que d'autres. | ||
|
||
Ce qui suit passera en revue quelques caractéristiques de chaque image pour vous | ||
aider à choisir. | ||
|
||
Lors de la sélection, vous avez 3 options principales: | ||
|
||
- Bloc-Notes Jupyter (CPU, TensorFlow, PyTorch) | ||
- RStudio | ||
- Bureau Virtuel (r, Geomatics) | ||
|
||
## Jupyter | ||
|
||
Les [Bloc-Notes Jupyter](https://jupyter.org/) sont utilisés pour créer et | ||
partager des documents interactifs qui contiennent un mélange de code en direct, | ||
de visualisations et de texte. Ceux-ci peuvent être écrits en `Python`,` Julia` | ||
ou `R`. | ||
|
||
![Jupyter Notebooks](../../en/images/jupyter_in_action.png) | ||
|
||
<!-- prettier-ignore --> | ||
??? info "La plupart des utilisations comprennent:" | ||
la transformation de données, la simulation numérique, la modélisation statistique, l'apprentissage machine et autres. | ||
|
||
Ceux-ci s'agit d'un excellent outil pour l'analyse, y compris l'apprentissage | ||
machine. L'image `jupyterlab-cpu` fournit une bonne expérience de base pour | ||
`python`, y compris des paquets tels que `numpy`, `pandas` et `scikit-learn`. Si | ||
vous êtes intéressé spécifiquement par **_TensorFlow_** ou **_PyTorch_**, nous | ||
avons également les images `jupyterlab-tensorflow` et` jupyterlab-pytorch` qui | ||
viennent avec ces outils pré-installés. | ||
|
||
Chaque image est préchargée avec VS Code dans le navigateur si vous préférez une | ||
expérience IDE complète. | ||
|
||
### RStudio | ||
|
||
**[RStudio](RStudio/)** vous offre un environnement de développement intégré | ||
spécifiquement pour `R`. Si vous codez en `R`, il s'agit généralement du serveur | ||
bloc-notes utiliser. Utilisez l'image `rstudio` pour obtenir un environnement | ||
RStudio. | ||
|
||
![RStudio](../../en/images/rstudio_visual.png) | ||
|
||
### Bureau Virtuel | ||
|
||
Pour une expérience Ubuntu complète, deux versions du Bureau Virtuel sont | ||
disponible. Ceux-ci sont préchargés avec Python et R, mais sont livrés dans un | ||
expérience typique qui est également fournie avec _Firefox_, _VS Code_ et les | ||
outils _Open Office_. Le système d'exploitation est | ||
**[Ubuntu](https://ubuntu.com/about)** 18.04 avec l'environnement de bureau | ||
**[XFCE](https://www.xfce.org/about)**. | ||
|
||
`remote-desktop-r` inclut R et RStudio mais si vous avez besoin d'outils de | ||
géomatique pour R, choisissez la version `remote-desktop-geomatics` de cette | ||
image. | ||
|
||
![Screenshot of the Virtual Desktop](../../en/images/rd_desktop.png) |