1. Instalación#

Note

Instalación y configuración del software necesario para realizar las prácticas (Miniconda, Visual Studio Code y bibiotecas de Python para el análisis geoespacial).

1.1. Objetivos de aprendizaje#

  • Comprender la arquitectura de bibliotecas de código abierto en Python (GDAL, PROJ, GEOS).

  • Instalar y configurar Miniforge y Mamba utilizando canales comunitarios (conda-forge)).

  • Configurar Visual Studio Code con las extensiones científicas indispensables.

  • Crear y verificar un entorno virtual aislado para análisis marino.

1.2. Gestión del entorno de Python#

Para gestionar las instalaciones de Python y sus bibliotecas, es importante tener presente algunos conceptos clave, antes de instalar las bibliotecas a utilizar y el entorno de desarrollo integrado (IDE) que se empleará (Visual Studio Code).

  • Gestión de dependencias: El ecosistema de Python ofrece muchas bibliotecas interconectadas que evolucionan constantemente, lo que genera dependencias complejas; sin embargo, los gestores de paquetes resuelven esto automáticamente, facilitando su instalación y actualización.

  • Instalación de Python con Miniconda: Aunque es posible instalar Python desde su sitio oficial, es recomendable usar Miniconda para instalarlo. Miniconda incluye gestor de paquetes llamado conda, que facilita la instalación de paquetes de Python.

  • Gestores de paquetes: Los gestores de paquetes, como conda (mamba), son herramientas útiles para instalar, actualizar o eliminar paquetes de Python y entornos virtuales.

  • Entornos virtuales: Los entornos virtuales aíslan el intérprete y las bibliotecas de Python para cada proyecto, garantizando que los paquetes funcionen correctamente juntos sin interferir con otros entornos o con el sistema operativo.

  • Configuración y documentación de sus entornos: Los paquetes de Python se pueden instalar uno por uno desde la línea de comandos. Sin embargo, para documentar y realizar un seguimiento de sus paquetes y garantizar que su instalación funcione correctamente, es recomendable escribir un archivo de configuración que incluya los paquetes del entorno. Los gestores de paquetes admiten varios formatos, pero conda y mamba utilizan un archivo de configuración escrito en formato YAML, por ejemplo environment.yml.

1.2.1. Tabla comparativa#

Herramienta

Tipo

Peso / Tamaño

Velocidad

Público Ideal / Caso de Uso

Anaconda

Distribución completa

Muy pesado (~Varios GB)

Estándar

Principiantes / Quienes prefieren interfaz gráfica

Miniconda

Instalador mínimo

Ligero (~Cientos de MB)

Estándar / Rápido en Conda moderno

Producción / Control total del sistema

Conda

Gestor de paquetes

Integrado en los anteriores

Rápido (con motor libmamba actual)

Uso general y automatización

Mamba

Gestor de alto rendimiento

Ligero (vía Miniforge/Conda-forge)

Extremadamente rápido

Proyectos grandes con dependencias complejas

1.3. Pasos para la instalación#

  1. Instalar Miniconda o Miniforge: Descarga e instala Miniconda. Acepta los términos de la licencia durante la instalación, así como las opciones predeterminadas.

  2. Instalar VS Code Descarga e instala VS Code. Acepta el acuerdo de licencia y las opciones predeterminadas durante la instalación.

  3. Crear un entorno virtual: Una vez instalado Miniconda, se recomienda crear un entorno virtual específico para los proyectos del curso. Descarga el archivo de configuración environment.yml. Ejecuta el siguiente comando en la terminal (Miniconda Prompt en Windows)para crear el entorno:

conda env create -f environment.yml

Luego, activa el entorno con:

conda activate gis

Note

Activar el entorno gis en Visual Studio Code (y asegurarse de que las bibiotecas de Python estén correctamente instaladas en dicho entorno) es crucial para garantizar que todas las dependencias y configuraciones estén correctamente aplicadas.

1.4. 3. Algunos comandos de Conda#

Usa estos comandos desde tu terminal (Miniconda Prompt en Windows).

1.4.1. Gestión de Entornos#

  • Crear un nuevo entorno con una versión específica de Python:

    conda create --name mi_entorno python=3.11
    
  • Activar un entorno:

    conda activate mi_entorno
    
  • Desactivar el entorno actual:

    conda deactivate
    
  • Listar todos los entornos instalados en tu computadora:

    conda env list
    
  • Eliminar un entorno por completo:

    conda env remove --name mi_entorno
    

1.4.2. Instalación de Paquetes y Uso de Conda-Forge#

Conda-forge es un canal mantenido por la comunidad que contiene las versiones más recientes y una cantidad masiva de paquetes de software científico.

  • Instalar una biblioteca desde el canal por defecto:

    conda install numpy
    
  • Instalar una biblioteca específicamente desde Conda-Forge:

    conda install -c conda-forge pandas scikit-learn
    
  • Configurar Conda-Forge como tu canal prioritario predeterminado (Muy recomendado):

    conda config --add channels conda-forge
    conda config --set channel_priority strict
    

    Una vez configurado lo anterior, cualquier comando conda install <paquete> buscará automáticamente primero en conda-forge sin necesidad de escribir -c conda-forge.

  • Listar paquetes instalados en el entorno activo:

    conda list
    
  • Actualizar un paquete específico:

    conda update nombre_del_paquete
    

1.5. Extensiones esenciales en VS Code#

Para un flujo de trabajo óptimo en VS Code, se requieren las siguientes extensiones:

  1. Python (ms-python.python): Proporciona IntelliSense, resaltado de sintaxis y depuración.

  2. Jupyter (ms-toolsai.jupyter): Permite ejecutar cuadernos interactivos .ipynb y la ventana interactiva.

  3. Ruff (charliermarsh.ruff): Linter y formateador para código limpio.

1.6. Verificación del entorno#

Crea un script llamado test_env.ipynb para validar la instalación:

from importlib.metadata import version
import geopandas as gpd
import rasterio
import xarray as xr
import cartopy
import cmocean

print(f"GeoPandas version: {version('geopandas')}")
print(f"Rasterio version:  {version('rasterio')}")
print(f"Xarray version:    {version('xarray')}")
print(f"Cartopy version:   {version('cartopy')}")
print(f"Cmocean version:   {version('cmocean')}")

1.7. Ejercicio práctico#

  1. Verifique en la terminal de VS Code que el intérprete activo apunte a la ruta de geo-marinas.

  2. Ejecute el script de prueba y registre en su cuaderno de notas las versiones exactas instaladas.