Calcolatore errore di accordatura in cents

Frequenze non valide o non positive falliscono con invalid_input e non vengono addebitate.

Cosa significa l’errore di accordatura in cents nel lavoro fine di altezza

Per definizione, l’intervallo tra due frequenze positive f_high e f_low è milleduecento volte il logaritmo in base due del loro rapporto; applicato all’accordatura, l’errore è milleduecento volte log2 del suonato diviso l’obiettivo.

Contratto di ingresso, campi di risposta e comportamento d’errore

Esempio: played quattrocentotrentotto contro quattrocentoquaranta produce un piccolo errore negativo — troppo basso — quindi Lei alza il tono. Mantenga entrambi i valori nella stessa unità (hertz) e entro i limiti di magnitudine dichiarati così che il rapporto resti finito e positivo. Invii in POST un corpo JSON con due numeri finiti strettamente positivi obbligatori: played, la frequenza sonora osservata in hertz, e target, l’altezza intesa in hertz. Alias come played_hz, observed, actual o measured mappano su played; target_hz, intended, desired o reference mappano su target. Ogni campo può arrivare come numero JSON o come stringa numerica; campi mancanti, stringhe vuote, valori non finiti e frequenze nulle o negative falliscono con invalid_input indicando il problema, e tali fallimenti non consumano saldo. In caso di successo il corpo riecheggia played e target con arrotondamento stabile a dodici decimali, error_cents come errore di accordatura con segno, abs_error_cents come valore assoluto, direction come sharp, flat o in_tune, ratio come played su target, unit impostato a cents, una stringa formula che ribadisce l’identità log2, un messaggio leggibile che indica se alzare o abbassare il tono, e un array steps che mostra l’aritmetica per l’insegnamento o il debug. Esempio: played quattrocentoquarantadue hertz contro target quattrocentoquaranta produce un piccolo errore positivo di circa sette virgola otto cinque cents — troppo alto — quindi Lei alleggerisce il tono verso il basso. Frequenze uguali restituiscono zero cents e direction in_tune.

Dove un’API di errore di accordatura rende davvero

Tecnici di strumenti e liutai registrano corde a vuoto e posizioni di capotasto come coppie di frequenze e necessitano di un errore in cents deterministico per note di setup e checklist di QC. Responsabili d’ensemble che impostano un’altezza di sala diversa da quattrocentoquaranta hertz (ad esempio quattrocentoquarantadue per orchestre brillanti, o più bassa per esecuzione storicistica) usano quel valore come target e misurano la deriva di ogni sezione senza convertire prima in nomi di note. Progettisti di patch synth e modulari confrontano letture di oscillatore con obiettivi programmati in script di automazione così che gli offset di detune restino onesti tra firmware e frequenze di campionamento dell’host. Educatori musicali e app di pratica mostrano all’allievo un segnale live di troppo alto o troppo basso dopo che un microfono o un rilevatore di altezza riporta hertz; chiamare un piccolo endpoint di parse evita di reimplementare log2 in cents in ogni linguaggio client. Poiché l’implementazione è parse puro di livello A, ogni chiamata riuscita costa il prezzo base pubblicato $0.002 senza token di modello e senza rete in uscita. Fissi il campo error_cents arrotondato nei test, rifiuti presto le frequenze non positive e otterrà una guida di accordatura fine riproducibile per aule, officine di riparazione e worker di edge senza erigere una pila completa di analisi musicale propria.