# 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).
```


## 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.

## 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](https://www.python.org/) desde su sitio oficial, es recomendable usar [Miniconda](https://www.anaconda.com/download/success?reg=skipped-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``.


### 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 |

## Pasos para la instalación

1. **Instalar Miniconda o Miniforge:** Descarga e instala [Miniconda](https://www.anaconda.com/download/success?reg=skipped-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](https://code.visualstudio.com/download). 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](../environment.yml). Ejecuta el siguiente comando en la terminal (**Miniconda Prompt** en Windows)para crear el entorno:

```bash
conda env create -f environment.yml
```

Luego, activa el entorno con:

```bash
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.
```

## 3. Algunos comandos de Conda

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

### Gestión de Entornos

*   **Crear un nuevo entorno con una versión específica de Python:**
    ```bash
    conda create --name mi_entorno python=3.11
    ```
*   **Activar un entorno:**
    ```bash
    conda activate mi_entorno
    ```
*   **Desactivar el entorno actual:**
    ```bash
    conda deactivate
    ```
*   **Listar todos los entornos instalados en tu computadora:**
    ```bash
    conda env list
    ```
*   **Eliminar un entorno por completo:**
    ```bash
    conda env remove --name mi_entorno
    ```

### 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:**
    ```bash
    conda install numpy
    ```
*   **Instalar una biblioteca específicamente desde Conda-Forge:**
    ```bash
    conda install -c conda-forge pandas scikit-learn
    ```
*   **Configurar Conda-Forge como tu canal prioritario predeterminado (Muy recomendado):**
    ```bash
    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:**
    ```bash
    conda list
    ```
*   **Actualizar un paquete específico:**
    ```bash
    conda update nombre_del_paquete
    ```


## 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.

## Verificación del entorno

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

``` python
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')}")
```

## 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.
