# Advanced Visualizations

Density plots, heatmaps, and joint distributions for in-depth shot pattern analysis.

---

## KDE (Kernel Density Estimation)

Smooth contour plots showing shot concentration.

| Green | Red | Blue |
| :---: | :---: | :---: |
| ![Green](../_static/test_kde_green.png) | ![Red](../_static/test_kde_red.png) | ![Blue](../_static/test_kde_blue.png) |

```python
court.kdeplot(ax, x, y, cmap='bsu_green', levels=50, alpha=0.6)
```

**Colormaps**: `bsu_green`, `bsu_red`, `bsu_blue`

---

## Heatmap (Grid)

Frequency distribution across grid cells.

| Counts | Frequency (%) |
| :---: | :---: |
| ![Counts](../_static/test_heatmap_counts.png) | ![Frequency](../_static/test_heatmap_freq.png) |

```python
court.heatmap(ax, x, y, gridsize=8, statistic='frequency', half=True)
```

---

## Hexbin

Honeycomb-style density visualization.

| Full Court | Half Court |
| :---: | :---: |
| ![Full](../_static/test_heatmap_hex.png) | ![Half](../_static/test_heatmap_hex_half.png) |

```python
court.hexbin(ax, x, y, gridsize=20, cmap='bsu_green', half=True)
```

---

## Sonar Chart

Shot direction distribution from court zones.

| 6-Direction | 8-Direction | Custom |
| :---: | :---: | :---: |
| ![6-Dir](../_static/test_sonar_6dir.png) | ![8-Dir](../_static/test_sonar_8dir.png) | ![Custom](../_static/test_sonar_custom.png) |

```python
from BsuTennis import sonar_from_shots

sonar_from_shots(ax, shot_x, shot_y, shot_dx, shot_dy,
                 n_zones_x=3, n_zones_y=2, n_directions=6)
```

---

## Joint Plots

Court visualization with marginal distributions.

### Full Court (Two Players)

![Joint KDE](../_static/test_joint_kde.png)

```python
from BsuTennis import joint_plot

fig, ax = joint_plot(p1_x, p1_y, p2_x, p2_y, kind='kde', half=False)
```

### Half Court

| Scatter | Grid |
| :---: | :---: |
| ![Scatter](../_static/test_joint_half_scatter.png) | ![Grid](../_static/test_joint_grid.png) |

```python
fig, ax = joint_plot(x, y, kind='scatter', half=True)
fig, ax = joint_plot(x, y, kind='grid', half=True)
```

**Types**: `scatter`, `kde`, `grid`