Українською

Yar. Ukrainian Numbers Spellout

The library to convert the numbers into Ukrainian text.

Supported Features

• Number spellout – converting numbers into text (numerals).
• Numeral inflection - modifying grammatical form of numerals to match required grammatical characteristics.
• Agreement - setting grammatical forms of compound numerals to produce grammatically and syntactically correct text.
• Stress.
• Cardinal numbers in range [0...1×10²⁷)^{1, 2}.
• Ordinal numbers in range [0...1×10²⁷)¹.
• Fractional numbers with whole, each element in range [0...1×10²⁷).
• Decimal numbers in range (0...1×10²⁷) with precision up to 1×10^{-27 3}.

¹ Numbers outside of the range will be spelled out digit-wise and inflected only last digit

² 1×10²⁷ is 1 000 000 000 000 000 000 000 000 000

³ 1×10^-27 is 0.000 000 000 000 000 000 000 000 001

Future Features

• Negative numbers.
• Contracted ordinal numbers (e.g. "1-й", "1000-на").
• Scientific notation of exponential numbers (e.g. "1e5").
• Roman numbers (e.g. "XIV").
• Collective numerals (e.g. "дво́є").
• Ablative case (indicates movement away or towards; <до> те́бе. In most words this form is same as genitive).

Supported Grammatical Attributes

• cases: nominative, genitive, dative, accusative, instrumental, locative, vocative
• gender: masculine, feminine, neuter
• number: singular, plural
• animacy: inanimate, animate

English

Яр. Написання українських числівників

Ця бібліотека перетворює числа на текст.

Доступні функції

• Написання числівників – перетворення чисел на текст.
• Відмінювання числівників – написання числівників в будь-якій граматичній формі.
• Узгодження - узгодження граматичних форм складених числівників.
• На́голоси.
• Написання кількісних числівників в діапазоні [0...1×10²⁷)^{1, 2}.
• Написання порядкових числівників в діапазоні [0...1×10²⁷)¹.
• Написання дробових числівників з цілою частиною. Кожен фрагмент в діапазоні [0...1×10²⁷).
• Написання десяткових числівників в діапазоні (0...1×10²⁷) з точністю до 1×10^{-27 3}.

¹ Числівники за межами діапазонів будуть написані по-цифрах, відмінюватиметься тільки останнє слово.

² 1×10²⁷ це 1 000 000 000 000 000 000 000 000 000, один октильйо́н

³ 1×10^-27 це 0,000 000 000 000 000 000 000 000 001, одна октильйо́нна

Заплановані функції

• Відʼємні числа.
• Cкорочені порядкові числа (наприклад "1-й", "1000-на").
• Експоненційний запис (наприклад "1e5").
• Римські числа (наприклад "XIV").
• Збірні числівники (наприклад "дво́є").
• Відкладальний відмінок (вказує на рух від або до; <до> те́бе. У більшості слів ця форма збігається з родовим відмінком).

Доступні граматичні категорії

• відмінки: називний (nominative), родовий (genitive), давальний (dative), знахідний (accusative), орудний (instrumental), місцевий (locative), клична форма (vocative)
• роди: чоловічий (masculine), жіночий (feminine), середній (neuter)
• однина (singular), множина (plural)
• істота (animate), неістота (inanimate)

Syntax of Compound Numbers

When the number is expanded to lexemes the problem of agreement arises. The agreement mechanism we will be using is based on dependency parsing. The basic theory aligns with approach taken by Universal Dependency, however for our purposes we will introduce additional types.

Dependency Types

Introduce following relation types:

• num
• nummod:govsg - relation to a singular numeral (to lexeme for 1)
• nummod:govpc - relation to a paucal numeral (to a lexeme for 2, 3, or 4)
• nummod:govpl - relation to a plural numeral (to any other numeral lexeme)

Note that number 11 is expanded to a single lexeme "одина́дцять" and thus has relation nummod:govpl. Simlarly numbers 12, 13, and 14 will have nummod:govpl.

Cardinal Numerals

Agreement of Cardinal Numerals

All nummod relations agrees with the parent's gender, animacy, and case. The last depending numeral lexeme will introduce one of the following governing modifiers. The nummod:govsg relation always governs singular number to the parent and does not affect infered case. The nummod:govpc relation takes parent's case, gender, and animacy and governs paucal number. The nummod:govpl relation always governs plural number to the parent and governs genitive case only when parent is in nominative or accusative, the remaining cases take precedence.

Subtrees

