{
 "cells": [
  {
   "cell_type": "markdown",
   "id": "5647e2a5",
   "metadata": {},
   "source": [
    "<table style=\"width:100%; background: #d8d8d8; border: none; color: #2a6cbe; font-family: sans-serif;\" border=\"0\">\n",
    "  <tr>\n",
    "    <!-- Puedes ajustar los % de ancho aquí abajo -->\n",
    "    <td style=\"width: 20%; border: none; padding: 15px; font-size: 20px; font-weight: bold;\">CICIMAR-IPN</td>\n",
    "    <td style=\"width: 60%; border: none; padding: 15px; border-left: 4px solid #ffffff;\">\n",
    "        SIG-Python<br>\n",
    "        Práctica 1 Datos vectoriales con GeoPandas y Matplotlib\n",
    "    </td>\n",
    "    <td style=\"width: 20%; border: none; padding: 15px; border-left: 4px solid #ffffff;\">\n",
    "        Noviembre, 2026 <br>\n",
    "    </td>\n",
    "  </tr>\n",
    "</table>"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "aeeb36a2",
   "metadata": {},
   "source": [
    "# Datos vectoriales con geopandas   \n",
    "\n",
    "<img src=\"https://geopandas.org/en/v1.1.1/_images/geopandas_logo.png\" width=\"25%\" alt=\"Descripción de la imagen\">"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "c554e753",
   "metadata": {
    "editable": true,
    "slideshow": {
     "slide_type": ""
    },
    "tags": []
   },
   "source": [
    "En esta libreta se muestran ejemplos de cómo trabajar con datos vectoriales utilizando `geopandas` y `matplotlib` para la visualización de los mapas, entre otras bibliotecas auxiliares.\n",
    "\n",
    "Se exploran algunas opciones para obtener datos vectoriales en línea ([Natural Earth](https://www.naturalearthdata.com/)), a través de la Sociendad Americana de Información Cartográfica ([NACIS](https://nacis.org/)).\n",
    "\n",
    "Para crear los mapas se utilizarán datos de sismos (almacenados en 16 archivos `csv`, uno por año del 2010 al 2025, en la carpeta `data/`). Se recomienda la siguiente estructura de los archivos:\n",
    "\n",
    "```\n",
    "gis-python/\n",
    "└── 01_sismos_v1.ipynb\n",
    "    output\n",
    "    data\n",
    "    └── sismos\n",
    "        ├── 2010.csv\n",
    "        ├── 2011.csv\n",
    "        ├── 2012.csv\n",
    "        ...\n",
    "        ├── 2023.csv\n",
    "        ├── 2024.csv\n",
    "        └── 2025.csv\n",
    "```"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "78b7527f",
   "metadata": {},
   "source": [
    "### Sismos en el mundo y en México   \n",
    "\n",
    "1. Descargar los [datos de sismos (2010-2025)](data/sismos.zip). Faltan los datos del año 2024. Descargarlos de la página [earthquake.usgs.gov](https://earthquake.usgs.gov/earthquakes/search/), seleccionando los sismos (de magnitud `≥4`) ocurridos en todo el mundo (en formato CSV). Guargar este archivo como `sismos-2024.csv` en la carpeta de datos.\n",
    "\n",
    "2. Ejecuta las celdas del script para asegurarte de que las bibliotecas del entorno `gis` están correctamente instaladas y que tienes acceso a la carpeta de datos. Revisa las funciones y variables definidas en el script para comprender su funcionamiento.\n",
    "\n",
    "3. Al final del script y tomando como referencia el los ejemplos de la libreta, incluye en una celda el código para generar un mapa con todos los sismos ocurridos en el mundo (2010-2025). En otra celda escribe el código para generar un mapa por año (2010-2025) para México. En ambos casos genera los mapas en formato PNG y muestra la barra de color que indique la magnitud de los sismos.\n",
    "    \n",
    "4. ¿Cuántos sismos con magnitud `≥7` ocurrieron en ese periodo en México? ¿Cuándo (fecha y hora) ocurrieron esos sismos (según la zona horaria ``'America/Mexico_City'``) y en dónde?\n",
    "\n",
    "5. Documentar el script con los comentarios pertinentes de acuerdo con los datos y procedimientos utilizados.\n",
    "\n",
    "6. Como evidencia, adjuntar en Teams el script actualizado. Además, subir los archivos PNG generados (en un archivo comprimido)."
   ]
  },