# Global Import-Export Route HS2 Flows (1995-2024)

Annual export flows between country pairs by HS2 product group, with the total value and number of active HS6 products.

## What one row represents
one year, exporter-importer route, and HS2 product group

## Included measures and context
- Annual export value in US dollars
- Exporter and importer country codes
- Active HS6 product count

## Metric notes
- HS2 is a two-digit Harmonized System product group.
- 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.
- 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.

- `year` — `uint16`
- `exporter_iso3` — `string`
- `importer_iso3` — `string`
- `hs2` — `string`
- `export_value_usd` — `float64`
- `active_hs6_count` — `uint64`

## Coverage and size
- Coverage: 1995-2024 annual observations where available
- Records: 23,935,967
- Parquet file size: 253 MB
- Release: 1.0.0
- SHA-256: `2a72a7e502c55da15fedd7eac219f42280e4a783c54f9fc47afce0a20a06695a`

## 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-route-hs2-year-flows-v1/
- Original dataset record: https://huggingface.co/datasets/yugalinks/import-export-route-hs2-year-flows-v1