class WordMage::Analysis

• WordMage::Analysis
• Reference
• Object

Overview

Represents aggregate analysis of multiple words.

Analysis combines data from multiple WordAnalysis instances to provide statistical insights into phonological patterns, frequencies, and structural tendencies. This data can be used to configure generators to produce words with similar characteristics.

This class is JSON-serializable for easy storage and transmission.

Example

analysis = Analysis.new(
  phoneme_frequencies: {"n" => 0.15, "a" => 0.25, "θ" => 0.08},
  syllable_count_distribution: {2 => 0.3, 3 => 0.5, 4 => 0.2},
  average_complexity: 6.2,
  recommended_budget: 6
)

Included Modules

• JSON::Serializable

Defined in:

Constructors

• .new(pull : JSON::PullParser)
• .new(phoneme_frequencies : Hash(String, Float32) = Hash(String, Float32).new, positional_frequencies : Hash(String, Hash(String, Float32)) = Hash(String, Hash(String, Float32)).new, syllable_count_distribution : Hash(Int32, Float32) = Hash(Int32, Float32).new, syllable_pattern_distribution : Hash(String, Float32) = Hash(String, Float32).new, cluster_patterns : Hash(String, Float32) = Hash(String, Float32).new, hiatus_patterns : Hash(String, Float32) = Hash(String, Float32).new, complexity_distribution : Hash(Int32, Float32) = Hash(Int32, Float32).new, average_complexity : Float32 = 0.0_f32, average_syllable_count : Float32 = 0.0_f32, consonant_vowel_ratio : Float32 = 0.0_f32, recommended_budget : Int32 = 6, recommended_templates : Array(String) = [] of String, recommended_hiatus_probability : Float32 = 0.2_f32, recommended_gemination_probability : Float32 = 0.0_f32, dominant_patterns : Array(String) = [] of String, vowel_transitions : Hash(String, Hash(String, Float32)) = Hash(String, Hash(String, Float32)).new, gemination_patterns : Hash(String, Float32) = Hash(String, Float32).new, vowel_lengthening_patterns : Hash(String, Float32) = Hash(String, Float32).new, phoneme_transitions : Hash(String, Hash(String, Float32)) = Hash(String, Hash(String, Float32)).new, bigram_frequencies : Hash(String, Float32) = Hash(String, Float32).new, trigram_frequencies : Hash(String, Float32) = Hash(String, Float32).new, provided_templates : Array(SyllableTemplate) | Nil = nil)

  Creates a new Analysis with specified parameters.

Instance Method Summary

• #average_complexity : Float32

  Average complexity score across all words

• #average_complexity=(average_complexity : Float32)

  Average complexity score across all words

• #average_syllable_count : Float32

  Average syllable count across all words

• #average_syllable_count=(average_syllable_count : Float32)

  Average syllable count across all words

• #bigram_frequencies : Hash(String, Float32)

  Bigram frequencies: phoneme_pair -> frequency

• #bigram_frequencies=(bigram_frequencies : Hash(String, Float32))

  Bigram frequencies: phoneme_pair -> frequency

• #bigram_frequency(bigram : String) : Float32

  Returns the frequency of a specific bigram.

• #cluster_patterns : Hash(String, Float32)

  Frequency of consonant clusters

• #cluster_patterns=(cluster_patterns : Hash(String, Float32))

  Frequency of consonant clusters

• #complexity_distribution : Hash(Int32, Float32)

  Distribution of complexity scores

• #complexity_distribution=(complexity_distribution : Hash(Int32, Float32))

  Distribution of complexity scores

• #complexity_preference : Symbol

  Determines if the analyzed language prefers simple or complex structures.

• #consonant_vowel_ratio : Float32

  Consonant to vowel ratio

• #consonant_vowel_ratio=(consonant_vowel_ratio : Float32)

  Consonant to vowel ratio

• #dominant_patterns : Array(String)

  Most common syllable patterns

• #dominant_patterns=(dominant_patterns : Array(String))

  Most common syllable patterns

• #final_phonemes(threshold : Float32 = 0.1_f32) : Array(String)

  Returns phonemes that commonly appear in final position.

• #gemination_patterns : Hash(String, Float32)

  Frequency of gemination patterns

• #gemination_patterns=(gemination_patterns : Hash(String, Float32))

  Frequency of gemination patterns

• #generate_vowel_harmony(strength : Float32 = 0.7_f32, threshold : Float32 = 0.1_f32) : VowelHarmony

  Generates a VowelHarmony configuration from the transition data.

• #gusein_zade_deviation : Hash(String, Float32)

  Compares empirical frequencies with Gusein-Zade predictions.

• #gusein_zade_weights(phonemes : Array(String) | Nil = nil) : Hash(String, Float32)

  Calculates Gusein-Zade distribution weights for phonemes.

• #hiatus_patterns : Hash(String, Float32)

  Frequency of hiatus sequences

• #hiatus_patterns=(hiatus_patterns : Hash(String, Float32))

  Frequency of hiatus sequences

• #initial_phonemes(threshold : Float32 = 0.1_f32) : Array(String)

  Returns phonemes that commonly appear in initial position.

• #most_common_followers(phoneme : String, count : Int32 = 5) : Array(Tuple(String, Float32))

  Returns the most common phonemes that follow a given phoneme.

• #most_frequent_bigrams(count : Int32 = 10) : Array(String)

  Returns the most frequent bigrams in order.

• #most_frequent_clusters(count : Int32 = 10) : Array(String)

  Returns the most frequent clusters.

• #most_frequent_patterns(count : Int32 = 5) : Array(String)

  Returns the most frequent syllable patterns.

• #most_frequent_phonemes(count : Int32 = 10) : Array(String)

  Returns the most frequent phonemes in order.

• #most_frequent_trigrams(count : Int32 = 10) : Array(String)

  Returns the most frequent trigrams in order.

• #ngram_diversity : Hash(String, Float32)

  Calculates the n-gram diversity (entropy) of the language.

• #optimal_syllable_weights : Hash(Int32, Float32)

  Calculates the optimal syllable count weights for generation.

• #phoneme_diversity : Float32

  Calculates the diversity of phoneme usage.

• #phoneme_frequencies : Hash(String, Float32)

  Frequency of each phoneme across all analyzed words

• #phoneme_frequencies=(phoneme_frequencies : Hash(String, Float32))

  Frequency of each phoneme across all analyzed words

• #phoneme_frequency_ranking : Array(String)

  Returns phonemes ranked by their empirical frequency.

• #phoneme_rank(phoneme : String) : Int32

  Calculates the rank of a phoneme in the frequency distribution.

• #phoneme_transitions : Hash(String, Hash(String, Float32))

  Phoneme transition frequencies: phoneme -> {next_phoneme -> frequency}

• #phoneme_transitions=(phoneme_transitions : Hash(String, Hash(String, Float32)))

  Phoneme transition frequencies: phoneme -> {next_phoneme -> frequency}

• #positional_frequencies : Hash(String, Hash(String, Float32))

  Positional frequencies: phoneme -> {position -> frequency}

• #positional_frequencies=(positional_frequencies : Hash(String, Hash(String, Float32)))

  Positional frequencies: phoneme -> {position -> frequency}

• #preferred_transitions(from_vowel : String, count : Int32 = 3) : Array(Tuple(String, Float32))

  Returns the most preferred vowel transitions.

• #provided_templates : Array(SyllableTemplate) | Nil

  Provided SyllableTemplate objects (when analysis uses explicit templates)

• #provided_templates=(provided_templates : Array(SyllableTemplate) | Nil)

  Provided SyllableTemplate objects (when analysis uses explicit templates)

• #recommended_budget : Int32

  Recommended complexity budget for generator

• #recommended_budget=(recommended_budget : Int32)

  Recommended complexity budget for generator

• #recommended_gemination_probability : Float32

  Recommended gemination probability based on detected patterns

• #recommended_gemination_probability=(recommended_gemination_probability : Float32)

  Recommended gemination probability based on detected patterns

• #recommended_hiatus_probability : Float32

  Recommended hiatus probability

• #recommended_hiatus_probability=(recommended_hiatus_probability : Float32)

  Recommended hiatus probability

• #recommended_templates : Array(String)

  Recommended syllable templates based on patterns

• #recommended_templates=(recommended_templates : Array(String))

  Recommended syllable templates based on patterns

• #smoothed_phoneme_frequencies(smoothing_factor : Float32 = 0.3_f32, phonemes : Array(String) | Nil = nil) : Hash(String, Float32)

  Generates smoothed phoneme frequencies using Gusein-Zade distribution.

• #structural_complexity : Float32

  Calculates the structural complexity index.

• #summary : String

  Generates a summary report of the analysis.

• #syllable_count_distribution : Hash(Int32, Float32)

  Distribution of syllable counts

• #syllable_count_distribution=(syllable_count_distribution : Hash(Int32, Float32))

  Distribution of syllable counts

• #syllable_pattern_distribution : Hash(String, Float32)

  Distribution of syllable patterns (CV, CVC, etc.)

• #syllable_pattern_distribution=(syllable_pattern_distribution : Hash(String, Float32))

  Distribution of syllable patterns (CV, CVC, etc.)

• #transition_probability(from_phoneme : String, to_phoneme : String) : Float32

  Returns the transition probability between two phonemes.

• #trigram_frequencies : Hash(String, Float32)

  Trigram frequencies: phoneme_triple -> frequency

• #trigram_frequencies=(trigram_frequencies : Hash(String, Float32))

  Trigram frequencies: phoneme_triple -> frequency

• #trigram_frequency(trigram : String) : Float32

  Returns the frequency of a specific trigram.

• #valid? : Bool

  Validates the analysis data for consistency.

• #vowel_harmony_strength : Symbol

  Checks if the language shows strong vowel harmony patterns.

• #vowel_lengthening_patterns : Hash(String, Float32)

  Frequency of vowel lengthening patterns

• #vowel_lengthening_patterns=(vowel_lengthening_patterns : Hash(String, Float32))

  Frequency of vowel lengthening patterns

• #vowel_transition_diversity : Float32

  Calculates vowel transition diversity.

• #vowel_transitions : Hash(String, Hash(String, Float32))

  Vowel transition frequencies: vowel -> {next_vowel -> frequency}

• #vowel_transitions=(vowel_transitions : Hash(String, Hash(String, Float32)))

  Vowel transition frequencies: vowel -> {next_vowel -> frequency}

Constructor Detail

Instance Method Detail