data/jlpt/README.md

# data/jlpt - JLPT vocabulary levels and kanji levels, pinned

Generated by `scripts/build_jlpt.py`. **Do not hand-edit these files**:
`tests/test_data_assets.py` compares every file with the SHA-256 below and pins the
counts, so an edit fails the quick loop until this file is regenerated.

**Resolved:** 2026-09-06  
**Pins:** stephenmk/yomitan-jlpt-vocab release tag `2025.08.01.0` (vocabulary); davidluzgouveia/kanji-data commit `00fd7079c3890f430759536f91aa5e854ec0ca4f` (kanji levels)

Regenerate (from the repo root; re-running is idempotent - byte-identical files):

```
.venv/Scripts/python.exe scripts/build_jlpt.py
```

## Files

| File | Bytes | SHA256 | Source |
|---|---|---|---|
| `n5.csv` | 24,010 | `c370961f92087e15d059548e1b3d01bab714306c739b3f3caa0adfa921d679ed` | https://raw.githubusercontent.com/stephenmk/yomitan-jlpt-vocab/2025.08.01.0/original_data/n5.csv |
| `n4.csv` | 24,772 | `a14dcc7fdc02259b22331a486c6ff66df74c16472c8aeb5a0ebe7e5fa8ee8eb4` | https://raw.githubusercontent.com/stephenmk/yomitan-jlpt-vocab/2025.08.01.0/original_data/n4.csv |
| `n3.csv` | 88,623 | `bd4d68c59cfee861351e1bdf9d99818e434392201eabbed4d3657225fe53a3ac` | https://raw.githubusercontent.com/stephenmk/yomitan-jlpt-vocab/2025.08.01.0/original_data/n3.csv |
| `n2.csv` | 95,356 | `42a4413326e857d701dc9659b2711637ab612304a339fe0d09f4f0f042d3a214` | https://raw.githubusercontent.com/stephenmk/yomitan-jlpt-vocab/2025.08.01.0/original_data/n2.csv |
| `n1.csv` | 199,103 | `7a58f0584e9ec2b0299ccb9b109f3bd03e08b90d129a714307c0a1cb72f07b32` | https://raw.githubusercontent.com/stephenmk/yomitan-jlpt-vocab/2025.08.01.0/original_data/n1.csv |
| `kanji_levels.json` | 28,746 | `de0761e2b218a81c2e58950fc89b56da9b924e056285befaf3d1d1becef7a4c4` | `jlpt_new` of https://raw.githubusercontent.com/davidluzgouveia/kanji-data/00fd7079c3890f430759536f91aa5e854ec0ca4f/kanji.json |
| `LICENSE-yomitan-jlpt-vocab.txt` | 20,131 | `7abe19ec9bb73b36141b999b861d24ad855e808bafe0f81e84cce28556f6c297` | https://raw.githubusercontent.com/stephenmk/yomitan-jlpt-vocab/2025.08.01.0/LICENSE.txt |
| `LICENSE-kanji-data.txt` | 1,070 | `4c4fe92a5adf9df114ca9f04e50329d4565c3ce511660e934cb01eb110e2ca6e` | https://raw.githubusercontent.com/davidluzgouveia/kanji-data/00fd7079c3890f430759536f91aa5e854ec0ca4f/LICENSE |

The CSVs are the upstream files byte-for-byte (columns `jmdict_seq,kana,kanji,`
`waller_definition`; `jmdict_seq` is the JMdict entry id, so word level is a join on
id, not a string match). `kanji_levels.json` is this script's projection of
the `jlpt_new` field of `kanji.json`: `{literal: N5..N1}` for every kanji that has a
level, sorted by literal. `jlpt_new` is the N1-N5 scale; the file's `jlpt_old` is
KANJIDIC2's pre-2010 1-4 scale and is NOT used (02-RESEARCH.md § Q2 - Kanji list).

## Counts

| Measure | Value |
|---|---|
| `n5.csv` data rows | 684 |
| `n4.csv` data rows | 640 |
| `n3.csv` data rows | 1,730 |
| `n2.csv` data rows | 1,812 |
| `n1.csv` data rows | 3,427 |
| Total data rows | 8,293 |
| Rows with an empty `jmdict_seq` (all in `n1.csv`) | 14 |
| Unique `jmdict_seq` ids | 7,748 |
| Ids appearing in more than one row | 505 |
| Ids appearing on more than one level | 447 |
| Ids listed twice within one level (two readings) | 71 |
| Kanji at N5 | 79 |
| Kanji at N4 | 166 |
| Kanji at N3 | 367 |
| Kanji at N2 | 367 |
| Kanji at N1 | 1,232 |
| Kanji with a level | 2,211 |

A word on two lists takes the easiest level it appears at (research § Q2 - Join
strategy); a word on no list is `N1+`; a kanji not in the map is unlisted and above
every level (D-02, D-10).

## Licence

JLPT levels: Jonathan Waller's JLPT Resources (https://www.tanos.co.uk/jlpt/, CC BY) via stephenmk/yomitan-jlpt-vocab (CC BY-SA 4.0); kanji levels extracted from davidluzgouveia/kanji-data (MIT) which took its levels from the same Waller lists. There is no official JLPT vocabulary list; these are estimates.

- `LICENSE-yomitan-jlpt-vocab.txt` is the repository's `LICENSE.txt` at the tag (CC BY-SA
  4.0). Any redistributed derivative of the CSVs stays CC BY-SA.
- `LICENSE-kanji-data.txt` is the repository's `LICENSE` at the commit (MIT); the notice
  is kept beside the extracted file as MIT requires.
- Jonathan Waller's terms (https://www.tanos.co.uk/jlpt/sharing/): use however you like,
  credit the site. `LICENSES.md` at the repo root is the project-wide record and the
  page's credits line carries the attribution (plan 02-11).