Cómputos

Introducción

Esta guía proporciona una visión general de cómo integrar Python con Quarto. Adecuado tanto para principiantes como para usuarios experimentados, este recurso proporciona instrucciones sencillas sobre cómo configurar Python y Jupyter para trabajar con Quarto, permitiéndote ejecutar bloques de código Python dentro de tus documentos. Esto es lo que aprenderás:

  • Instalación y configuración: Instrucciones para instalar Python y Jupyter, y verificar tu configuración con Quarto.
  • Ejecución de código Python: Detalles sobre cómo insertar y ejecutar bloques de código Python, y cómo manejar código en línea para actualizaciones en tiempo real en tus documentos.
  • Ejemplos prácticos y consejos: Incluye ejemplos que muestran cómo utilizar Python en los documentos de Quarto, junto con consejos sobre la representación y la integración de código de manera efectiva.
  • Funciones avanzadas: Sumérgete en funcionalidades avanzadas como el uso de expresiones en línea y la adición de markdown dentro de las salidas de código a través de IPython.


Requisitos previos

Instala Python 3 y el paquete jupyter.

Instalar usando uno de los siguientes métodos:

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

Verifica que Quarto está configurado correctamente para Jupyter con:

Terminal
quarto check jupyter

Bloque de código

Bloques ejecutables de código Python ```{python}. Ejemplo:

---
title: "Código Python"
jupyter: python3
---

Ejemplo de código: 

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

Código en línea

  • Incrustar código en vivo en markdown con una sola marca () en lugar de triple (```).
  • Ejemplo: Establecer radius en un bloque de código y referenciarlo en el texto con código inline.
```{python}
radius <- 5
```

El radio del círculo es `{python} radius`
Importante
  • Las expresiones en línea en archivos .qmd se autoevalúan cuando se renderizan o previsualizan.
  • Para las expresiones en línea del cuaderno, debes ejecutar: quarto render notebook.ipynb --execute. Alternativamente, puedes habilitar la ejecución dentro de la parte YAML del cuaderno (ver más abajo).
---
title: "Mis Notebooks"
execute:
  enabled: true
---

Usar IPython.display.Markdown para incluir sintaxis markdown en expresiones inline:

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

El radio del círculo es `{python} Markdown(f"_radius_ = **{radius}**.")`

Renderización

Leer renderizar documentos Quarto que contengan bloques de código Python o R.

Referencias