Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Image selection guide #491

Merged
merged 5 commits into from
Apr 20, 2021
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
55 changes: 55 additions & 0 deletions docs/en/1-Experiments/Selecting-an-Image.md
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)
3 changes: 3 additions & 0 deletions docs/fr/.spelling
Original file line number Diff line number Diff line change
Expand Up @@ -4,3 +4,6 @@ l'EAA
Linting
R-Dashboards
R-Shiny
TensorFlow
PyTorch
Geomatics
60 changes: 60 additions & 0 deletions docs/fr/1-Experiences/Selectionner-une-Image.md
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)