# Global Import-Export Lane Risk Monitor (1995-2024)

A detailed exporter-importer route view for HS6 products, combining buyer demand, export position, competition, tariffs, market access, and labeled risk indicators.

## What one row represents
one exporter-importer route and HS6 product

## Included measures and context
- Buyer imports and exporter sales/share measures
- Demand, competition, volatility, and drawdown labels
- Tariffs, agreements, and selected buyer-market context

## Metric notes
- HS6 codes identify products at the six-digit Harmonized System level.
- CAGR is the compound annual growth rate across a multi-year period.
- Year-over-year growth compares a value with the previous year; a negative percentage indicates a decline.
- Fields marked USD are monetary values denominated in US dollars.
- Count fields report the number of items named in the field, such as products, partners, or routes.
- Values ending in pp are percentage-point changes.
- Values ending in pct are percentages.
- Country fields ending in ISO3 use three-letter ISO 3166-1 country codes.

## Fields
Column names are shown exactly as they appear in the Parquet file. The schema lists the same fields, and the sample file shows example values.

- `exporter_iso3` — `string`
- `importer_iso3` — `string`
- `hs_code` — `string`
- `hs_description` — `string`
- `hs_chapter` — `string`
- `hs_heading` — `string`
- `price_range_label` — `string`
- `trade_type_label` — `string`
- `substitution_elasticity` — `float64`
- `buyer_imports_latest_usd` — `float64`
- `buyer_imports_avg_usd` — `float64`
- `buyer_imports_peak_usd` — `float64`
- `buyer_cagr_full_pct` — `float64`
- `buyer_yoy_avg_pct` — `float64`
- `buyer_yoy_latest_pct` — `float64`
- `buyer_trend_consistency_pct` — `float64`
- `buyer_imports_proj_3y_usd` — `float64`
- `buyer_imports_proj_5y_usd` — `float64`
- `buyer_gdp_mn_latest` — `float64`
- `buyer_gdp_pc_latest` — `float64`
- `buyer_population_latest` — `float64`
- `buyer_investment_rate` — `float64`
- `buyer_savings_rate` — `float64`
- `buyer_edu_secondary` — `float64`
- `buyer_gdp_mn_2030_proj` — `float64`
- `buyer_gdp_pc_2030_proj` — `float64`
- `buyer_gdp_pc_growth_pct` — `float64`
- `buyer_gdp_mn_growth_pct` — `float64`
- `buyer_pop_growth_pct` — `float64`
- `exports_latest_usd` — `float64`
- `exports_avg_usd` — `float64`
- `exports_peak_usd` — `float64`
- `share_latest_pct` — `float64`
- `share_avg_pct` — `float64`
- `share_peak_pct` — `float64`
- `share_change_1y_pp` — `float64`
- `share_trend_pp_per_yr` — `float64`
- `cagr_full_pct` — `float64`
- `yoy_avg_pct` — `float64`
- `yoy_latest_pct` — `float64`
- `trend_consistency_pct` — `float64`
- `exports_proj_3y_usd` — `float64`
- `exports_proj_5y_usd` — `float64`
- `your_share_gap_pp` — `float64`
- `addressable_proj_3y_usd` — `float64`
- `addressable_proj_5y_usd` — `float64`
- `peer_best_share_pct` — `float64`
- `peer_top_exporter` — `string`
- `num_suppliers_latest` — `uint16`
- `buyer_herfindahl_index` — `float64`
- `distance_km` — `float64`
- `shares_official_language` — `uint8`
- `common_spoken_language_score` — `float64`
- `has_wto_reported_fta` — `uint8`
- `buyer_is_eu_member` — `uint8`
- `buyer_biz_entry_days` — `float64`
- `shared_legal_system` — `uint8`
- `shared_religion` — `uint8`
- `shares_land_border` — `uint8`
- `buyer_is_wto_member` — `uint8`
- `lane_volatility_cv` — `float64`
- `lane_max_drawdown_pct` — `float64`
- `signal_flag` — `string`
- `lane_data_years` — `uint16`
- `lane_last_year` — `uint16`
- `access_data_year` — `uint16`
- `avg_applied_tariff_pct` — `float64`
- `avg_mfn_tariff_pct` — `float64`
- `avg_preferential_tariff_pct` — `float64`
- `tariff_advantage_pp` — `float64`
- `rta_coverage_ratio` — `float64`
- `buyer_macro_latest_year` — `uint16`
- `buyer_gdp_5y_cagr_pct` — `float64`
- `buyer_gdp_pc_5y_cagr_pct` — `float64`
- `buyer_population_5y_cagr_pct` — `float64`
- `buyer_investment_5y_avg_pct` — `float64`
- `buyer_savings_5y_avg_pct` — `float64`
- `current_below_peak_usd` — `float64`
- `current_below_peak_pct` — `float64`
- `latest_vs_historical_avg_pct` — `float64`
- `share_change_all_pp` — `float64`
- `volatility_label` — `string`
- `drawdown_label` — `string`
- `competition_label` — `string`
- `demand_label` — `string`
- `access_label` — `string`
- `macro_resilience_label` — `string`
- `risk_driver_labels` — `List`
- `risk_driver_count` — `uint8`
- `attention_level` — `string`
- `primary_risk_reason` — `string`

## Coverage and size
- Coverage: 1995-2024 annual observations where available
- Records: 2,755,418
- Parquet file size: 605 MB
- Release: 1.0.0
- SHA-256: `9348ba38c90f32701226e369c5153df57cb963fe1db46910f1ceac888d5622fd`

## Files
- `data.parquet` — complete dataset
- `manifest.json` — dataset description, coverage, record count, and download details
- `schema.json` — field names, row definition, included measures, and metric notes
- `sample.json` — example records
- `README.md` — these notes

## Read the Parquet file with Python
```python
import pandas as pd

data = pd.read_parquet("data.parquet")
print(data.head())
```

Install `pandas` and `pyarrow` if they are not already available: `python -m pip install pandas pyarrow`.

## Sources and related files
- OECD BIMTS HS2017-6D
- CEPII where included
- Dataset page: https://www.yugalinks.com/datasets/import-export/import-export-lane-risk-monitor-v1/
- Original dataset record: https://huggingface.co/datasets/yugalinks/import-export-lane-risk-monitor-v1