# XWUIChartCorrelationHeatmap

A correlation heatmap (a matrix of pairwise correlation coefficients shaded by strength and sign): a fixed-type wrapper around `XWUIChart` that fills each cell of a grid with a colour mapped to its value, so strongly and weakly related pairs separate by hue and you can spot clusters at a glance. Pass `series` of rows, each carrying `{ x, y }` cells, plus a `block` preset (1-4) and `size` (`sm` / `md` / `lg`); the shared block config also exposes legend, grid, axis, data-label, and tooltip-formatter toggles. Use it to scan a whole correlation table for the standout relationships without reading every number.

## Basic Usage

A 5x7 grid of values fed to the correlation-heatmap renderer at the md size preset.

```example
file: examples/BasicUsage.ts
html: examples/BasicUsage.html
title: Basic Usage
description: Five rows of seven cells each, shaded by value so the grid reads as a coloured correlation field.
```

## Asset Return Correlation Heatmap

Pairwise return correlation across stocks, bonds, gold, oil, and REITs, shaded to expose diversifiers and tightly-linked pairs.

```example
file: examples/AssetReturns.ts
html: examples/AssetReturns.html
title: Asset Return Correlation Heatmap
description: A five-by-five correlation matrix of monthly asset-class returns, with the negative stock/bond pair and tight stock/REIT link standing out.
```

## Health Metric Correlation Heatmap

Correlations among cardiometabolic risk markers such as age, BMI, blood pressure, LDL, and HbA1c.

```example
file: examples/HealthMetrics.ts
html: examples/HealthMetrics.html
title: Health Metric Correlation Heatmap
description: A correlation matrix of cardiometabolic markers, shaded so the strongest clinical relationships surface at a glance.
```

```api
```