
  {
   "cell_type": "markdown",
   "id": "125561bd",
   "metadata": {},
   "source": [
    "### Importar las bibliotecas necesarias   "
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "id": "caf2fbd5",
   "metadata": {},
   "outputs": [],
   "source": [
    "#!/usr/bin/env python3\n",
    "import glob\n",
    "\n",
    "import geopandas as gpd\n",
    "import matplotlib.pyplot as plt\n",
    "import pandas as pd"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "35a24972",
   "metadata": {},
   "source": [
    "| Biblioteca | Descripción |\n",
    "| :--- | :--- |\n",
    "| `glob` | Búsqueda de archivos en el sistema de archivos utilizando patrones de nombres|\n",
    "| `geopandas` | Extensión de pandas para trabajar con datos vectoriales geoespaciales|\n",
    "| `matplotlib` | Creación de gráficos estáticos y visualizaciones en 2D|\n",
    "| `pandas` | Manipulación y análisis de datos tabulares (DataFrames)|\n"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "46177b7c",
   "metadata": {},
   "source": [
    "### Leer solo un archivos CSV \n",
    "\n",
    "Por ejemplo, los sismos de 2010."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "id": "506ff416",
   "metadata": {},
   "outputs": [],
   "source": [
    "fn = 'data/sismos-2010.csv'\n",
    "sismos = pd.read_csv(fn)\n",
    "sismos.dtypes"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "cc7f72d9",
   "metadata": {},
   "source": [
    "### Mostrar la ubicación de los sismos   "
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "id": "422380a1",
   "metadata": {},
   "outputs": [],
   "source": [
    "fig, ax = plt.subplots()\n",
    "ax.plot(sismos['longitude'], sismos['latitude'], 'o', markersize=5, alpha=0.5)\n",
    "plt.show()"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "c948d1fd",
   "metadata": {},
   "source": [
    "### Obtener los límites administrativos   \n",
    "\n",
    "Acceso a los datos de límites administrativos del mundo y de los estados de México(también disponibes en formato shapefile en [Natural Earth](https://www.naturalearthdata.com/))."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "id": "e8ee52e5",
   "metadata": {},
   "outputs": [],
   "source": [
    "# Fronteras de países \n",
    "url = 'https://naciscdn.org/naturalearth/110m/cultural/ne_110m_admin_0_countries.zip'\n",
    "countries = gpd.read_file(url)\n",
    "\n",
    "# Estados mexicanos\n",
    "url_states = 'https://naciscdn.org/naturalearth/10m/cultural/ne_10m_admin_1_states_provinces.zip'\n",
    "mexico = gpd.read_file(url_states)\n",
    "mexico = mexico[mexico['admin'] == 'Mexico']"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "df21c31f",
   "metadata": {},
   "source": [
    "### Mostar la capa  `countries` y superponer la ubicación de los sismos   \n"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "id": "53ab734b",
   "metadata": {},
   "outputs": [],
   "source": [
    "fig, ax = plt.subplots(figsize=(11, 7.5))\n",
    "countries.plot(ax=ax, color='lightgray')\n",
    "sismos = sismos.sort_values(by='mag') # ordenar los sismos por magnitud\n",
    "ax.scatter(sismos['longitude'], sismos['latitude'], c=sismos['mag'], s=5, cmap='jet') # color depende de la magnitud\n",
    "ax.set_xlabel('Longitude')\n",
    "ax.set_ylabel('Latitude')\n",
    "ax.set_title('Sismos (2010)')\n",
    "cbar = plt.colorbar(ax.collections[1], ax=ax, shrink=0.5)\n",
    "cbar.set_label('Magnitud')\n",
    "plt.show()"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "ca1481f9",
   "metadata": {},
   "source": [
    "### Recuperar los archivos CSV   \n",
    "Con la función `glob.glob('data/sismos*.csv')` se obtine la lista de archivos CSV que cumplen con el patrón especificado (carpeta, parte del nombre de los archivos y su extensión). Esta lista de archivos se utiliza posteriormente para leer y combinar los datos en un solo DataFrame."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "id": "41fb663a",
   "metadata": {},
   "outputs": [],
   "source": [
    "csv_files = glob.glob('data/sismos*.csv')\n",
    "csv_files.sort()  # Ordena la lista de archivos CSV por nombre (para procesarlos en orden cronológico)"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "14bef238",
   "metadata": {},
   "source": [
    "### Combina todos los archivos CSV de sismos en un solo DataFrame   \n",
    "\n",
    "Se aplica la función `pd.concat` en un un ciclo `for` para iterar sobre cada archivo CSV, concatenándolos en uno solo."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "id": "fb179279",
   "metadata": {},
   "outputs": [],
   "source": [
    "df_all_sismos = pd.concat((pd.read_csv(f) for f in csv_files), ignore_index=True) "
   ]
  },
  {
   "cell_type": "markdown",
   "id": "d8764832",
   "metadata": {},
   "source": [
    "### Mapa de  los sismos en México (2010-2025) \n",
    "\n",
    "Para filtrar los registros de interés, se seleccionan del DataFrame aquellos que cumplen con las condiciones de interés (registros con la columna `place` que contiene la palabra 'Mexico' y en los que la columna `mag` sea mayor o igual a 4). \n",
    "\n",
    "Posteriormente se crea el GeoDataFrame (GeoPandas) a partir de las columnas de latitud y longitud, para poder visualizar los sismos en un mapa.\n",
    "Se utiliza la función `gpd.GeoDataFrame` junto con `gpd.points_from_xy` para generar la geometría de los puntos geográficos."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "id": "1e6c2056",
   "metadata": {},
   "outputs": [],
   "source": [
    "df_sismos_mexico = df_all_sismos[df_all_sismos['place'].str.contains('Mexico') & (df_all_sismos['mag'] >= 4)]\n",
    "\n",
    "# Crear un GeoDataFrame con el sistema de coordenadas geográficas (EPSG:4326)\n",
    "gdf_sismos_mexico = gpd.GeoDataFrame(df_sismos_mexico, geometry=gpd.points_from_xy(df_sismos_mexico['longitude'], df_sismos_mexico['latitude']), crs=\"EPSG:4326\")\n",
    "\n",
    "# Graficar el mapa de sismos en México\n",
    "fig, ax = plt.subplots(figsize=(11, 8.5))\n",
    "ax.set_facecolor('lightblue')\n",
    "\n",
    "countries.plot(ax=ax, facecolor='lightgrey', edgecolor='black', linewidth=0.5)\n",
    "mexico.plot(ax=ax, facecolor='#e6d2a1', edgecolor='black', linewidth=0.5)\n",
    "\n",
    "# Muestra los puntos y agrega una leyenda \n",
    "gdf_sismos_mexico.plot(ax=ax, column='mag', cmap='Reds', scheme='natural_breaks', k=5, markersize=5, legend=True, legend_kwds={'title': 'Magnitud'})\n",
    "\n",
    "# Establece los límites del mapa \n",
    "ax.set_xlim([-118.0, -86.0])\n",
    "ax.set_ylim([14.0, 33.0])\n",
    "\n",
    "# Agrega etiquetas a los ejes\n",
    "ax.set_xlabel('Longitud')\n",
    "ax.set_ylabel('Latitud')\n",
    "\n",
    "# Agrega título y una cuadrícula al mapa\n",
    "plt.title('Sismos en México (2010-2025) con magnitud ≥ 4')\n",
    "ax.grid(True, linestyle='--', linewidth=0.5, color='gray')\n",
    "\n",
    "# Guarda y muestra el mapa generado\n",
    "plt.savefig('output/sismos_mexico_(2010-2025).png')\n",
    "plt.show()\n",
    "plt.close()"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "b3a015b8",
   "metadata": {},
   "source": [
    "### Guardar los DataFrames\n",
    "\n",
    "Guardar en formato `GeoPackage`los DataFrames `mexico` y `gdf_sismos_mexico` en el directorio `data`    \n"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "id": "d5607d98",
   "metadata": {},
   "outputs": [],
   "source": [
    "mexico.to_file(\"data/mexico.gpkg\", layer=\"mexico\", driver=\"GPKG\")\n",
    "gdf_sismos_mexico.to_file(\"data/gdf_sismos_mexico.gpkg\", layer=\"gdf_sismos_mexico\", driver=\"GPKG\")"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "bb45daa8",
   "metadata": {},
   "source": [
    "### Mostrar el mapa con todos los sismos (2010-2025) en a nivel global   \n",
    "\n",
    "Crear un mapa similar al anterior, pero para todo el mundo. Guardar el mapa en el directorio `output/` en formato PNG."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "id": "c8f6ad65",
   "metadata": {},
   "outputs": [],
   "source": [
    "# Escribe el código aquí\n"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "0aa551fa",
   "metadata": {},
   "source": [
    "### Generar los mapas de los sismos por año en México   \n",
    "\n",
    "Guardar los 16 mapas de los sismos por año en el directorio `output/` en formato PNG.\n",
    "\n",
    "Es conveniente crear una columna que contenga el año de cada sismo, para poder generar los mapas por año de manera más sencilla.\n",
    "```\n",
    "gdf_sismos_mexico['time'] = pd.to_datetime(gdf_sismos_mexico['time'])\n",
    "gdf_sismos_mexico['year'] = gdf_sismos_mexico['time'].dt.year\n",
    "gdf_sismos_mexico.dtypes\n",
    "```\n",
    "En el bucle `for` se puede iterar sobre cada año y generar un mapa de los sismos ocurridos en ese año. Por ejemplo:\n",
    "```\n",
    "for year in gdf_sismos_mexico['year'].unique():\n",
    "```"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "id": "d2677c17",
   "metadata": {},
   "outputs": [],
   "source": [
    "# Escribe el código aquí\n"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "bfb64c5e",
   "metadata": {},
   "source": [
    "### Fecha, hora y lugar de los sismos >= 7 en México\n",
    "\n",
    "Una vez que la columna `time` sea convertida a formato `datetime`, se debe transformar la zona horaria a la correspondiente a la Ciudad de México:\n",
    "\n",
    "```\n",
    "gdf_sismos_mexico['time'] = gdf_sismos_mexico['time'].dt.tz_convert('America/Mexico_City')\n",
    "```"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "id": "c45993e7",
   "metadata": {},
   "outputs": [],
   "source": [
    "# Escribe el código aquí\n"
   ]
  }
 ],
 "metadata": {
  "kernelspec": {
   "display_name": "gis",
   "language": "python",
   "name": "python3"
  },
  "language_info": {
   "codemirror_mode": {
    "name": "ipython",
    "version": 3
   },
   "file_extension": ".py",
   "mimetype": "text/x-python",
   "name": "python",
   "nbconvert_exporter": "python",
   "pygments_lexer": "ipython3",
   "version": "3.13.15"
  }
 },
 "nbformat": 4,
 "nbformat_minor": 5
}
