Differentia Model - DDMAL/CantusDB GitHub Wiki

Differentia (code) is a model in the main_app app. It inherits from BaseModel.

A differentia is a formulaic six-syllable melodic pattern; in manuscripts, they usually occur after antiphons, above the letters "euouae". Each Differentia object represents a corresponding ID in the differentiae database. More information about differentiae can be found on the Differentiae Database "About" page. Differentiae are associated with Chants, where each chant may have a differentia ID along with its volpiano transcription on the Chant Detail View.

The values for the fields below came from a CSV file provided by Jan in 2023. Ideally, we would get these values from an API provided by the Differentiae Database so we could update them from time to time, but such an API is not currently known to exist.

Fields

  • differentia_id: a string corresponding to the differentia ID. values like 129a get stored here

  • melodic_transcription: a string representing the volpiano transcription of the differentia. Values like 1--k-k-l-j-k-h--4 get stored here.

  • mode: A string corresponding to the differentia database information on mode, but we don't expect to ever need to display it

  • inherited from BaseModel:

    • date_created
    • date_updated
    • created_by
    • last_updated_by

Methods

  • inherited from BaseModel:
    • save()
    • display_name (property)
    • get_absolute_url()
    • get_verbose_name()
    • get_verbose_name_plural(): "differentiae"
    • get_fields_and_properties()