FAIR 2020 · Interactive explainer

Picking 100 million words that stand for Vietnamese

Language models learn whatever their text teaches them, and Vietnamese had large text collections but no balanced, general corpus. This paper sets out the criteria for deciding what goes in, then applies them to VnC 1.0: about 100 million words, 90% written and 10% transcribed speech, mostly from 2000 onwards.

What does a corpus keep from one news story?

One short sports-news sentence, as a reader sees it and as the corpus stores it. Step through the three views.

“The referee stopped the match when the athlete was injured.”

The sentence is illustrative, written for this page from the sports words the paper names (trận đấu, trọng tài, vận động viên). Its labels follow the paper’s Tables 1–3. This sentence follows us through the page.

≈100 millionwords in VnC 1.0 (99,921,258 counted in Tables 3–4)
89,790,952written words in 31 groups
10,130,306spoken words, transcribed, in 6 groups
146,052texts in total
6,930words of speech from Central Vietnam, the thinnest cell
1 · The gap

A pile of text is not a corpus

Language technology learns from examples. To find how Vietnamese is really used, which words are common or how sentences are built, researchers count things in a . We follow Sinclair: a corpus is a set of text samples chosen systematically, by stated criteria, so that it stands for a particular kind of language.

The key words are “chosen” and “stands for”. A collection scraped from one news website is large, but it speaks only like that website. A has to be and .

Think of it asAn opinion poll. A poll of 1,000 people can describe a country only if those 1,000 are picked to match it: regions, ages, jobs. A corpus is a poll of a language’s texts.

The model for this kind of design is the British National Corpus (BNC): 100 million words of late-20th-century British English, written and spoken, built from 1991 by Oxford University Press, Longman and partners.

What does a balanced corpus look like inside?

The BNC splits every text along several dimensions. Pick one; tap a slice to read it.

Paper’s Figures 1 and 2 (from the BNC Reference Guide). Notice that no slice of the written domains passes 20%: the text is spread on purpose.

Vietnamese had big collections, but none built to be balanced

The paper lists five earlier Vietnamese corpora. Some are huge; Le and Quasthoff’s holds 4.05 billion words. But their text comes mostly from online newspapers and the web, they count size in different units, and none describes itself as a balanced, general corpus or includes speech.

What did each Vietnamese corpus cover before VnC?

Sizes are given in the unit each source reports. Highlight a property to see who has it.

Section II of the paper. The VTB size (“over 300 sentences”) is as printed in the paper. The BNC row is the English reference point.

2 · The criteria

Seven decisions to make before collecting a single word

The core of the paper is a checklist. It gathers advice from corpus linguistics (Sinclair, Biber, Atkins and colleagues, Wynne’s guide) into seven criteria, and says how each was applied to VnC 1.0.

Start with a few simple, feasible dimensions

First come general criteria that describe any text: its mode (written or spoken), genre, domain, where it comes from, its language, and when it was made. The advice is to start simple, drop criteria that overlap, and check that each one can be collected in practice. Spoken text, for example, is only possible if someone can record and it.

Each criterion splits the corpus into , and every component needs enough text of its own. That is where size comes in.

Why does each extra criterion make the corpus bigger?

Switch on VnC 1.0’s general criteria (Table 1). Each one multiplies the number of cells to fill. Then set how many words a cell needs.

36cells to fill
500,000

Criteria and their options: paper’s Table 1. The per-cell minimum is illustrative; the paper gives no number. Its point is the trade-off: too few criteria and the corpus is not representative, too many and it must grow very large.

Representativeness is a six-step plan, and the last step matters most

No corpus can contain a whole language, so “representative” has to be planned. The paper adopts a six-step procedure from Wynne’s guide to good practice.

How do you plan a representative corpus?

Tap a step, or use Next. Each step shows where VnC 1.0 answers it in the paper.

Section III.A.3 of the paper, after Wynne (2005). Step 6 is the key one: users will run studies the builders never imagined, and a written record lets them trace an odd result back to how texts were chosen.

Balance means more than mixing genres

Balance is even vaguer than representativeness, and the paper notes that many general corpora fall short simply because they hold too little speech. Beyond mode and genre, it names four axes to keep in proportion:

