Tutorial 02: Commands

Learn about commands for controlling notation behavior

Commands control aspects of notation like beat duration, cycle patterns, and layout. Commands start with a backslash.

Beat Duration

The \beatDuration command sets how many notes fit in one beat:

\beatDuration(1) S R G M P D N S. S. N D P M G R S \beatDuration(2) S R G M P D N S. S. N D P M G R S \beatDuration(4) S S R - S S R - S R S S R R G G M M R R G - R R G - R G R R G G M M P P G G M - G G M - G M G G M M P P D D M M P - M M P - M P M M P P D D N N P P D - P P D - P D P P D D N N S. S. S. S. N - S. S. N - S. N S. S. N N D D P P N N D - N N D - N D N N D D P P M M D D P - D D P - D P D D P P M M G G P P M - P P M - P M P P M M G G R R M M G - M M G - M G M M G G R R S S

This is commonly used to notate different speeds in Carnatic music without changing the actual notation.

Note Durations

You can set the duration of individual notes by prefixing them with a number or fraction:

\beatDuration(4) S 2 R G M

Here, R has a duration of 2 units at the current beat duration (4 notes per beat), making R twice as long as S, G, or M.

Cycle (Tala)

The \cycle command defines the rhythmic pattern (tala). A cycle is made of multiple bars, each with a specified number of beats:

\beatDuration(4) \cycle("|4|2|2|") > ##### Pallavi Sw: s , , r g , p , d , s. , n , d , p , d p m g r s r s .n .d s , , , Sh: Ra , , ra Vē , nu , Go , pa , ba , la , Ra , ji tha Sa th gu na ja ya she , la , > ##### Charanam 1 Sw: s , , r g , p , m , , g - p , d , r. , , s. n , d, p , , m g , r , Sh: Sa , , ra sa , ksha , nē , , ra mē , mi , mA , , ru ba , da , kO , , rva lē , ra ,

The pattern "|4|2|2|" means:

  • First bar: 4 beats
  • Second bar: 2 beats
  • Third bar: 2 beats
  • Total: 8 beats per cycle (Adi Tala)

Creating Lines

The \line command starts a new line in the notation:

\beatDuration(2) \cycle("3|2|2") \breaks(7) Sw: \@label("1.") , , , m g , m , , , p , , m p , , , , , p m p , d , n , s. , , , , r. s. n [d ,, n ] d p , , p m , d p m g , [m , , p ] g , m r \@label("2.") g , , m g , m , , , p , , m p , , , , , p m p , d , n , s. n s. , [g. r. , , ] s. n d n d p , , p s. n d p , p p m g [g , p m ] g , \@label("3.") m r m , g , g p , m m p , , , , , , , , d m p , p d n , s. r. [g. , m. g. r. , g. r.] s. n d , p , , , g. r. s. n d p s. n d p m p m g Sh: , , , Ma na , su , , , svā , , , , , , , , , dhi , , , , , na , mai , , , , , na , , , ā , , , gha , , nu , , ni , , , ki , , , , , , Ma na , su , , , svā , , , , , , , , , dhi , , , , , na , mai , , , , , na , , , ā , , , gha , nu , , , ni , , , ki , , , , , Ma , na , su , , , svā , , , , , , , , , dhi , , , , , na , mai , , , , , na , , , ā , , , gha , nu , , , ni , , , ki , , , \line Sw: \@label("1.") m r m , g , ~g/ m , , , d p m g r g , m g r s , [ r, , g r s ] s , , s s .d ~/ .n , , s , , , - p , , , p s. n d p , p p m g [g , p m ] g , \@label("2.") m r m , g , m p ~/ d n s. n [d p , , p m g , m g r , ] s r [ g , m g r s s , ] , , , , s s .d ~/ .n , , s , , , - m p d n s. r. [g. , m. g. r. , g. r. ] s. n d p m - d p m \@label("g r", position="after") Sh: , , Ma , ri , man , , , , , tra , tan , , , , , tra , , , mu , , , lē , , , , , la , , , ā , , , ghā , , nu , , ni , , , [ki , , , ] , , , , Ma , ri , man , , , , , tra , tan , , , , , tra , , , mu , , , lē , , , , , la , , , ā , , , ghā , nu , , , ni , , , , ki , ,

You can add margin text to lines:

\line("Pallavi") S R G M P D N S. \line("Anupallavi") S. N D P M G R S

Creating Roles

The \role command creates new roles beyond the default Sw and Sh:

\role("Perc", notes=true) Sw: S R G M P D N S. Sh: sa ri ga ma pa dha ni sa Perc: ta ki ta ta ta ki ta ta

Practice Exercise

Create a notation with varying beat durations and multiple lines:

\cycle("|4|2|2|") \beatDuration(2) \line("First Speed") Sw: S R G M P D N S. \beatDuration(4) \line("Second Speed") Sw: S R G M P D N S.

Next Steps