# Suswara requirements

Created 2026-11-17 · Updated 2026-11-18

Companion [design](suswara-design.md)

## Goal

The primary goal is ear training. Help an adult beginner hear how pitches differ, recognize swaras and intervals relative to Sa, and reproduce short phrases by ear in a comfortable range. Use synchronized visual cues to introduce the sound-label relationship, then check the same skill by ear alone. See the [ear-training design rules](suswara-design.md#ear-training-objectives-and-design-rules). Start with a playable phone-sized mock. Use its learning and usability results to shape a standalone Expo app.

| Gate | Exit condition |
| --- | --- |
| Research and scope | Verify pitch math, distinguish equal temperament from Carnatic performance, and define observable learning milestones. |
| Prototype | Select tonic, octave and notation, compare audible and visual note pairs, practice recognition and reproduction, and follow the learning map. |
| Native pilot | Confirm device playback, permission and audio lifecycle, validate voice estimates, and have a Carnatic teacher review the lesson content. |

## Functional requirements

| ID | Requirement | Acceptance |
| --- | --- | --- |
| R1 | Explore movable Do major, Shankarabharanam, Mayamalavagowla and chromatic pitches. | Change tonic and octave independently. Show scientific note name and frequency. Listen to individual notes, a scale and a fixed starting exercise. |
| R2 | Compare any two chromatic positions within the selected tonic octave. | Show two sine waves on a common time axis, note spacing on a cents ruler, signed Hz difference and cents, and the frequency ratio. Play A then B or both together. Swapping direction changes signed quantities. |
| R3 | Train the ear before revealing the answer. | Randomized same/higher/lower trials with repeat audio, answer feedback, and selectable separation down to 10 cents. Keep timing and waveform the same, with a bounded level variation to discourage guessing from loudness. |
| R4 | Turn hearing into vocal control. | Provide a tonic drone, listen-then-hum directions, and optional local microphone feedback for one steady pitch. The practice routine works by ear when microphone access is unavailable. |
| R5 | Provide a learning map and realistic milestones. | Show progression from tonic matching and rhythm to sarali varisai, alternating patterns, repertoire, and teacher-guided gamaka. Label time ranges as planning estimates. |
| R6 | Keep the mock usable on a phone and private. | Responsive layout, labeled controls, visible focus, textual chart equivalents, explicit microphone permission, no recording retention, network requests or accounts. Audio starts only after interaction. |

## Learning path

```mermaid
mindmap
  root((Learn relative pitch))
    Tonic and pulse
      Choose a comfortable Sa with a teacher or sung model
      Find Sa on a keyboard and hold it against a shruti drone
      Clap a steady pulse while listening
    Hear then sing
      Match Sa then Sa Pa Sa
      Compare same higher lower
      Echo short phrases and check after singing
    Carnatic foundations
      Listen and echo sarali varisai slowly
      Janta and dhatu patterns
      Alankaras with tala
      Geetams and simple repertoire
    Musical fluency
      Varnams and kritis with a teacher
      Learn raga phrases and gamaka from voice or veena
      Develop independent intonation and improvisation
```

Start with voice and a drone if singing is your goal. A piano or keyboard gives you repeatable reference steps. A teacher's voice gives you a model you can imitate with your own voice. Veena is a good primary instrument if playing it is your goal and you have access to instruction. For Carnatic phrasing, listen to sung or veena examples from the beginning. Use flat keyboard notes for reference and a teacher for phrasing, ornament and intonation.

**A 25-minute practice session.** Spend 5 minutes finding Sa and clapping a steady pulse, 5 listening to and echoing a teacher or recording, 5 on same/higher/lower comparisons, and 10 repeating one short phrase slowly. Start comparisons with an octave or fifth, then a whole tone, then a semitone. Try 50 and 25 cents only after larger gaps feel routine. Hear the reference, pause playback, hum gently, then check the pitch. If you miss, slide gently toward the note, stop, and try to begin on it directly. Once the match is steady, hide the reading and repeat by ear. Passive listening helps build familiarity. Give active recall and vocal practice their own time.

| Stage | Planning window at 20–30 active min, six days a week | What to demonstrate |
| --- | --- | --- |
| Beginner | 1–3 months | Find a comfortable Sa from a cue, sustain it, and echo a short sarali pattern with a pulse. |
| Intermediate | 9–24 months | Recover Sa within a phrase, sing several exercises in tala, and perform a few geetams with reliable pitch and rhythm. |
| Advanced | 3–7+ years | Independently maintain shruti and tala in repertoire, reproduce characteristic raga phrases and gamakas, and begin or develop improvisation under guidance. |

These are planning ranges for a 52-year-old beginner with regular feedback, not research-derived forecasts or age-specific norms. Starting pitch matching, lesson quality, prior exposure and consistency can move the ranges substantially. Recheck the same short recording and exercise monthly. Adult feedback studies measure narrower tasks and cannot predict an individual Carnatic proficiency timeline.

## References

- Pitch and octave math. [UNSW Music Acoustics](https://www.phys.unsw.edu.au/music/notes.html)
- Carnatic swaras and keyboard limits. [IIT Madras Carnatic primer](https://www.ae.iitm.ac.in/~sriram/karpri.pdf) and [Carnatic Music Reader](https://shruthiadelaide.com.au/wp-content/uploads/2023/06/Carnatic-Music-Reader-1.pdf)
- Raga-dependent pitch movements. [Viraraghavan et al., ISMIR](https://archives.ismir.net/ismir2017/paper/000082.pdf)
- Adult pitch matching and immediate visual feedback. [Berglin, Pfordresher and Demorest](https://journals.sagepub.com/doi/full/10.1177/03057356211026730) and [live voice model study](https://www.sciencedirect.com/science/article/pii/S0892199713000027)

## Live shruti and swara practice

| ID | Requirement | Acceptance |
| --- | --- | --- |
| R7 | Match or set shruti. | Play Sa and then hum it. See measured Hz and signed cents from Sa. After a stable hum, use that frequency as Sa. Play the new Sa or drone to confirm it by ear. Changing the tonic or octave returns to the keyboard reference. |
| R8 | See where your singing lands. | In Follow voice, highlight the nearest degree in the selected scale and show signed cents from it. In Mayamalavagowla the strip includes Sa, Ri₁, Ga₃, Ma₁, Pa, Dha₁, Ni₃ and upper Sa. Distinguish the two Sa positions. Clear the detected highlight for silence or playback. |
| R9 | Practice a specific swara with feedback. | In Match a swara, tap a tile to aim for it, hear its reference and sing it back. Mark the intended swara separately from the detected swara. Show whether to raise or lower pitch relative to the intended swara, even if the detected note is closer to a different swara. Advance through the scale at your own pace. |

Use the tracker for steady notes. Set Sa deliberately and check that its octave feels comfortable. The app can estimate a hum's frequency. A phrase alone can have several plausible tonics, so choosing the musical Sa remains a separate step.

| ID | Requirement | Acceptance |
| --- | --- | --- |
| R10 | Choose shruti from the practice panel without knowing your starting key. | Pick a note and octave or hum a comfortable Sa. Show the closest keyboard note with its octave and the signed cents from it before capture. Let the learner keep the exact hum or return to the keyboard reference. |

| ID | Requirement | Acceptance |
| --- | --- | --- |
| R11 | Hear the swara and practice over the selected Sa drone. | Tapping a practice swara selects and plays it in the current tuning. The drone can run with the mic on and continues through practice reference playback. The tracker pauses during short reference tones and resumes afterward, including while the drone remains on. Ask the learner to use headphones, and require the drone to be off when capturing a new Sa. |

## Pitch Explorer playback cues

| ID | Requirement | Acceptance |
| --- | --- | --- |
| R12 | Associate each sound with its note label. | Play Scale highlights the card for the sounding note, including separate cards for lower and upper Sa or Do. Highlight clears during rests, on Stop, and when settings change. |
| R13 | Set a useful starting register and practice speed. | Explain that the octave selects the register of Sa or Do. For example, A3 is 220 Hz and A4 is 440 Hz. Offer Single, Double and Quadruple speed at one, two and four notes per beat for the scale and sarali starter. |
| R14 | Start from a familiar piano reference. | Default to C4 (middle C, approximately 261.63 Hz) in both the explorer and practice panel. Label octave 4 and keep all tonic and octave choices available. |
| R15 | Loop the scale or sarali starter for repeated listening. | Repeat playback is off by default. The Play button honors it for the selected exercise and speed. Changing the exercise stops the active loop. Turning repeat off stops the loop. |
| R16 | Play the selected Sa drone with either exercise. | A shared drone toggle works in the explorer and practice panel. Toggling the drone leaves the exercise running. Switching exercises preserves the drone. Stop sound stops both. |
| R17 | Match the first sarali varisai turnaround. | Play two eight-note phrases. Upper Sa ends the ascent and is sounded again to start the descent. Looping starts the next ascent on lower Sa after the previous descent ends on lower Sa. |
| R18 | Practice Sarali Varisai from one dashboard. | Selecting Sarali Varisai 1 shows Arohanam and Avarohanam together. One Play action runs both rows, highlighting the sounding tile, including the two Sa′ attacks. Keep tuning and playback controls below the rows. Other selections show a single scale row. |
| R19 | Practice swara names and Aakaram over the same phrase. | Offer Pure tone and a synthesized ā reference in Pitch Explorer. Both follow the same pitch, speed and highlights. Distinguish the synthesized sound from a sung vocal model. |
| R20 | Keep Carnatic note tiles focused on swaras. | Show swara and frequency by default. Let the learner show or hide keyboard note names without interrupting playback. |

[Sarali Varisai 1 notation and laya pattern](https://carnatic-circle.com/carnatic-lessonsnotes/varisais/sarali-varisai/) · [Ganabadi Academy’s Mayamalavagowla practice notation](https://www.ganabadi.com/lessons/unit-1/practicals) · [Ganamrutha Prachuram’s author page](https://www.ganamruthaprachuram.com/author)
