---
name: plot_kde_2d
kind: function
lang: py
domain: datascience
version: "1.0.0"
purity: impure
signature: "def plot_kde_2d(ax: Axes, xs: list[float] | np.ndarray, ys: list[float] | np.ndarray, cmap: str = 'magma', alpha: float = 0.35, thresh: float = 0.02, levels: int = 30, bw_adjust: float = 0.6) -> None"
description: "Dibuja un KDE 2D como contornos rellenos sobre un Axes de matplotlib usando seaborn.kdeplot. Si los arrays están vacíos retorna sin pintar."
tags: [visualization, kde, density, seaborn, matplotlib, datascience]
uses_functions: []
uses_types: []
returns: []
returns_optional: false
error_type: "error_go_core"
imports: ["numpy", "seaborn", "matplotlib"]
params:
  - name: ax
    desc: "matplotlib Axes sobre el que se dibuja la densidad."
  - name: xs
    desc: "Coordenadas X de los puntos (longitud o x proyectada)."
  - name: ys
    desc: "Coordenadas Y de los puntos (latitud o y proyectada)."
  - name: cmap
    desc: "Nombre del colormap de matplotlib para el relleno de densidad. Default 'magma'."
  - name: alpha
    desc: "Opacidad del overlay de densidad (0-1). Default 0.35."
  - name: thresh
    desc: "Umbral de densidad por debajo del cual no se dibujan contornos (0-1). Default 0.02."
  - name: levels
    desc: "Número de niveles de contorno. Default 30."
  - name: bw_adjust
    desc: "Factor de ajuste del ancho de banda del kernel. Valores < 1 producen estimaciones más detalladas. Default 0.6."
output: "None. Modifica el Axes in-place añadiendo los contornos de densidad."
tested: true
tests:
  - "50 puntos aleatorios no lanza excepción"
  - "arrays vacíos retorna sin error"
test_file_path: "python/functions/datascience/tests/test_plot_kde_2d.py"
file_path: "python/functions/datascience/plot_kde_2d.py"
source_repo: "internal:footprint_aurgi"
source_license: "internal-aurgi"
source_file: "ponderacion_isochronas/src/recomendador_centros.py:275"
---

## Ejemplo

```python
import matplotlib
matplotlib.use("Agg")
import matplotlib.pyplot as plt
import numpy as np
from datascience.plot_kde_2d import plot_kde_2d

rng = np.random.default_rng(42)
xs = rng.normal(0, 1, 200)
ys = rng.normal(0, 1, 200)

fig, ax = plt.subplots()
plot_kde_2d(ax, xs, ys, cmap="viridis", alpha=0.5)
fig.savefig("kde.png")
```

## Notas

Requiere seaborn y numpy. El parámetro `fill=True` se pasa a seaborn.kdeplot para renderizar contornos rellenos (disponible desde seaborn 0.11). Arrays vacíos se detectan con `np.asarray(xs).size == 0` antes de llamar a seaborn para evitar errores internos.
