4. Creación de Jupyter Notebooks¶
4.1. ¿Cómo creo un Jupyter Notebook?¶
Vamos a crear un notebook para el primer deber. Este será creado en la carpeta que ya creamos previamente ~/taller_unix/2_jupyter_lab. Primero, asegúrate de dirigirte al directoio ~/taller_unix. Segundo, activa tu ambiente de anaconda llamado bash. Tercero, llama a Jupyter Lab.
Alerta
La instrucción para el deber está al final del documento. Lee con atención por favor :D. Es necesario que llames a Jupyter Lab dentro del directorio donde vas a trabajar.
Esto se puede hacer con los siguientes comandos:
$ cd ~/taller_unix/
$ conda activate bash
$ jupyter lab
Vas a ver la siguiente ventana en tu explorador. Aquí se ven todas las carpetas correspondientes al taller. Para crear un notebook en la carpeta ~/taller_unix/2_jupyter_lab, damos click en 2_jupyter_lab y seguimos la instrucción de abajo.
Ve a File → New → Notebook en el menú de arriba. Te puede salir una pantalla pidiendo que selecciones el kernel a usar con el notebook. Elige
Bash.
Es posible también crear un cuaderno desde el
Launcher, un panel con todas las opciones de documentos que se pueden crear en Jupyter Lab. Basta con dar un click en el icono del lenguaje de programación que se usará en el cuaderno.
Ahora, renombra al notebook
deber_1.ipynb
Si usas Terminal para ir al directorio
~/taller_unix/2_jupyter_lab, debes ver que el jupyter notebook está dentro de2_jupyter_lab:$ cd ~/taller_unix/2_jupyter_lab $ ls -l
Customización
Si deseas puedes cambiar el estilo de Jupyter Lab a uno oscuro.
4.2. Anatomía de un Jupyter Notebook¶
Hay varias partes importantes de un jupyter notebook que debes conocer:
Celdas Markdown: Celdas donde puedes ingresar texto, imágenes, fórmulas, tablas y mucha más información que documenta el contenido de las céldas de código.
Celdas de código: Celdas donde se coloca código y se lo corre para producir el resultado. Estas celdas interpretan el lenguaje de programación establecido por el kernel.
Kernel actual: Kernel utilizado por el notebook. Especifica el lenguaje de programación utilizado en las celdas de código.
Barra de herramientas: Herramientas importantes como guardar, copiar, cortar,
Contenido del directorio de trabajo actual: El icono de carpeta muestra todo el contenido del directorio en donde se llamó a Jupyter Lab. Es el directorio de trabajo porque desde ahí Jupyter creará y accederá a los archivos y subdirectorios.
Menú de opciones: Barra de opciones que permite modificar y guardar archivos, cambiar acciones del kernel, configuraciones de Jupyter Lab, etc.
Estas se encuentran señaladas en la imagen. El resto son herramientas muy útiles. Hay varias otras funcionalidades que puedes explorar.
El posible cambiar el tipo de celda al que se requiera ese momento. Por defecto se crea una nueva celda de código, pero es posible cambiarla a una celda de Markdown. Desde la barra de herramientas.
Alerta
Recuerda siempre guardar el progreso de tu notebook para evitar pérdida de datos
4.3. Markdown¶
Markdown es una simplificación para HTML usado en programación web. Markdown es la herramienta que permite que existan celdas que contengan datos, imágenes y texto para describir código. Usaremos Markdown durante los deberes. Existen varias guías que puedes usar. Algunas de ellas las son:
Las tres cosas que debes saber de Markdown para este taller son:
Insertar títulos Y texto
Insertar imágenes
Usar negritas, cursiva y comillas
(``)
La celda Markdown en la imagen anterior contiene el siguiente código.
# Deber No. 1: Jupyter Lab
### Nombre: Juanes
En este deber debo:
1. Colocar mi nombre.
2. Correr el comando `conda env list` en una celda del Jupyter notebook y verificar que he creado correctamente el ambiente `bash`.
3. Correr mi primer código en Bash (copiar y pegar el que está más abajo en una celda del Jupyter notebook y correr la celda).
4. Colocar una imágen en Markdown ( un meme por ejemplo :D )
<center><img width="150px" src="./ilp.png"></center
Aquí se pueden evidenciar: el título principal maracdo por #, el título terciario mar cado por ###, una lista enumerada desde el 1, texto en curvisiva utilizando dos asteriscos para comprimir al texto que se quiere hacer cursiva *TEXT*, texto en negrita con doble asterisco **TEXT** y una imagen centrada. Las comillas comillas (``) generan texto resaltado. Por ejemplo, esta PALABRA en Mardown se escribe
`PALABRA`
Se usa generalmente para resaltar código, pero puede ser usada libremente para resaltar lo que sea.
La imagen se ha insertado mediante una instrucción en HTML. Para esto es necesario especificar dimensión y ubicación de la imagen ilp.png:
<img width="150" src="./ilp.png">
He especificado que la imagen se encuentra en la misma carpeta del notebook. También he especificado un ancho de 150 pixeles. Además de especificar que se requiere que la imágen sea centrada.
<center><img width="150" src="./ilp.png"></center>
4.4. Celdas de código¶
Eventualmente necesitarás usar celdas de código. Para ello hay que especificarle a Jupyter Lab que vas a crear una célda de código desde la barra de herramientas, usando el signo +. Además, para correr el código debes usar el icono de flecha.
El código de la imágen anterior es el siguiente. Este, dar click en el icono de flecha, imprime en pantalla los números 1, 2 y 3, además de la frase Eso es todo :). Los cuadernos siempre mostrarán los resultados de un programa a menos que se especifique lo contrario.
counter=1
while [ $counter -le 3 ]
do
echo -n $counter
((counter++))
done
echo
echo "Eso es todo :)"
Alerta
Cuando se inicia Jupyter Lab se crea una carpeta llamada .ipynb_checkpoints. No borrar esta carpeta. Aquí se guardan borradores.
4.5. Ejercicio: Creación de un Jupyter Notebook en Jupyter Lab¶
Como deber replica la imagen de Anatomía de un Jupyter Notebook. Hacer los 4 elementos de la lista de la imagen. Seguir los ejemplos de arriba.
Nota
El entregable es un jupyter notebook.