# USA, Puerto Rico and US Virgin Islands enriched corridor history by partner and HS6

Annual export corridors from USA, Puerto Rico and US Virgin Islands with growth, access, tariff, distance, and partner context for HS6 products.

## 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`
- `export_value_usd` — `Float64`
- `yoy_growth_pct` — `Nullable(Float64)`
- `cagr_3y_pct` — `Nullable(Float64)`
- `substitution_elasticity` — `Nullable(Float64)`
- `distance_km` — `Nullable(Float64)`
- `shares_land_border` — `Nullable(UInt8)`
- `shares_official_language` — `Nullable(UInt8)`
- `has_fta` — `Nullable(UInt8)`
- `avg_applied_tariff_pct` — `Nullable(Float64)`

## Coverage and size
- Coverage: 1995-2024 where reported
- Records: 12,967,150
- Parquet file size: 418 MB
- SHA-256: `90b6faa97b635c82ad1d37f32001252a426c1959b46be57c9d87b833b2c8ad44`

## 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/