Module metadata 

A score’s title, composer and the rest of what is said about it. A score’s metadata: music21’s metadata.Metadata.

music21 keeps metadata as named values, each name a unique name from a fixed vocabulary drawn from Dublin Core, the MARC relator terms and Humdrum’s reference records, or one a caller made up. A name may carry several values, and the names keep the order they were first given in, which is the order a MusicXML writer puts them out in.

A contributor is a value with a role: the composer, an arranger, a lyricist. Its unique name is its role where the role is in the vocabulary, and otherContributor where it is not.

Modules

primitives

The values a score’s metadata is made of: music21’s metadata.primitives.

Structs

Metadata

A score’s metadata: named values in the order the names were first given.

MetadataMatch

What a Metadata::search found: the text that matched and the field it answers under. A contributor with a made-up role answers under that role, and one with no role at all under no field, which is music21’s (True, None).

MetadataValue

One value of a metadata name: its text and, for a contributor or a copyright, the role it was given – and the primitive it is, which says what more is known about it.

Enums

MetadataContent

What a metadata value says beyond its text and its role: one of music21’s primitives.

MetadataQuery

What a Metadata::search asks of one value’s text.

ValueKind

What kind of value a metadata name takes: music21’s UNIQUE_NAME_TO_VALUE_TYPE, which is what its convertValue reads to decide what to make of whatever it was handed.

Constants

OLD_MUSIC21_NAMES

The unique names music21 kept an older spelling of: its oldMusic21Abbrev and oldMusic21WorkId, both of which Metadata::search takes as a field name. Each row is the unique name, its Humdrum abbreviation and the work id it was written as before music21 v8.

STANDARD_PROPERTIES

music21’s STANDARD_PROPERTY_DESCRIPTIONS: each property’s unique name, its namespaced name, and whether it names a contributor.

Functions

is_contributor_unique_name

Whether a unique name is one of the vocabulary’s contributor names: music21’s _isContributorUniqueName.

is_standard_name

Whether a name is one the vocabulary knows, by its unique name or by its namespaced one: music21’s isStandardName. A name of music21’s own older vocabulary – a work id or its abbreviation – is not one of these, as music21’s answer is not either.

namespace_name

The namespaced name a unique name stands for, humdrum:OPC for localeOfComposition: music21’s uniqueNameToNamespaceName. A name outside the vocabulary has none.

unique_name_from_namespace

The unique name a namespaced name stands for, localeOfComposition for humdrum:OPC: music21’s namespaceNameToUniqueName. A name outside the vocabulary stands for none.

unique_name_of

The unique name an attribute name stands for: the name itself, one of music21’s four grandfathered work ids, or one of its twenty Humdrum abbreviations. Nothing for a name outside the vocabulary.

unique_name_of_plural

The unique name a plural attribute of music21’s answers for, composer for composers: music21’s ALL_PLURAL_ATTRIBUTE_NAMES, each of which answers every value under the name rather than the first.

value_kind_of

What kind of value a unique name takes, and nothing for a name outside the vocabulary – which music21 keeps as a text, there being nothing to say otherwise.