Interface Maqam

Represents a concrete, tuning-system-specific maqam with actual pitch classes.

This interface represents a maqam that has been "realized" within a specific tuning system, containing actual pitch classes with frequencies and intervallic relationships for both ascending and descending sequences. Unlike MaqamData (which contains only abstract note names), a Maqam interface instance is playable and can be used for audio synthesis and comprehensive analysis.

Tahlil vs Taswir:

• Tahlil (transposition: false): The original form of the maqam starting from its traditional root note (e.g., Maqam Farahfazza starting on yegah)
• Taswir (transposition: true): A transposition of the maqam starting from a different pitch class while preserving intervallic relationships and directional characteristics (e.g., Maqam Farahfazza al-Rast starting on rast)

Advanced Features:

• Embedded ajnas analysis: Algorithm identifies all possible ajnās patterns within both ascending and descending sequences using cents tolerance matching
• Automatic transposition: Both sequences and embedded ajnas are systematically transposed while maintaining authentic intervallic structure
• Suyūr integration: Associated melodic development pathways are automatically transposed with note name conversion and jins/maqam reference adjustment

The transposition algorithm separately processes both sequences, ensuring all required note names exist within the tuning system's four octaves before generating a valid transposition.