{
 "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 3 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": [
    "# Ocurrencias de una especie\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": "c554e753",
   "metadata": {
    "editable": true,
    "slideshow": {
     "slide_type": ""
    },
    "tags": []
   },
   "source": [
    "Práctica con datos vectoriales utilizando [GeoPandas](https://geopandas.org/) y [Matplotlib](https://matplotlib.org/) 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, descarga los datos de ocurrencias de cualquier especie marina (con presencia en la zona económica exclusiva de México).\n",
    "\n",
    "<img src=\"https://www.biodiversidad.gob.mx/media/1/pais/Mapa_RMP_2023.jpg\" alt=\"Áreas Marinas Prioritarias de México\" width=\"600\">\n"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "78b7527f",
   "metadata": {},
   "source": [
    "### Ocurrencias de **especificar especie** (**_nombre científico_**)\n",
    "\n",
    "Descripción general de la especie: \n",
    "\n",
    "<img src=\"https://static.inaturalist.org/photos/14004144/large.jpg\" alt=\"Lepidochelys olivacea\" width=\"300\"> <p><em>Opcional: inserta una imagen de la especie específica.</em></p> \n",
    "\n",
    "Instrucciones:\n",
    "\n",
    "- Descargar los datos de ocurrencia cualquier especie con presencia en la zona económica exclusiva de México, en formato CSV ([https://www.gbif.org](https://www.gbif.org/)).\n",
    "\n",
    "- Crea el script `01_occurrencias_v1.ipynb` (basandose en los script `01_sismos_v1.ipynb` y `01_sismos_v2.ipynb`).\n",
    "\n",
    "- Asegúrate que el entorno de trabajo está correctamente configurado para ejecutar el script (activando el entorno virtual  `gis`).\n",
    "\n",
    "- Genera un mapa (PNG #1) con todas las ocurrencias de la especie en el mundo, así como un acercamiento a las regiones marinas prioritarias de México (PNG #2). En ambos casos muestra la barra de color que indique el año del registro de las ocurrencias.\n",
    "    \n",
    "- Genera un mapa (PNG #3) que muestre el número de ocurrencias en cada [área marinas prioritaras de México](https://www.gob.mx/semarnat/documentos/areas-marinas-prioritarias-de-mexico).\n",
    "\n",
    "- Genera una gráfica de barras (PNG #4) que muestre en número de ocurrencias por cada área marina prioritaria de México.\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. Además, subir los 4 archivos PNG generados."
   ]
  },
  {
   "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 geopandas as gpd\n",
    "import matplotlib.pyplot as plt\n",
    "import pandas as pd"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "46177b7c",
   "metadata": {},
   "source": [
    "### Leer datos de ocurrencias de la especie\n",
    "\n",
    "En esta sección se leerán los datos de ocurrencias de la especie seleccionada desde un archivo CSV."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "id": "506ff416",
   "metadata": {},
   "outputs": [],
   "source": [
    "fn = 'data/tu-archivo.csv' # Especificar del archivo descargado de GBIF\n",
    "df_occ = pd.read_csv(fn, sep='\\t',usecols=['decimalLongitude', 'decimalLatitude', 'year']) # Especificar las columnas a leer (verificar)"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "cc7f72d9",
   "metadata": {},
   "source": [
    "### Mostrar la ubicación de los avistamientos   "
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "id": "422380a1",
   "metadata": {},
   "outputs": [],
   "source": [
    "# Escribir el código aquí"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "c948d1fd",
   "metadata": {},
   "source": [
    "### Obtener los límites administrativos   \n",
    "\n",
    "Acceso a los datos de límites administrativos de los paises  [Natural Earth](https://www.naturalearthdata.com/)) y de las regionaes marinas prioritarias de México (https://www.gob.mx/semarnat/documentos/areas-marinas-prioritarias-de-mexico).\n",
    "\n",
    "Incluye la lectura de los datos de fronteras los estados de México (que se guardaron previamente en un archivo geopackage)."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "id": "e8ee52e5",
   "metadata": {},
   "outputs": [],
   "source": [
    "# Escribir el código aquí"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "df21c31f",
   "metadata": {},
   "source": [
    "### Mostar la capa  `countries` y superponer la ubicación de los avistamientos\n"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "id": "53ab734b",
   "metadata": {},
   "outputs": [],
   "source": [
    "# Escribir el código aquí"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "d8764832",
   "metadata": {},
   "source": [
    "### Acercamiento (mapa que incluya las regiones marinas) a los avistamientos en México\n",
    "\n",
    "Crea el GeoDataFrame (GeoPandas) a partir de las columnas de latitud y longitud.\n",
    "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": [
    "# Escribir el código aquí"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "7bb7028d",
   "metadata": {},
   "source": [
    "### Estadísticas por área marina (`sjoin`y `groupby`)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "id": "a41a3fb4",
   "metadata": {},
   "outputs": [],
   "source": [
    "# Escribir el código aquí"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "aaf70abe",
   "metadata": {},
   "source": [
    "### Mostrar la gráfica del número de ocurrencias por área marina"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "id": "0eadd14c",
   "metadata": {},
   "outputs": [],
   "source": [
    "# Escribir el código aquí"
   ]
  },
  {
   "cell_type": "markdown",
   "id": "5f57b40d",
   "metadata": {},
   "source": [
    "### Mostrar el mapa del número de ocurrencias por área marina (`merge`)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "id": "444dd7c7",
   "metadata": {},
   "outputs": [],
   "source": [
    "# Escribir el código aquí"
   ]
  }
 ],
 "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
}
