# USA, Puerto Rico and US Virgin Islands market-share intelligence by partner and HS6

Market-share, supplier, concentration, volatility, and corridor-signal measures for exports from USA, Puerto Rico and US Virgin Islands.

## What one row represents
one year, country pair, and HS6 product

## Included data
- Annual corridor exports
- Market share, supplier, and growth measures
- Distance, tariff, access, and concentration context

## Metric notes
- USD fields are monetary values denominated in US dollars.
- Country fields use three-letter ISO 3166-1 country codes.
- HS6 identifies a product at the six-digit Harmonized System level.
- Growth percentages compare reported values across the relevant periods; calculated and projected fields are identified in the schema.

## Fields
- `year` — `UInt16`
- `exporter_iso3` — `String`
- `importer_iso3` — `String`
- `hs_code` — `String`
- `your_market_share_pct` — `Float64`
- `your_share_change_pp` — `Nullable(Float64)`
- `market_imports_usd` — `Float64`
- `market_yoy_growth_pct` — `Nullable(Float64)`
- `market_cagr_3y_pct` — `Nullable(Float64)`
- `top_supplier_iso3` — `Nullable(String)`
- `top_supplier_share_pct` — `Nullable(Float64)`
- `your_share_gap_pp` — `Nullable(Float64)`
- `num_suppliers` — `Nullable(UInt16)`
- `market_hhi` — `Nullable(Float64)`
- `volatility_mean_usd` — `Nullable(Float64)`
- `volatility_stddev_usd` — `Nullable(Float64)`
- `volatility_cv` — `Nullable(Float64)`
- `max_drawdown_pct` — `Nullable(Float64)`
- `momentum_yoy_pct` — `Nullable(Float64)`
- `momentum_acceleration_pct` — `Nullable(Float64)`
- `anomaly_type` — `Nullable(String)`
- `anomaly_severity` — `Nullable(String)`
- `anomaly_z_score` — `Nullable(Float64)`
- `new_corridor_signal_type` — `Nullable(String)`
- `new_corridor_signal_strength` — `Nullable(Float64)`

## Coverage and size
- Coverage: 1995-2024 where reported
- Records: 12,967,150
- Parquet file size: 1.9 GB
- SHA-256: `f9dc59c5af7446a122203874a0a6ca8b2ceb8f144b85cf7ec7443467bb489878`

## Files
- `data.parquet` - complete dataset
- `manifest.json` - release metadata and checksums
- `schema.json` - field names, types, and metric notes
- `sample.json` - example records
- `README.md` - dataset documentation

## Read with Python
```python
import pandas as pd
data = pd.read_parquet("data.parquet")
print(data.head())
```

## Sources
- OECD Balanced International Merchandise Trade Statistics (BIMTS)
- Yugalinks calculated market and corridor context
- OECD Terms & Conditions: https://www.oecd.org/termsandconditions/