# XWUIChartProportionalSymbolMap

`XWUIChartProportionalSymbolMap` is a thin wrapper around `XWUIChart` that fixes the chart `type` to `'proportionalSymbolMap'`, sizing a symbol (typically a circle) at each location so its area encodes the underlying value. Pass a `{ series }` data object and use it when magnitude matters across positions - bigger marker means bigger quantity - so relative scale reads at a glance. The `block` (1-4, clamped) and `size` (`sm` / `md` / `lg`) config set the variant and overall dimensions.

## Basic Usage

This example supplies two monthly series (Series A and Series B, Jan-Jun) at `md` size, with each value scaling the size of its plotted symbol.

```example
file: examples/BasicUsage.ts
html: examples/BasicUsage.html
title: Basic Usage
description: Two monthly series (Series A and Series B, Jan-Jun) drawn as proportional symbols at medium size.
```

## City Population by Metro

Major metro areas with each symbol sized by population in millions, so relative scale from Tokyo down to Lagos reads at a glance.

```example
file: examples/CityPopulationByMetro.ts
html: examples/CityPopulationByMetro.html
title: City Population by Metro
description: A single series of metro populations in millions sized as proportional symbols, large with data labels and interactivity.
```

## Earthquake Magnitude by Site

Peak quake magnitude per monitoring station this month set against its baseline, with marker size encoding magnitude.

```example
file: examples/EarthquakeMagnitudeBySite.ts
html: examples/EarthquakeMagnitudeBySite.html
title: Earthquake Magnitude by Site
description: This-month vs baseline peak magnitude across six stations as two series, interactive with a legend and an " M" unit.
```

```api
```