Os números deste site também saem em JSON

O que cada campo quer dizer

Um esquema JSON diz que hz é um número. Ele não diz de onde o número veio, nem o que acontece se você usá-lo com uma referência de afinação diferente. Esta seção é a parte que um cliente gerado automaticamente não recebe, e é por ela que vale ler a documentação antes de consumir o primeiro endpoint.

hz — calculado, não medido

Cada frequência sai do número MIDI da nota em temperamento igual, com o lá central em 440 Hz. Nenhum valor foi copiado de uma tabela e nenhum foi medido com microfone. A consequência prática é boa: quem afina com o lá em 432 Hz ou em 442 Hz não precisa de outra tabela, precisa de uma multiplicação — a frequência da corda vezes a referência dividida por 440. A consequência desagradável é que uma corda real, num instrumento real, com tensão real, nunca soa exatamente isso; o afinador do site mostra o desvio em cents justamente porque o desvio é a informação útil.

string_count não é strings.length

A viola caipira tem dez cordas em cinco pares. O campo string_count diz dez, porque é o instrumento que está sendo descrito, e o array strings de cada afinação tem cinco entradas, porque cada par é afinado na mesma nota ou em oitava e se comporta como uma corda só quando se toca. Os dois números estão certos e não são o mesmo número. Quando eles diferem, o campo courses aparece para dizer isso em voz alta, em vez de deixar a contradição implícita. Quem contar o array e anunciar que a viola caipira tem cinco cordas vai estar errado por um motivo que o JSON avisou.

reentrant — quando o array não sobe

Numa afinação reentrante alguma corda soa abaixo da anterior. O caso clássico é o ukulele soprano em GCEA: a quarta corda é um sol agudo, acima do dó da terceira, e é exatamente isso que dá ao instrumento o timbre pelo qual ele é reconhecido. A tentação de ordenar o array por frequência, para “arrumar”, destrói a única informação que ele carrega, que é a ordem física das cordas no braço. O campo existe para que ninguém precise descobrir isso comparando números.

frets — casas absolutas, seis posições

O array de casas tem sempre seis posições e vai da sexta corda, o mi grave, para a primeira, o mi agudo. Zero é corda solta, menos um é corda que não se toca, e qualquer outro número é a casa pressionada em valor absoluto. Absoluto é a palavra que evita o erro mais comum: quando existe pestana, barre.fret descreve onde ela está, e as casas do array já contam a partir do braço inteiro. Somar uma coisa à outra produz um acorde três casas acima do que alguém pediu, e ele soa perfeitamente afinado, o que torna o defeito difícil de perceber.

pitch_classes e sounding_notes respondem coisas diferentes

O primeiro é teoria: as notas do acorde pela fórmula, sem oitava e sem repetição. Serve para a pergunta “quais notas tem um acorde de si menor”. O segundo é o que aquela mão, naquele braço, realmente soa — calculado das casas mais a afinação padrão, com oitava, com as repetições e na ordem das cordas. Serve para “qual é a nota mais grave dessa posição” e para transpor. Publicar os dois juntos é o que torna o dado verificável: qualquer pessoa pode somar os semitons e conferir se a digitação e a fórmula concordam.

Graus, cifras e a grafia que parece detalhe

Uma progressão é identificada pelos graus, porque é o grau que transpõe. A caixa do numeral romano carrega a qualidade do acorde: maiúscula é maior, minúscula é menor, o sinal de grau é diminuto, e o b de bVII é um acidente, não uma marca de menor. As cifras em cada tom vêm calculadas, e a grafia segue o tom relativo maior e não o tom como foi digitado — ré menor pertence a fá maior, então o quarto grau de ré menor é si bemol e não lá sustenido. Parece detalhe de notação até o momento em que alguém imprime uma cifra que nenhum músico no Brasil escreve daquele jeito.

bpm: null é uma resposta, não um buraco

Só parte dos gêneros traz faixa de andamento, e isso é deliberado. Um número inventado para completar a tabela seria pior do que a ausência, porque um número tem cara de fato mesmo quando não é — e este site é citado por modelos, que não têm como distinguir uma medida de um palpite bem formatado. Onde a faixa existe, o campo note vale tanto quanto os dois números: é ele que diz que o forró abriga xote, baião e arrasta-pé em andamentos diferentes, e que a bossa nova é contada em dois, e por isso soa muito mais lenta do que os 120 a 140 sugerem.