Who writes and who readsAuthors’ gender, age, social status; audiences from the general public to small groups, at different levels of formality.
What it is aboutSpecialised texts (humanities, law, education, economics…) next to general-interest ones (health, popular science…).
When it was madeA wide enough time span that words appear across periods. VnC targets 90% from 2000 onwards.
Where it comes fromWhere a text was published or spoken, so standard and local words, and the dialects, appear in fair ratio.

Balanced does not mean equal shares

A common misreading is that a balanced corpus gives every category the same percentage. The paper does not define balance that way. It asks that balance be checked across several factors: who writes and who reads, content, time of production and region (§III.A.4, citing Wynne [14]). Its representativeness plan then sets a target size for each text type from that type’s importance and how practical it is to collect (§III.A.3, step 4 [14]). Shares produced by these rules are not equal. The equal-share comparison below is our own illustration.

Not what the paper describesEvery category gets the same share, regardless of its importance or how practical it is to collect. (Our reading of §III.A.3–4 [14].)
What the paper describesEvery category is included, and its target size is set from importance and feasibility, then written down so users can check it (§III.A.3, steps 4 and 6 [14]).

What would “equal shares” look like next to real balanced corpora?

Pick a dimension. The top bar splits it evenly; the bottom bar is what the corpus actually holds.

If equal
Actual

VnC shares: Tables 3–4, summed by us. Planned 90/10 split: §IV. BNC shares: Figures 1–2 of this paper, from the BNC Reference Guide [12]. “If equal” rows and the 50 million figure are our arithmetic, not the paper’s. Central speech: Table 4 and §IV.A.2.

Topic is hard to fix in advance. We suggest starting from common topic lists and adjusting to what can be collected. For academic writing in VnC 1.0 we aimed at humanities, medicine, natural sciences, education, law, politics, social sciences, engineering, informatics and technology.

Homogeneity: a stack of score tables can skew a whole genre

Within a genre, pick typical texts and avoid odd ones. We give an example from our own collecting: some sports-news pages list only football scores. Collect too many of those, and a study of “sports news” would conclude that number words are its most frequent nouns, instead of words like trận đấu (match), trọng tài (referee) and vận động viên (athlete).

What happens to “sports news” when score tables sneak in?

Ten pages are sampled for the genre. Drag to swap typical reports for results-only pages and watch which kind of word dominates.

Typical report
Results-only page
2 of 10
Sports vocabulary Numbers Other words

Both texts are illustrative, built around the paper’s example (Section III.A.7); word counts are taken from these two texts. In real VnC data, national-newspaper sports is one group of 4,666 texts and 1,715,152 words (Table 3).

Choose by the label on the cover, not by the words inside

describe a text’s situation and can be judged without reading it: the author’s gender, age or job, the context. are about the language itself: vocabulary, syntax. Choosing only by internal features loses the link between language and context; choosing only by external ones can hide linguistic differences. The paper’s advice for a new corpus is to select mainly by external criteria, then add internal ones later. VnC 1.0 does exactly that.

Can you tell external criteria from internal ones?

Sort each feature, then see the external criteria VnC 1.0 actually records.

External

Can be judged without reading the text.

Internal

Needs the language itself.

Feature examples from Section III.B; the full list of external criteria is the paper’s Table 2. External criteria differ by mode: written texts get six, spoken texts three.

3 · Building VnC 1.0

From a checklist to a hundred million words

With the criteria set, the team picked the simple, feasible ones and collected. The plan: about 90 million written and 10 million spoken words, from Vietnamese speakers in all three regions, with about 90% of the text from 2000 onwards.

How did VnC 1.0 get built?

Five steps from criteria to corpus. Our sports sentence rides along.

Sections III–IV and Tables 1, 3 and 4. Totals across groups are computed from Tables 3 and 4; the paper states the rounded figures (≈90M written, ≈10M spoken).

The plan held. Adding up the two tables gives 89,790,952 written and 10,130,306 spoken words, so speech makes up 10.14% of the 99,921,258 words counted. The paper does not give a word count by period, so the 90% post-2000 target cannot be checked from the tables.

4 · What’s inside

Fiction and unlabelled text fill most of the written side

The written part is split into 31 groups by genre and domain. Before looking, make a guess.

What share of VnC’s written words come from novels and short stories?

Drag to your guess, then reveal.

Your guess: 10%

Table 3, column “word share (%)”, which is the share of all written words.

Where do the 89.8 million written words come from?

