#+TITLE: Phonetics

[[https://img.shields.io/clojars/v/com.owoga/phonetics.svg]]

https://clojars.org/com.owoga/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 the first encountered 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

Distributed under the MIT License.

Phonetics

Install / Use

README