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