Calculateur d’erreur d’accord en cents

Les fréquences invalides ou non positives échouent avec invalid_input et ne sont pas facturées.

Ce que signifie l’erreur d’accord en cents pour le travail fin de hauteur

Par définition, l’intervalle entre deux fréquences positives f_high et f_low vaut mille deux cents fois le logarithme en base deux de leur rapport ; appliqué à l’accord, l’erreur vaut mille deux cents fois log2 du joué divisé par la cible.

Contrat d’entrée, champs de réponse et comportement d’erreur

Exemple : played quatre cent trente-huit contre quatre cent quarante donne une petite erreur négative — trop bas — donc vous relevez le ton. Conservez les deux valeurs dans la même unité (hertz) et dans les limites de magnitude déclarées afin que le rapport reste fini et positif. Envoyez en POST un corps JSON avec deux nombres finis strictement positifs obligatoires : played, la fréquence sonore observée en hertz, et target, la hauteur visée en hertz. Des alias tels que played_hz, observed, actual ou measured se mappent sur played ; target_hz, intended, desired ou reference se mappent sur target. Chaque champ peut arriver comme nombre JSON ou comme chaîne numérique ; champs manquants, chaînes vides, valeurs non finies et fréquences nulles ou négatives échouent avec invalid_input en nommant le problème, et ces échecs ne consomment pas le solde. En cas de succès le corps renvoie played et target avec un arrondi stable à douze décimales, error_cents comme erreur d’accord signée, abs_error_cents comme valeur absolue, direction comme sharp, flat ou in_tune, ratio comme played sur target, unit égal à cents, une chaîne formula qui réaffirme l’identité log2, un message lisible indiquant s’il faut monter ou baisser le ton, et un tableau steps qui montre l’arithmétique pour l’enseignement ou le débogage. Exemple : played quatre cent quarante-deux hertz contre target quatre cent quarante donne une petite erreur positive d’environ sept virgule huit cinq cents — trop haut — donc vous assouplissez le ton vers le bas. Des fréquences égales renvoient zéro cent et direction in_tune.

Où une API d’erreur d’accord apporte une vraie valeur

Les techniciens d’instruments et les luthiers consignent cordes à vide et positions de sillet comme paires de fréquences et ont besoin d’une erreur en cents déterministe pour les notes de montage et les listes de contrôle qualité. Les responsables d’ensemble qui fixent une hauteur de maison autre que quatre cent quarante hertz (par exemple quatre cent quarante-deux pour des orchestres brillants, ou plus bas pour une interprétation d’époque) placent cette valeur comme target et mesurent la dérive de chaque pupitre sans convertir d’abord en noms de notes. Les concepteurs de patches synth et modulaires comparent les lectures d’oscillateur aux cibles programmées dans des scripts d’automatisation afin que les décalages de detune restent honnêtes entre firmwares et fréquences d’échantillonnage de l’hôte. Les enseignants de musique et les applications d’entraînement montrent à l’apprenant un signal en direct trop haut ou trop bas après qu’un micro ou un détecteur de hauteur a rapporté des hertz ; appeler un petit endpoint de parse évite de réimplémenter log2 en cents dans chaque langage client. Comme l’implémentation est pure parse de niveau A, chaque appel réussi coûte le prix de base publié $0.002 sans jetons de modèle et sans réseau sortant. Épinglez le champ error_cents arrondi dans les tests, rejetez tôt les fréquences non positives, et vous obtenez un guidage d’accord fin reproductible pour les salles de classe, ateliers de réparation et workers en bordure sans monter une pile complète d’analyse musicale à vous.