Computationnels

Introduction

Ce guide donne un aperçu de la façon d’intégrer Python dans Quarto. Convenant aux débutants comme aux utilisateurs expérimentés, cette ressource fournit des instructions simples pour configurer Python et Jupyter afin qu’ils fonctionnent avec Quarto, vous permettant d’exécuter des blocs de code Python au sein de vos documents. Voici ce que vous apprendrez:

  • Installation et configuration : Instructions sur l’installation de Python et de Jupyter, et la vérification de votre configuration dans Quarto.
  • Exécution du code Python : Détails sur la façon d’insérer et d’exécuter des blocs de code Python, et sur la façon de gérer le code en ligne pour des mises à jour en temps réel dans vos documents.
  • Exemples pratiques et astuces : Inclut des exemples qui vous montrent comment utiliser Python dans les documents Quarto, ainsi que des conseils sur le rendu et l’intégration efficace du code.
  • Fonctionnalités avancées : Plongez dans les fonctionnalités avancées telles que l’utilisation d’expressions en ligne et l’ajout de markdown dans les sorties de code par le biais d’IPython.


Prérequis

Installez Python 3 et le package jupyter.

Installer en utilisant l’une des méthodes suivantes:

  1. En utilisant Pip:
    • Mac/Linux: python3 -m pip install jupyter
    • Windows: py -m pip install jupyter
  2. En utilisant Conda: conda install jupyter

Vérifier que Quarto est configuré correctement pour Jupyter avec:

Terminal
quarto check jupyter

Bloc de code

Blocs de code Python exécutables ```{python}. Exemple:

---
title: "Code Python"
jupyter: python3
---

Exemple de code: 

```{python}
print("Hellow World")
```

Code en ligne

  • Incorporer du code live dans le markdown avec une simple coche (`) au lieu d’une triple coche (```).
  • Exemple : Configurer radius dans un bloc de code et le référencer dans le texte avec du code inline.
```{python}
radius <- 5
```

Le rayon du cercle est de `{python} radius`
Important
  • Les expressions en ligne dans les fichiers .qmd sont évaluées automatiquement lors du rendu ou de la prévisualisation.
  • Pour les expressions en ligne du notebook, vous devez exécuter: quarto render notebook.ipynb --execute. Alternativement, vous pouvez activer l’exécution dans la partie YAML du notebook (voir ci-dessous).
---
title: "Mes Notebooks"
execute:
  enabled: true
---

Utiliser IPython.display.Markdown pour inclure la syntaxe markdown dans les expressions en ligne:

```{python}
radius = 10
from IPython.display import Markdown
```

Le rayon du cercle est de `{python} Markdown(f"_radius_ = **{radius}**.")`

Rendu

Lire le rendu des documents Quarto contenant des blocs de code Python ou R.

Références