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
condaymambautilizan un archivo de configuración escrito en formato YAML, por ejemploenvironment.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 |
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#
Instalar Miniconda o Miniforge: Descarga e instala Miniconda. Acepta los términos de la licencia durante la instalación, así como las opciones predeterminadas.
Instalar VS Code Descarga e instala VS Code. Acepta el acuerdo de licencia y las opciones predeterminadas durante la instalación.
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 deactivateListar 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 listActualizar 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:
Python (
ms-python.python): Proporciona IntelliSense, resaltado de sintaxis y depuración.Jupyter (
ms-toolsai.jupyter): Permite ejecutar cuadernos interactivos.ipynby la ventana interactiva.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#
Verifique en la terminal de VS Code que el intérprete activo apunte a la ruta de
geo-marinas.Ejecute el script de prueba y registre en su cuaderno de notas las versiones exactas instaladas.