📘 ACE Documentation — Overview

A complete reference guide for all internal systems of ACE — Arabic Verb & Noun Analyzer. This page introduces how ACE works, its architecture, and how all modules interact.

🏛 ACE Architecture Overview

ACE is built as a modular analysis engine with independent components:

  • Core Analyzer: Builds tokens, forms, tenses, pronouns.
  • Stem Tester: Generates all 14 pronouns, modes, declensions.
  • Latin→Arabic Engine: Converts transliteration to full Arabic script.
  • Dictionary Module: Stores roots & derived meanings.
  • Frequency Engine: Searches Qurʼān DB for matches.
  • Tajweed Module: Colorizes throat, qalqalah, emphatic letters.
  • Documentation System: This section itself.
🧩 Major System Modules
  • latinToArabic(): Handles hamza, madda, long vowels, sukun insertion.
  • build_combined_token(): Builds the final Latin word from: prefix + stem + suffix + pronouns.
  • analyzeVerb(): Full morpho-syntactic analyzer.
  • ace_find_dictionary_entry_by_root(): Dictionary lookup.
  • reverse_analyzer_engine.php: Works backwards from Arabic → Latin.
⚙️ Processing Pipeline

ACE processes every verb/noun using this pipeline:

  1. User selects root/form/tense/pronoun.
  2. ACE determines vowel pattern (V1/V2).
  3. build_combined_token() constructs the Latin token.
  4. latinToArabic() converts Latin to Arabic script.
  5. Tajweed engine applies colors & sukun/shaddah rules.
  6. Frequency engine searches “quran” DB.
  7. Translation selected (English/Urdu).
🔤 Latin → Arabic Transliteration System

This section summarizes the transliteration system used internally.

  • a = َ , i = ِ , u = ُ
  • aA = long ā, iy = long ī, uw = long ū
  • ea, ei, eu = hamza forms
  • sh, th, dh, gh, kh = digraphs
  • AA = ع (ayn)

Full breakdown available here:
📘 Latin → Arabic Rules

📚 Verb Forms I–X (الفعل المزيد)

Form patterns, meanings, masdar patterns, and how ACE detects them.

See:
📘 Forms Explained (I–X)

🕰 Tenses (1–44)

ACE supports 44 categories including:

  • Perfect / Imperfect
  • Indicative / Subjunctive / Jussive / Emphatic I–II
  • Imperative / Prohibitive
  • Noun categories (participle, masdar, etc.)

See complete mapping:
📘 Detailed Tense List

🦾 Weak Verbs (Hollow, Defective, Assimilated)

ACE fully supports all weak verb types.

Full details:
📘 Weak Verbs Rules

🎨 Tajweed Coloring Rules

Color categories:

  • Red = Throat letters
  • Blue = Qalqalah
  • Orange = Tafkhīm letters
  • Green = Harakah vowels

See complete rules:
📘 Tajweed Rules

📖 Dictionary Engine

ACE dictionary uses:

  • Base form (Form I)
  • Derived forms (II–X)
  • English/Urdu translation
  • VG = verb group (strong/weak)

See:
📘 Dictionary Viewer

🔍 Reverse Analyzer

Works backward:

  • Arabic input → detected root
  • Tense & pronoun identification
  • Latin reconstruction

See:
📘 Reverse Analyzer Engine