{
 "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",
    "        Sistemas de Información Geográfica<br>\n",
    "        Python | Práctica 2 Datos vectoriales\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": "ab47a1a5",
   "metadata": {},
   "source": [
    "# Datos vectoriales (parte 2)   \n",
    "\n",
    "<img src=\"https://geopandas.org/en/v1.1.1/_images/geopandas_logo.png\" width=\"25%\" alt=\"Logo de GeoPandas\">"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "78b7527f",
   "metadata": {},
   "source": [
    "## Agrupación de los sismos en México\n",
    "\n",
    "Se utilizan los archivos `gpkg` guardados con el script `01_sismos_v1.ipynb`, para agrupar los sismos por estado en México (funciones de GeoPandas `sjoin`, `groupby` y `merge`), así como en una malla hexagonal (`hexbin`) para la visualización de la densidad de sismos.\n",
    "\n",
    "- Documentar el script con los comentarios pertinentes de acuerdo con los datos y procedimientos utilizados.\n",
    "\n",
    "- Como evidencia, adjuntar en Teams el script actualizado. También, subir los archivos PNG generados.\n"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "f379de49",
   "metadata": {},
   "source": [
    "### Importar las bibliotecas necesarias   "
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "id": "caf2fbd5",
   "metadata": {},
   "outputs": [],
   "source": [
    "import matplotlib.pyplot as plt\n",
    "import geopandas as gpd"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "46177b7c",
   "metadata": {},
   "source": [
    "### Leer los archivos gpkg\n",
    "\n",
    "Archivos GeoPackage `mexico.gpkg` y `gdf_sismos_mexico.gpkg`, así como los límites administrativos de los paises.\n"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "id": "c948d1fd",
   "metadata": {},
   "outputs": [],
   "source": [
    "mexico = gpd.read_file(\"data/mexico.gpkg\", layer=\"mexico\")\n",
    "gdf_sismos_mexico = gpd.read_file(\"data/gdf_sismos_mexico.gpkg\", layer=\"gdf_sismos_mexico\")\n",
    "\n",
    "# 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",
    "# Eliminamos el polgígono correspondiente a México de la capa de países (para no duplicar la geometría de México)\n",
    "countries = countries[countries['ADMIN'] != 'Mexico']"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "d5607d98",
   "metadata": {},
   "source": [
    "### Sismos por estado\n",
    "\n",
    "[`Spatial join`](https://geopandas.org/en/stable/docs/reference/api/geopandas.sjoin.html): Un caso de uso es la unión espacial entre una capa de puntos y una capa de polígonos, en donde se desea conservar las geometrías de los puntos y obtener los atributos de los polígonos que se intersecan.\n",
    "\n",
    "Se busca asignar cada sismo a un estado (si está ubicado dentro de sus límites).\n",
    "\n",
    "![Spatial Join en GeoPandas](img/diagrama_spatial_join.png)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "id": "acb7f977",
   "metadata": {},
   "outputs": [],
   "source": [
    "# Primero seleccionamos las columnas que necesitamos (tanto del DataFrame de sismos como del de estados)\n",
    "gdf_sismos_mexico = gdf_sismos_mexico[['geometry', 'latitude', 'longitude', 'time', 'mag']]\n",
    "mexico = mexico[['geometry', 'name']]\n",
    "\n",
    "# Realizamos la unión espacial para asignar cada sismo a un estado\n",
    "sismos_por_estado = gpd.sjoin(gdf_sismos_mexico, mexico, how='left', predicate='within')\n",
    "\n",
    "# Eliminamos los sismos que no se encuentran dentro de algún estado\n",
    "sismos_por_estado = sismos_por_estado.dropna(subset=['name'])\n",
    "\n",
    "# Mostramos los primeros registros para verificar\n",
    "sismos_por_estado.head()"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "6e95888c",
   "metadata": {},
   "source": [
    "### Calcular estadísticas de la magnitud de los sismos por estado\n",
    "\n",
    "Agrupar (`groupby`) los sismos por estado y calcular estadísticas como el conteo, promedio, mínimo, máximo y desviación estándar de la magnitud, así como la ubicación promedio de los sismos.\n"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "id": "92355595",
   "metadata": {},
   "outputs": [],
   "source": [
    "estadisticas = sismos_por_estado.groupby('name').agg({\n",
    "    'mag': ['count', 'mean', 'min', 'max', 'std'],\n",
    "    'latitude': 'mean',\n",
    "    'longitude': 'mean'\n",
    "}).round(2)\n",
    "\n",
    "estadisticas.head(10)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "id": "cf7f6468",
   "metadata": {},
   "outputs": [],
   "source": [
    "# Renombar las columnas\n",
    "estadisticas.columns = ['total_sismos', 'mag_promedio', 'mag_min', 'mag_max', 'desv_est', 'lat_centro', 'lon_centro']\n",
    "\n",
    "# Ordenar por número de eventos\n",
    "estadisticas = estadisticas.sort_values('total_sismos', ascending=False)\n",
    "\n",
    "estadisticas.head()\n",
    "# Si quieres exportar a CSV\n",
    "#estadisticas.to_csv('output/sismos_por_estado.csv')"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "f2f69644",
   "metadata": {},
   "source": [
    "### Gráfico de barras del número de sismos por estado\n"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "id": "5201337e",
   "metadata": {},
   "outputs": [],
   "source": [
    "estadisticas['total_sismos'].sort_values(ascending=True).plot(kind='barh', figsize=(10, 8))\n",
    "plt.xlabel('Total de sismos')\n",
    "plt.ylabel('Estado')\n",
    "plt.title('Número de sismos por estado en México')\n",
    "plt.tight_layout()\n",
    "plt.show()"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "c0ee4c87",
   "metadata": {},
   "source": [
    "### Mapa de sismos por estado\n",
    "\n",
    "Mapa de cloropetas de sismos por estado. Se utiliza la función `merge` para combinar el GeoDataFrame de los estados con el DataFrame de estadísticas de sismos por estado.\n",
    "Los estados que no tienen sismos (NaN) se rellenan con 0 en la columna 'total_sismos'."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "id": "081177e6",
   "metadata": {},
   "outputs": [],
   "source": [
    "# Unir el DataFrame de los estados con el de las estadísticas\n",
    "estado_con_sismos = mexico.merge(estadisticas, left_on='name', right_index=True, how='left')\n",
    "estado_con_sismos['total_sismos'] = estado_con_sismos['total_sismos'].fillna(0) # Rellenar con 0 los estados sin sismos\n",
    "\n",
    "# Mostar el mapa de sismos por estado\n",
    "fig, ax = plt.subplots(figsize=(10, 8))\n",
    "ax.set_facecolor('lightblue')\n",
    "\n",
    "# División política\n",
    "countries.plot(ax=ax, color='lightgrey', edgecolor='black')\n",
    "\n",
    "# Estados con el color según la cantidad de sismos\n",
    "estado_con_sismos.plot(\n",
    "    ax=ax,\n",
    "    column='total_sismos',  # Colorear por este valor\n",
    "    cmap='YlOrRd',          # Colormap: amarillo-naranja-rojo\n",
    "    legend=True,\n",
    "    scheme='naturalbreaks',\n",
    "    legend_kwds={'title': 'Total de sismos'},\n",
    "    edgecolor='black',\n",
    "    linewidth=0.5\n",
    ")\n",
    "\n",
    "ax.set_title('Distribución de sismos por estado en México', fontsize=14, fontweight='bold')\n",
    "ax.set_xlabel('Longitud')\n",
    "ax.set_ylabel('Latitud')\n",
    "\n",
    "# Acotar los límites del mapa \n",
    "ax.set_xlim([-118.0, -86.0])\n",
    "ax.set_ylim([14.0, 33.0])\n",
    "\n",
    "plt.tight_layout()\n",
    "plt.show()"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "6a2fd2e8",
   "metadata": {},
   "source": [
    "### Número de sismos por hexágono (en una malla de hexágonos)\n",
    "\n",
    "La función `hexbin()` divide el mapa en una malla de hexágonos y cuenta el número de eventos sísmicos que caen dentro de cada hexágono. En lugar de graficar puntos individuales (lo que crearía un desorden de superposiciones), cada hexágono se colorea según cuántos sismos ocurrieron en esa región. Esto revela zonas geográficas donde la actividad sísmica está concentrada."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "id": "757f759b",
   "metadata": {},
   "outputs": [],
   "source": [
    "figure, ax = plt.subplots(figsize=(10, 8))\n",
    "\n",
    "# División política\n",
    "countries.plot(ax=ax, color='lightgrey')\n",
    "mexico.plot(ax=ax, color=\"#e6d2a1\", edgecolor='black',linewidth=0.5)\n",
    "\n",
    "# Malla hexagonal con la densidad de sismos\n",
    "ax.hexbin(\n",
    "    gdf_sismos_mexico.longitude, \n",
    "    gdf_sismos_mexico.latitude, \n",
    "    gridsize=60,         # Cantidad de hexágonos a lo largo del mapa (del eje x)\n",
    "    cmap=\"jet\", \n",
    "    alpha=0.6, \n",
    "    mincnt=1,             # No dibuja hexágonos donde no hubo sismos (mínimo conteo de 1)    \n",
    ") \n",
    "\n",
    "# Agregar la barra de color \n",
    "cb = plt.colorbar(ax.collections[2], ax=ax, shrink=0.5)\n",
    "cb.set_label(\"Cantidad de sismos\")\n",
    "\n",
    "ax.set_xlabel(\"Longitud\")\n",
    "ax.set_ylabel(\"Latitud\")\n",
    "ax.set_title(\"Hexbin de sismos en México (2010-2025)\")\n",
    "\n",
    "# Acotar los límites del mapa \n",
    "ax.set_xlim([-118.0, -86.0])\n",
    "ax.set_ylim([14.0, 33.0])\n",
    "\n",
    "plt.tight_layout()\n",
    "plt.show()"
   ]
  }
 ],
 "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
}
