ML-ready metadata · Croissant 1.1 · CC BY 4.0

Bopomofo ML Dataset - All 37 Zhuyin Symbols in Croissant 1.1

A small, deterministic reference dataset for AI agents, data catalogs and language-tool developers working with Taiwan Mandarin phonetics.

37 records12 documented fieldsCSV + JSONLCroissant 1.1 validated

Download the dataset

CSV is the canonical table loaded by the Croissant RecordSet. JSONL contains the same records, while the metadata file declares fields, checksums, stable identifiers and provenance.

Dataset schema

Each row represents one symbol. symbol_id is the unique key; concept_uri and category_uri connect the table to the companion SKOS vocabulary.

FieldTypeMeaning
ordersc:IntegerStable educational display order from 1 to 37.
symbol_idsc:TextASCII identifier derived from the uppercase Unicode code point.
concept_urisc:URLStable IRI for the symbol in the companion SKOS vocabulary.
symbolsc:TextThe Bopomofo character.
unicodesc:TextUnicode notation in U+XXXX form.
pinyinsc:TextHanyu Pinyin correspondence.
ipasc:TextBroad IPA transcription without brackets.
categorysc:TextOne of initial, medial or final.
category_urisc:URLIRI for the broader SKOS category concept.
example_charactersc:TextTraditional Chinese example character.
example_pinyinsc:TextTone-marked Pinyin for the example.
example_meaning_ensc:TextShort English meaning for the example.

Load with mlcroissant

The official Python reader can validate the metadata, fetch the CSV and yield each row from the symbols RecordSet.

import mlcroissant as mlc

dataset = mlc.Dataset(jsonld="https://alice51849.github.io/ios-app-guide/data/zhuyin-bopomofo-ml-dataset.croissant.jsonld")
records = dataset.records(record_set="symbols")
first = next(iter(records))

Intended uses

  • Bopomofo-aware text processing and Unicode normalization tests
  • Educational search, glossary and knowledge-graph prototypes
  • Data-catalog demonstrations and small interoperability fixtures
  • Joining tabular records to stable SKOS concept IRIs

Limitations and non-uses

  • Not an audio, speech or acoustic-training corpus
  • Not sufficient to train or benchmark Mandarin pronunciation models
  • Not a learner assessment or diagnostic dataset
  • Example mappings are compact reference aids, not full phonological rules

Preview all 37 records

OrderSymbolCategoryPinyinIPAExample
1Initialb[p]爸 (bà)
2Initialp[pʰ]怕 (pà)
3Initialm[m]媽 (mā)
4Initialf[f]飛 (fēi)
5Initiald[t]大 (dà)
6Initialt[tʰ]天 (tiān)
7Initialn[n]你 (nǐ)
8Initiall[l]來 (lái)
9Initialg[k]狗 (gǒu)
10Initialk[kʰ]看 (kàn)
11Initialh[x]好 (hǎo)
12Initialj[tɕ]家 (jiā)
13Initialq[tɕʰ]去 (qù)
14Initialx[ɕ]小 (xiǎo)
15Initialzh[ʈʂ]中 (zhōng)
16Initialch[ʈʂʰ]吃 (chī)
17Initialsh[ʂ]是 (shì)
18Initialr[ʐ]人 (rén)
19Initialz[ts]早 (zǎo)
20Initialc[tsʰ]菜 (cài)
21Initials[s]三 (sān)
22Mediali / yi[i]一 (yī)
23Medialu / wu[u]五 (wǔ)
24Medialü / yu[y]魚 (yú)
25Finala[a]大 (dà)
26Finalo[ɔ]波 (bō)
27Finale[ɤ]喝 (hē)
28Finalê[ɛ]誒 (ề)
29Finalai[ai]愛 (ài)
30Finalei[ei]給 (gěi)
31Finalao[au]好 (hǎo)
32Finalou[ou]有 (yǒu)
33Finalan[an]安 (ān)
34Finalen[ən]恩 (ēn)
35Finalang[aŋ]忙 (máng)
36Finaleng[əŋ]冷 (lěng)
37Finaler[ɚ]二 (èr)

License and privacy

The dataset and original metadata are reusable under CC BY 4.0 with attribution to Lumi Apps - iOS App Guide.

CC BY 4.0

No people, learner records, personal data, cookies, executable JavaScript or runtime API are included in the downloadable artifacts.

Questions

What is Croissant?

Croissant is an MLCommons JSON-LD format that describes dataset files, record structure, fields, provenance and usage conditions.

Do the CSV and JSONL files contain the same records?

Yes. Automated checks compare all 37 records and field values.

Does this dataset contain every Bopomofo symbol?

Yes. It contains 21 initials, 3 medials and 13 finals: 37 symbols.

Can this train a speech model?

No. It is a compact symbolic reference without audio, recordings or enough observations for speech-model training.

Optional game-based iPhone practice

Lumi Bopomofo offers a separate on-device way to practise Zhuyin through short activities. The open dataset remains free and independent.

View Lumi Bopomofo on the App Store