Every 3 orders of magnitude spawns a new subtree, elements of which are agreed to the aggregate numeral: 1 000, 1 000 000, 1 000 000 000, etc. So if the number is less than a 1000 then all numeral lexems are connected to object directly. Number with any number of 1000s in it will spawn a new aggregate lexeme for number 1000 and all numerals in positions 4, 5, 6 will connect to the aggregate instead of the object. The numbers with 1 000 000 in it will have a subtree with aggregate numeral lexeme for "1 000 000" that will collect all numerals in positions 7, 8, 9. See [Examples](#Examples of Cardinal Numerals Agreement) section for more details. What is worth noting is that these aggregate numerals have persistent grammatical gender, which differentiates them from regular numerals. So the lexeme "ти́сяча" (1 000) has persistent feminine gender thus all its child nummod dependencies will use that gender as basis for agreement. Lexeme "мільйо́н" (1 000 000) has masculine gender, as all the consqutive numbers in the short scale.

Examples of Cardinal Numerals Agreement

Singular nummod:govsg

The forms for the number 1 021 131 (оди́н мільйо́н два́дцять одна́ ти́сяча сто́ три́дцять оди́н)

graph TD
    A("root") --> B["я́блуко{N;nom;sg}"]
    B --> |nummod| C["мільйо́н{M;nom;sg}"]
    C --> |nummod:govsg| D["оди́н{nom;m}"]
    B --> |nummod| E["ти́сяча{F;nom;sg}"]
    E --> |nummod| F["два́дцять{nom;f}"]
    E --> |nummod:govsg| G["одна́{nom;f}"]
    B --> |nummod| B1["сто́{nom;n}"]
    B --> |nummod| B2["три́дцять{nom;n}"]
    B --> |nummod:govsg| B3["одне́{nom;n}"]

Paucal nummod:govpc

The forms for the number 2 034 643 (два́ мільйо́ни три́дцять чоти́ри ти́сячі шістсо́т со́рок три́)

graph TD
    A("root") --> B["я́блука{N;gen;sg}"]
    B --> |nummod| C["мільйо́ни{M;nom;pl}"]
    C --> |nummod:govpc| D["два́{nom;m}"]
    B --> |nummod| E["ти́сячі{F;nom;pl}"]
    E --> |nummod| F["три́дцять{nom;f}"]
    E --> |nummod:govpc| G["чоти́ри{nom;f}"]
    B --> |nummod| B1["шістсо́т{nom;n}"]
    B --> |nummod| B2["со́рок{nom;n}"]
    B --> |nummod:govpc| B3["три́{nom;n}"]

Plural nummod:govpl

The forms for the number 6 013 845 (ші́сть мільйо́нів трина́дцять ти́сяч вісімсо́т со́рок пʼя́ть)

graph TD
    A("root") --> B["я́блук{N;gen;pl}"]
    B --> |nummod| C["мільйо́нів{M;gen;pl}"]
    C --> |nummod:govpl| D["ші́сть{nom;m}"]
    B --> |nummod| E["ти́сяч{F;gen;pl}"]
    E --> |nummod:govpl| G["трина́дцять{nom;f}"]
    B --> |nummod| B1["вісімсо́т{nom;n}"]
    B --> |nummod| B2["со́рок{nom;n}"]
    B --> |nummod:govpl| B3["пʼя́ть{nom;n}"]

Ordinal Numerals

Agreement of Ordinal Numerals

Regular ordinal numerals connect to the object with the amod relation. And accordingly takes on the parent's case, gender, number, and animacy. This relation is not governing. Only the last numeral is inflected as an ordinal, all remamining are inflected as cardinal and are connected directly with the object with the num relation.

[пиша́юсь] 46 013 845-м я́блуком

graph TD
    A("root") --> B["я́блуком{N;inst;sg}"]
    B --> |num| H["мільйо́нів{M;gen;pl}"]
    H --> |nummod| J["со́рок{nom;m}"]
    H --> |nummod:govpl| I["ші́сть{nom;m}"]
    B --> |num| F["ти́сяч{F;gen;pl}"]
    F --> |nummod:govpl| G["трина́дцять{nom;f}"]
    B --> |num| E["вісімсо́т{nom;n}"]
    B --> |num| D["со́рок{nom;n}"]
    B --> |amod| C["пʼя́тим{inst;n}"]

If the numeral ends with noun numeral (1000, 1 000 000, etc.) then it combines its three ranks into one compound numeral. The remaining numerals are inflected normally.

[немає] 692 525 000-го я́блука [немає] чоти́ри мілья́рда девʼяно́сто два́ мільйо́на пʼятисотдвадцятипʼятити́сячного я́блука

graph TD
    A("root") --> B["я́блука{N;gen;sg}"]
    subgraph C ["compound"]
        direction RL
        D["ти́сячного{gen;n;sg}"] -.- E["пʼяти{gen;n}"]
        E -.- F["двадцяти{gen;n}"]
        F -.- G["пʼятисот{gen;n}"]
    end
    B --> |num| K["мілья́рдів{M;gen;pl}"]
    K --> |nummod:govpl| L["ші́сть{nom;m}"]
    B --> |num| H["мільйо́на{M;gen;sg}"]
    H --> |nummod| I["девʼяно́сто{nom;m}"]
    H --> |nummod:govpc| J["два́{nom;m}"]
    B ---> |amod| C

Fractional Numerals

Agreement of Fractional Numerals

[ба́чу] пʼя́ть мільйо́нів со́рок одну́ два́ мільйо́ни сімдеся́т пе́ршу [части́ну] я́блука [ба́чу] пʼя́ть мільйо́нів со́рок дві́ два́ мільйо́ни сімдеся́т пе́рших [части́ни] я́блука

пишаюсь пʼятьма другими яблука пишаюсь однією другою яблука пишаюсь двома другими яблука