Tutorial 2 (ES): Instalación de Jupyter Notebook en su computadora local

1. Instalación de Jupyter Notebook

En los siguientes subcapítulos aprenderá a:

• Instalar Mamba
• Acceder al indicador de Miniforge
• Crear un entorno Python
• Usar Jupyter Lab

2. Instalar Mamba y acceder a Miniforge

Instalar Mamba y acceder a Miniforge

En Windows usamos Mamba a través del indicador de Miniforge, que es una interfaz de línea de comandos para interactuar con entornos conda.

Nota:

Pip es el administrador de paquetes más popular para Python, y puede instalar paquetes de muchas fuentes. El índice de paquetes de Python, PyPI, es la fuente principal. Aunque Pip está bien para la computación general de Python, se prefiere usar administradores de paquetes que se puedan usar para administrar dependencias para diferentes proyectos. Conda es el más popular. Un administrador de paquetes más nuevo es Mamba, que es más rápido que Conda.

2.1. Instalar y configurar Mamba

1. Descargue el instalador de Mambaforge para Windows desde el repositorio oficial de Miniforge en GitHub. O a través de este enlace directo.
2. Ejecute el instalador.
3. Siga las instrucciones en pantalla.
   1. Haga clic en el botón Next > en la ventana de configuración
   2. Haga clic en el botón Acepto para aceptar el acuerdo de licencia.
   3. Seleccione "sólo yo" (Just Me) como tipo de instalación y haga clic en el botón Next >.
   4. Mantenga la ubicación de instalación predeterminada y haga clic en el botón Next >.
   5. Marque la casilla para borrar el caché del paquete una vez finalizado en las opciones de instalación y haga clic en el botón Instalar para iniciar el proceso de instalación.
4. Espere a que se complete el proceso de instalación y luego haga clic en el botón Siguiente >.
5. Por último, haga clic en el botón Finalizar para cerrar la ventana de configuración.

2.2. Acceso al indicador de Miniforge

In indicador es una interfaz para interactuar con comandos. En Windows, utilizamos Mamba a través del indicador de Miniforge para interactuar con entornos conda.

Escriba “Miniforge Prompt” en la barra de búsqueda de Windows y haga clic en Abrir.

Se abrirá un nuevo símbolo del sistema (prompt) en la ubicación de su carpeta de usuario de Windows.

El texto delante de la ruta del directorio actual indica el nombre del entorno (environment) de conda actual. En el caso de abajo es "base".

Es posible obtener una lista de los entornos (environments) conda disponibles y sus ubicaciones usando el siguiente comando:

mamba env list

El único que aparece en la lista es “base”. Al instalar Mambaforge se crea la carpeta miniforge3 en c:/users/personal. Dentro de ella se encuentra la carpeta “envs”. En esta carpeta es donde Mambaforge almacenará cualquier entorno conda que creemos.

3. Crear un entorno Python (environment)

En lo que queda del tutorial, utilizaremos la palabra `environment` para referirnos a un entorno de Pyhon. 

Antes de configurar un nuevo `environment`, entendamos sus ventajas y por qué son importantes (del tutorial de Christian Mills).

• Aislamiento de dependencias: los `environment` crean espacios aislados para cada proyecto, lo que permite a los desarrolladores instalar y administrar diferentes versiones de paquetes sin conflictos. Este aislamiento garantiza que las dependencias específicas requeridas para un proyecto no interfieran ni rompan las dependencias de otro proyecto.
• Gestión de proyectos más sencilla: los `environment` ayudan a agilizar la gestión de proyectos al mantener configuraciones separadas para diferentes proyectos. Los desarrolladores pueden replicar o compartir `environment` de proyectos con miembros del equipo, lo que garantiza un comportamiento consistente en varias máquinas. Los `environment` compartibles ayudan a los desarrolladores a colaborar, solucionar problemas e implementar proyectos.
• Mantenimiento simplificado del sistema: el uso de `environment` ayuda a los desarrolladores a evitar saturar su instalación de Python en todo el sistema con numerosos paquetes y versiones variables. El mantenimiento del sistema es más limpio, ya que los desarrolladores pueden agregar, actualizar o eliminar paquetes fácilmente dentro de `environment` de proyectos individuales sin afectar a otros proyectos ni al sistema en su totalidad.

3.1. Crear un environment para trabajar con pyWaPOR

Para instalar el 'environment' para trabajar con pyWaPOR, vaya al símbolo del sistema de Miniforge y escriba:

mamba create -n pywapor_env pywapor jupyterlab geopandas gdal xarray rioxarray

Una vez que aparezca el símbolo 'Confirm changes [Y/n]' teclee 'y' luego ENTER, para confirmar la instalación del 'environment'.


Una vez que Mamba haya terminado de descargarse e instalarse, active el entorno escribiendo

mamba activate pywapor_env

Para iniciar el JupyterLab, escriba:

jupyter lab

Con este comando, abrirá Jupyter Lab en su navegador web. Vea a continuación un ejemplo de la interfaz de JupyterLab y la explicación de sus componentes.


(© Copyright CodeRefinery team)

Ahora, está listo para pasar al siguiente paso, Tutorial 3: Configuración de pyWaPOR para su propio caso de estudio, en el que creará su primer cuaderno Jupyter para ejecutar pywapor.

------------------------------------------------------------------------------------------------------------------------

Si está interesado en más ejemplos de cuadernos Jupyter, siga este enlace.

4. Más tutoriales que utilizan Jupyter Notebooks

Si desea saber más, puede seguir el curso de Python para aplicaciones hidrológicas (Python for hydrological applications), que incluye aplicaciones como:

• Interpolación espacial de datos de pozos
• Delimitación de corrientes y cuencas

No olvide instalar el 'environment' correcto para ejecutar estos ejemplos.