The 31 groups of Table 3, gathered into seven families for this page. Pick a family; switch what is counted.

For researchers: all 31 written groups and 6 spoken groups (Tables 3 and 4)

Words per text and per sentence are computed. Table 4 row 5 prints “59,5734”; we read it as 595,734.

Table 3. Family grouping is ours; every number is the paper’s or summed from it. Switch to Texts: “Other texts” is 91,236 of 143,144 written texts, 63.7%.

Two groups dominate. Novels and short stories give 22.66% of written words from just 618 texts, long works sampled in part. “Other texts”, a catch-all not assigned to a specific genre, gives 38.84% of words and almost two-thirds of all written texts. Specialised documents in medicine, natural science or technology are each under 0.4%.

Speech: plenty from the North and South, almost none from the Centre

Speech was transcribed from real video and audio. To keep dialect features intact, each region’s recordings went to transcribers from that region. We name the Central region as our difficulty: it is the smallest spoken group by far.

How much speech does each region contribute?

Each square is 50,000 transcribed words, rounded to the nearest square. Central Vietnam’s 6,930 words fill about a seventh of one.

Table 4. The text reports Central speech as “0.001%” of spoken text; from the word counts it is 6,930 of 10,130,306 words, about 0.07%. Note that Table 4’s share column is a fraction (it sums to 1.00), not a percentage.

Spoken sentences are short

The tables also let us compare sentence length, something the paper does not discuss. Dividing words by sentences, transcribed speech averages 6.3 words per sentence and written text 16.2.

How many words does an average sentence hold?

Words ÷ sentences for each group. Dashed lines mark the written and spoken averages.

Computed from Tables 3 and 4, not reported in the paper. Speeches in the National Assembly (25.3) read like written text; everyday dialogue does not (5.8).

5 · Where it’s hard

What VnC 1.0 still lacks

We are direct about the gaps. Some written genres were hard to collect in practice: local newspapers, magazines, secondary-school students’ essays, personal and business letters. Speech covers fewer situations than they want. Our next steps are to keep updating the existing genres and to add the missing ones.

Which kinds of text are in, and which are still missing?

Filled tiles are groups in VnC 1.0, with their word counts; dashed tiles are what we plan to add.

In VnC 1.0 Planned (Sections IV and VI)

Tables 3–4 and Sections IV.A.1 and VI. The largest written tile, “Other texts”, is itself a gap of a different kind: 34,878,628 words not assigned to any specific genre.

What we learned

Four takeaways

  1. A corpus is a designed sample, not a pile. The paper sets out seven criteria for choosing texts: text selection, size, representativeness, balance, topic, homogeneity, and external versus internal criteria, and recommends starting with simple, external, feasible ones. Balance means shares set on purpose and recorded, not equal ones: VnC plans 90% written and 10% spoken (§IV).
  2. VnC 1.0 hits its planned shape. 89,790,952 written and 10,130,306 spoken words, 146,052 texts in 37 groups; speech is 10.14% of the total, against a 10% target.
  3. Two groups dominate the written side. “Other texts” holds 38.84% of written words and novels and short stories 22.66%; the next largest, newspapers’ “other material”, has 6.36%.
  4. Speech is the hardest part to balance. Central Vietnam has 13 transcribed texts and 6,930 words, against 2,542,896 words from the South and 1,458,930 from the North.

We plan to add spoken discussion programmes, counselling, documentaries, news, lectures, debates and meetings, and written local newspapers, magazines, school essays and letters, to raise the corpus’s balance, size and representativeness.

Notes, data provenance and limitations
CLC Toolkitclc.hcmus.edu.vn · word segmentation used for VnC 1.0 BNC Reference Guidenatcorp.ox.ac.uk/docs/URG · source of Figures 1–2
Vo, D. N., & Dinh, D. (2020). Language sampling criteria for Vietnamese corpus construction [Các tiêu chí ngôn ngữ trong việc xây dựng kho ngữ liệu tiếng Việt]. In Proceedings of the National Conference on Fundamental and Applied Information Technology Research (FAIR’2020), Nha Trang, Vietnam (pp. 26–32).

Read next

Vietnamese Dictionary & Encyclopedia 2020Collecting real Vietnamese text to write dictionary entries from12 min readLinguistic Journal 2022Teaching real Vietnamese to foreigners with a 100-million-word corpus14 min read

All publications · Get in touch about this research