You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

163 lines
5.8 KiB
Org Mode

#+TITLE: Phonetics
This library:
- Gives you the phonetic pronunciation of a word.
- Syllabifies a sequence of phones.
For phonetics, it uses the CMU Pronouncing Dictionary. http://www.speech.cs.cmu.edu/cgi-bin/cmudict/ and CMULexicon from https://freetts.sourceforge.io/javadoc/com/sun/speech/freetts/en/us/CMULexicon.html.
#+begin_src clojure :results none :session usage-example
(require '[com.owoga.phonetics :refer :all])
(get-phones "hello")
;; => [["HH" "AH0" "L" "OW1"] ["HH" "EH0" "L" "OW1"]]
#+end_src
For syllabification, it uses a custom algorithm that is basically:
- Start from the last phone and work backwards.
- Take every consonant up through the first vowel. (This is the "rime" of the syllable).
- Take every consonant up through the next vowel with the conditions (This is the "onset" of the syllable):
- Each subsequent consonant is more sonorous than the previous.
- If the next vowel we'd encounter is lax, it gets followed by at least 1 consonant.
- Repeat until no phones remain.
That algorithm could be described as the maximal onset principle with an override that lax vowels must be in closed syllables (must end with a consonants).
For example, `pity` would be syllabified as `pi` `ty` given the maximal onset principle but since lax vowels can't end a syllable it actually gets syllabified as `pit` `y`.
#+begin_src clojure :results raw :session usage-example
(require '[com.owoga.phonetics.syllabify :refer :all])
(let [phones (first (get-phones "alaska"))]
(syllabify phones))
;; => [["AH0"] ["L" "AE1" "S"] ["K" "AH0"]]
#+end_src
Thanks to CMULexicon, you can also syllabify made-up words.
#+begin_src clojure :results none :session usage-example
(let [phones (first (get-phones "foobarbazia"))]
(syllabify phones))
;; => [["F" "UW1"] ["B" "AA1" "R"] ["B" "AA1"] ["Z" "IY0"] ["AH0"]]
#+end_src
You can also go backwards from a word, however this only works for words that appear in the CMU Dictionary. A future TODO and a request for contribution would be for a function that converts a made-up set of phonemes into a somewhat appropriate spelling of a word.
#+begin_src clojure :results none :session usage-example
(let [phones (first (get-phones "diploma"))]
[phones
(syllabify phones)
(get-word phones)])
;; => [["D" "IH0" "P" "L" "OW1" "M" "AA0"]
;; [["D" "IH0" "P"] ["L" "OW1"] ["M" "AA0"]]
;; ["diploma"]]
(let [phones (first (get-phones "foobarbazia"))]
(get-word phones))
;; => nil
#+end_src
* Syllabification
https://en.wikipedia.org/wiki/Syllable
#+begin_quote
In the typical theory of syllable structure, the general structure of a syllable (σ) consists of three segments. These segments are grouped into two components:
Onset (ω)
a consonant or consonant cluster, obligatory in some languages, optional or even restricted in others
Rime (ρ)
right branch, contrasts with onset, splits into nucleus and coda
Nucleus (ν)
a vowel or syllabic consonant, obligatory in most languages
Coda (κ)
consonant, optional in some languages, highly restricted or prohibited in others
#+end_quote
Also, for "ellipsis", /ps/ is not a legal internal coda in English. The /s/ can only occur as an appendix, e.g. the plural -s at the end of a word. So it should be e.lip.sis
http://www.glottopedia.org/index.php/Sonority_hierarchy
http://www.glottopedia.org/index.php/Maximal_Onset_Principle
** Nasal
Air flow goes through nose.
Examples: "n" in "nose", "m" in "may", "ŋ" in "funk".
"ŋ" is known as the letter "eng" and the technical name of the consonant is the "voiced velar nasal"
"voiced" in the above sentence refers to whether or not your vocal chords are active. Your voice chord doesn't vibrate with voiceless consonants, like "sh" "th" "p" "f". In contrast, notice the vibration in phonemes like "m" "r" "z".
** Ambisyllabism
[[http://www.glottopedia.org/index.php/Ambisyllabic]]
A segment is ambisyllabic if it belongs to two syllables.
Example:
The English word hammer cannot be divided into two syllables `ha` and `mer`; the [m] functions both as the final segment of the first syllable and as the initial consonant of the second syllable.
This library doesn't syllabify words based on their letters. It syllabifies words based on their phonemes.
The two `m`'s in "hammer" are represented by a single phoneme, `M`. So, when it gets syllabified, the [m] only functions as an onset to the final rime.
*** Ambisyllabism TODO
Provide a function that inserts an extra phone where ambisyllabism occurs.
* Development
The initial skeleton of this library was generated from [[https://github.com/seancorfield/clj-new]]
What follows is an unedited part of that skeleton. TODO: Update with syllabify-specific development documentation.
Invoke a library API function from the command-line:
$ clojure -X com.owoga.syllabify/foo :a 1 :b '"two"'
{:a 1, :b "two"} "Hello, World!"
Run the project's tests (they'll fail until you edit them):
$ clojure -M:test:runner
Build a deployable jar of this library:
$ clojure -X:jar
This will update the generated `pom.xml` file to keep the dependencies synchronized with
your `deps.edn` file. You can update the version (and SCM tag) information in the `pom.xml` using the
`:version` argument:
$ clojure -X:jar :version '"1.2.3"'
Install it locally (requires the `pom.xml` file):
$ clojure -X:install
Deploy it to Clojars -- needs `CLOJARS_USERNAME` and `CLOJARS_PASSWORD` environment
variables (requires the `pom.xml` file):
$ clojure -X:deploy
Your library will be deployed to com.owoga/syllabify on clojars.org by default.
If you don't plan to install/deploy the library, you can remove the
`pom.xml` file but you will also need to remove `:sync-pom true` from the `deps.edn`
file (in the `:exec-args` for `depstar`).
* License
Copyright © 2021 Eihli
Distributed under the MIT License.