Vowel AI Tool
Vowel AI is an intelligent research tool that integrates phonetic theory with machine learning. It analyzes acoustic features such as F1, F2, F3, duration, and F0, normalizes them per speaker, and visualizes the vowel space with high precision. Beyond descriptive phonetics, it applies supervised AI models (Logistic Regression, Random Forest) to classify and predict vowel categories, revealing subtle phonological patterns such as emphasis-induced retraction in Arabic. This makes it a powerful bridge between experimental phonetics and computational phonology.
أداة Vowel AI الذكية
أداة Vowel AI هي أداة بحثية ذكية تجمع بين النظرية الصوتية وتقنيات التعلم الآلي. فهي تُحلِّل الخصائص الصوتية مثل F1 وF2 وF3 والمدة وF0، وتُطبِّعها على مستوى المتحدث، ثم تعرض مُحيط الصوائت بدقة عالية. ولا تقتصر على الوصف الصوتي، بل تستخدم نماذج إشرافية للذكاء الاصطناعي (الانحدار اللوجستي، الغابة العشوائية) لتصنيف الصوائت والتنبؤ بها، كاشفةً عن أنماط فونولوجية دقيقة مثل ارتداد الصائت /a/ في بيئات التفخيم العربية. وبذلك تُشكِّل جسرًا قويًّا بين الفونتيك التجريبي والفونولوجيا الحاسوبية.
What this tool does. Plot vowel space (F1×F2), train a small classifier, and predict labels on new CSVs — with optional unit conversion, per-speaker normalization, custom colors, and an Arabic emphatic_env helper.
1) Prepare your CSV
- Required:
F1,F2(plain numbers in Hz). - Recommended:
vowel,speaker(enable coloring, faceting, normalization, and training). - Optional:
F3,duration_ms,F0,sex,dialect,emphatic_env, orcontext_left/context_right.
speaker,sex,dialect,vowel,F1,F2,F3,duration_ms,F0,context_left,context_right,emphatic_env spk1,f,Cairene,i,300,2400,3100,95,220,س,,false spk1,f,Cairene,a,780,1450,2500,120,200,ص,,true spk2,m,Najdi,u,360,950,2150,95,118,,T,true
2) Plot controls (F1 × F2)
- Color by — choose
vowel,speaker, or any column (e.g.,emphatic_env). - Units —
Hz(transparent),Mel, orBark(perceptual spacing). - Normalization —
LobanovorNearey1per speaker (need enough tokens per speaker; the app warns if unstable). - Facet by — small multiples by
speaker,sex,dialect. - Flip F2 — keeps the traditional left=front, right=back convention.
- Ellipses — choose σ (dispersion), Coverage (e.g., 0.95), or Mean CI (uncertainty of centroid); set the numeric level.
- Labels — style (
stacked/inline/legend_counts), font size, and stacked offset. - Axes — research preset (Hz: F1≈200–900; F2≈600–2600) or manual
min,maxfor F1/F2. - Custom colors — map vowels to hex colors in the textarea (one per line):
i: #1f77b4a: #ff7f0eu: #2ca02c - Emphatic context — include
emphatic_env(true/false) or justcontext_left/right; the app can auto-compute the flag using Arabic emphatic/uvular/guttural sets.
3) Train & evaluate
- Target —
vowelorspeaker. - Model — Logistic Regression (with StandardScaler) or Random Forest (200 trees).
- Features — Basic = [F2,F1]; Extended adds
F3,duration_ms,F0if present. - Evaluation —
auto(adaptive),holdout(pick test %, stratified), orcv(k-fold); optional speaker-held-out grouping. - Outputs — training accuracy, confusion matrices (count & row-normalized), and
classification_report.csv. - Model file — exported
.joblibstores units, normalization, feature list, and class labels for consistent prediction later.
4) Predict on a new CSV
- Upload your saved
.joblibplus a new CSV containing the same feature columns the model used. - Output CSV = your original rows +
pred,prob_top1, andprob_<class>columns. - Tip: filter to high-confidence tokens (e.g.,
prob_top1 ≥ 0.80) for conservative analyses.
5) Common issues (and fixes)
- Missing F1/F2 → ensure plain numbers; delete “Hz” text or blanks.
- Normalization errors → too few tokens/zero variance per speaker; switch to Hz or collect more data.
- Model/feature mismatch — new CSV must include exactly the features used at training (see artifact).
- No points visible → widen axis limits or uncheck “Use research axis ranges”.
6) Quick start
- Plot in Hz, No normalization, Color by vowel, Ellipses=On.
- Facet by speaker or dialect; try Color by emphatic_env if present.
- Train: Target=vowel, Model=LogReg, then compare with RF.
- Predict: keep rows with
prob_top1 ≥ 0.8for strict labeling. - Export figures (PNG/SVG/PDF) and
centroids.csvfor reporting.
ما الذي تفعله الأداة؟ ترسم مساحة الصوائت (F1×F2)، وتدرّب مصنِّفًا بسيطًا، وتتنبّأ بتسميات على ملفات CSV جديدة — مع تحويل الوحدات، والتطبيع لكل متحدث، والألوان المخصّصة، ومُساعِد عربي لعمود emphatic_env.
١) تجهيز ملف CSV
- إلزامي: F1, F2 كأرقام صِرفة بالهرتز.
- مستحسن: vowel وspeaker (للتلوين/التجزئة/التطبيع والتدريب).
- اختياري: F3، duration_ms، F0، sex، dialect، emphatic_env أو context_left/right.
speaker,sex,dialect,vowel,F1,F2,F3,duration_ms,F0,context_left,context_right,emphatic_env spk1,f,Cairene,i,300,2400,3100,95,220,س,,false spk1,f,Cairene,a,780,1450,2500,120,200,ص,,true spk2,m,Najdi,u,360,950,2150,95,118,,T,true
٢) إعدادات الرسم (F1 × F2)
- Color by — اختر vowel أو speaker أو أي عمود (مثل emphatic_env).
- Units — Hz أو Mel/Bark.
- Normalization — Lobanov أو Nearey1 لكل متحدث.
- Facet by — حسب speaker أو sex أو dialect.
- Flip F2 — يحافظ على العُرف (اليسار=أمامي، اليمين=خلفي).
- Ellipses — σ للتشتّت، أو Coverage (مثل 0.95)، أو Mean CI.
- Labels — نمط الوسوم وحجم الخط والمسافة عند التكديس.
- Axes — نِطاقات قياسية أو حدِّد min,max يدويًا.
- بيئة التفخيم — أضِف emphatic_env أو context_left/right.
٣) التدريب والتقويم
- Target — vowel أو speaker.
- Model — الانحدار اللوجستي أو الغابة العشوائية (200 شجرة).
- Features — الأساسي = [F2,F1]؛ الموسّع يضيف F3 وduration_ms وF0.
- Evaluation — auto أو holdout أو cv.
- المخرجات — الدقّة، مصفوفتا الالتباس، وclassification_report.csv.
٤) التنبؤ بملف CSV جديد
- ارفَع ملف .joblib وملف CSV يحوي السمات نفسها.
- الناتج = صفوفك + pred وprob_top1 وprob_<class>.
- نصيحة: رشّح الرموز ذات prob_top1 ≥ 0.80.
Upload WAV + optional TextGrid, auto-measure F1/F2, duration → CSV.