https://github.com/giellalt/lang-esu
Central Alaskan Yup'ik FST morphological analyzer/generator
https://github.com/giellalt/lang-esu
analyzer finite-state-transducer finite-state-transducers generator geo-northamerica langfam-eskimo-aleut maturity-beta morphology yugcetun yugtun yup-ik yupik
Last synced: 5 months ago
JSON representation
Central Alaskan Yup'ik FST morphological analyzer/generator
- Host: GitHub
- URL: https://github.com/giellalt/lang-esu
- Owner: giellalt
- License: other
- Created: 2019-07-03T21:27:31.000Z (almost 7 years ago)
- Default Branch: main
- Last Pushed: 2025-12-31T15:35:36.000Z (5 months ago)
- Last Synced: 2026-01-03T10:03:19.161Z (5 months ago)
- Topics: analyzer, finite-state-transducer, finite-state-transducers, generator, geo-northamerica, langfam-eskimo-aleut, maturity-beta, morphology, yugcetun, yugtun, yup-ik, yupik
- Language: Text
- Homepage:
- Size: 4.64 MB
- Stars: 13
- Watchers: 24
- Forks: 1
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Citation: CITATION.cff
Awesome Lists containing this project
README
Finite State Morphological Analyzer for Central Alaskan Yup'ik
==============================================================
[](https://giellalt.github.io/MaturityClassification.html)
[](https://github.com/giellalt/lang-esu/issues)
[](https://github.com/giellalt/lang-esu/blob/main/LICENSE)
[](https://github.com/giellalt/lang-esu/actions)
[](https://divvun-tc.giellalt.org/api/github/v1/repository/giellalt/lang-esu/main/latest)
Download nightly / CI/CD installation packages for testing (contains the core zhfst file(s)):
[](https://pahkat.uit.no/main/download/speller-esu?platform=windows&channel=nightly)
[](https://pahkat.uit.no/main/download/speller-esu?platform=macos&channel=nightly)
[](https://pahkat.uit.no/main/download/speller-esu?platform=mobile&channel=nightly)
__NB!!__ Note that the nightly / CI/CD installation packages are not tested for language quality, and might contain regressions and errors.
Central Alaskan Yup'ik (CAY) (ISO 639-3: esu) is a member of the Inuit-Yupik-Unangan (IYU) (also known as Eskimo-Aleut) language family. It is spoken in south-west Alaska among the Yukon-Kuskokwim Delta and Bristol Bay areas.
This CAY morphological analyzer/generator can **analyze** (break the word into its individual parts) and **generate** (build a word from its individual parts) Yup'ik words. The underlying form is composed of morphemes represented by the analysis of Jacobson's (1984/1995/2012) [dictionary](http://www.uaf.edu/anla/item.xml?id=CY972J2012) and grammar book. It is build using the open source [HFST tools](https://hfst.github.io). This project was developed with `hfst 3.15.2`.
Download and test speller files
-------------------------------
The speller files downloadable at the top of this page (the `*.bhfst` files) can
be used with [divvunspell](https://github.com/divvun/divvunspell), to test their
performance. These files are the exact same ones as installed on users' computers
and mobile phones. Desktop and mobile speller files differ from each other in the
error model and should be tested separately — thus also two different downloads.
Documentation
-------------
Documentation can be found at:
- [Language specific documentation](https://giellalt.github.io/lang-esu/)
- [General documentation](https://giellalt.github.io/)
FST Stack
---------
1. `lexc` - `esu.lexc` - lexicon and morphotactics
2. `xfst` - `esu.lexc.xfst` - orthography → phonemes, morphologically conditioned allomorphy
3. `twolc` - `esu.twol` - morphophonology, phonologically conditioned allomorphy
4. `twolc` - `esu.stress.twol` - prosodic stress marking on vowels used for prosodic adjustments
5. `xfst` - `esu.twol.xfst` - prosodic adjustments, phonemes → orthography
Installation
------------
1. Install dependency: [HFST tools](https://hfst.github.io). Tested with `hfst 3.15.2`.
Note: MacOS users may have an easier time installing HFST with this [Homebrew tap](https://github.com/UAlbertaALTLab/homebrew-hfst).
2. Run `make` to run the Makefile and compile the FST stack
Output Files
------------
* `esu.ana.hfstol`: Morphological analyser
* Input: `calinrituq`
* Output: `cali-–nrite[V→V][V][Intr][Ind][S_3Sg]`
* `esu.gen.hfstol`: Morphological generator
* Input: `cali-–nrite[V→V][V][Intr][Ind][S_3Sg]`
* Output: `calinrituq`
* `esu.seg.hfstol`: Morphological segmenter
* Input: `calinrituq`
* Output: `cali>nrit>uq`
Usage
-----
In the unix terminal, run this command to use the HFST lookup program:
echo "wordToInput" | hfst-optimized-lookup hfstName
where `wordToInput` is the Yup'ik word to analyze/generate and the `hfstName` is either: `esu.ana.hfstol | esu.gen.hfstol | esu.seg.hfstol`.
License
-------
This Central Alaskan Yup'ik FST morphological analyzer/generator and the associated source code is available under the
[GNU Affero General Public License (GNU AGPL v.3)](https://www.gnu.org/licenses/agpl-3.0.en.html):
> Copyright (C) 2020 Lonny Alaskuk Strunk
>
> This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
>
> This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details.
>
> You should have received a copy of the GNU Affero General Public License along with this program. If not, see .
Citing
------
If you use language data from more than one GiellaLT language, consider citing
[our LREC 2022 article on whole
infra](https://aclanthology.org/2022.lrec-1.125/):
> Linda Wiechetek, Katri Hiovain-Asikainen, Inga Lill Sigga Mikkelsen,
Sjur Moshagen, Flammie Pirinen, Trond Trosterud, and Børre Gaup. 2022.
*Unmasking the Myth of Effortless Big Data - Making an Open Source
Multi-lingual Infrastructure and Building Language Resources from Scratch*.
In Proceedings of the Thirteenth Language Resources and Evaluation Conference,
pages 1167–1177, Marseille, France. European Language Resources Association.
If you use bibtex, following is as it is on ACL anthology:
```bibtex
@inproceedings{wiechetek-etal-2022-unmasking,
title = "Unmasking the Myth of Effortless Big Data - Making an Open Source
Multi-lingual Infrastructure and Building Language Resources from Scratch",
author = "Wiechetek, Linda and
Hiovain-Asikainen, Katri and
Mikkelsen, Inga Lill Sigga and
Moshagen, Sjur and
Pirinen, Flammie and
Trosterud, Trond and
Gaup, B{\o}rre",
booktitle = "Proceedings of the Thirteenth Language Resources and Evaluation
Conference",
month = jun,
year = "2022",
address = "Marseille, France",
publisher = "European Language Resources Association",
url = "https://aclanthology.org/2022.lrec-1.125",
pages = "1167--1177"
}
```