Da Circonferenza a Raggio

Invia un numero e ne riceve uno, nella stessa unità di partenza: se fornisce millimetri, la risposta è in millimetri, se fornisce piedi, la risposta è in piedi. È l'inverso della nota formula due pi greco r, risolta per il raggio così non deve mai riarrangiarla a mano. Non c'è alcuna politica di arrotondamento da configurare né approssimazioni nascoste oltre al valore in doppia precisione di pi greco integrato in ogni runtime moderno, quindi il risultato è deterministico e riproducibile ovunque. Lo stesso codice che gira sul nostro edge gira gratis nel Suo browser, per cui lo strumento web gratuito e l'API a pagamento non sono mai in disaccordo. Lo usi quando il contorno è ciò che può misurare — un metro avvolto intorno a un tubo, il rotolamento di una ruota, la lunghezza interna di un anello — e il raggio è ciò che il disegno o la macchina richiedono davvero.

Perché partire dalla circonferenza

A scuola si insegna prima il raggio e da esso si ricava tutto il resto, ma in officina e sul campo la circonferenza è spesso l'unica dimensione che può davvero toccare. Avvolge un metro attorno a un barile, fa rotolare una ruota per un giro completo sul terreno, misura la lunghezza interna di una guarnizione o della fascia che chiude un anello. In tutti questi casi la lunghezza del contorno è la misura e il raggio è l'incognita, eppure la maggior parte dei calcolatori chiede il raggio e restituisce la circonferenza, costringendola a invertire la formula a mano con una divisione facile da sbagliare. Il calcolatore da circonferenza a raggio è costruito attorno alla realtà misurata: accetta la circonferenza così come letta e la divide per due pi greco, restituendo il raggio nella stessa unità. Se invece ha in mano il diametro, lo dimezzi e ha già il raggio; se ha la circonferenza e vuole il diametro, quel problema inverso appartiene a un'altra capability. Un solo input e un solo compito rendono il contratto banale da testare: entra un numero positivo e finito, esce il raggio, e tutto il resto — zero, un valore negativo, un campo mancante, una stringa non numerica — viene rifiutato come input non valido prima di qualsiasi calcolo.

Come viene calcolato il numero

Il calcolo è una sola divisione: la circonferenza, validata come numero positivo e finito, divisa per due volte Math.PI, la costante in doppia precisione disponibile in ogni motore JavaScript. Non c'è sviluppo in serie, tabella di ricerca né approssimazione iterativa, quindi la risposta non può variare tra esecuzioni, tra server o tra browser e API. Il risultato viene poi arrotondato a sei cifre decimali prima di essere restituito. Questo arrotondamento è una scelta deliberata di stabilità, non una dichiarazione di precisione: la divisione in virgola mobile grezza può produrre un'oscillazione sull'ultima cifra tra CPU diverse, e un esempio di riferimento confrontato byte per byte fallirebbe su un'altra macchina per un motivo che non ha nulla a che vedere con la correttezza. Sei decimali vanno ben oltre ciò che qualsiasi misura fisica di una circonferenza giustifica — un metro letto al decimo di millimetro vincola il raggio molto più di quanto faccia pi greco. Le unità passano intatte: lo strumento non converte mai, quindi qualunque sia l'unità della Sua circonferenza è l'unità della risposta, e convertire le unità prima spetta a Lei. Una stringa numerica come "31.415927" è accettata e convertita, il che mantiene semplici l'invio di moduli e le pipeline basate su CSV senza allentare la validazione.

Dove si inserisce nel lavoro reale

La geometria a valore singolo sembra banale finché non finisce dentro una pipeline che consuma migliaia di misure. Una stazione di laminazione che trasforma le distanze di rotolamento in raggi di ruota, un pianificatore di lavorazione che ricava il raggio di tornitura dal perimetro misurato di un pezzo, un controllo di accoppiamento che confronta la lunghezza misurata di un anello con una fascia di tolleranza espressa come raggio — tutti chiamano questo endpoint come un passo deterministico che non devono mai reimplementare né ritestare. Poiché la capability è un worker di analisi puro, senza chiamate di rete, senza segreti e senza stato condiviso, si comporta identicamente con una richiesta o con diecimila, e il suo costo è un flat $0.002 a richiesta senza sovrapprezzo per unità. La versione gratuita nel browser esegue lo stesso modulo, così un tecnico può verificare un valore a mano prima di collegare l'API alla produzione e fidarsi che entrambi i percorsi restituiscano lo stesso numero. Un input che non è un numero positivo e finito fallisce con un errore di input non valido e non viene addebitato, il che rende l'endpoint sicuro da esporre direttamente a invii di moduli non fidati, fogli di calcolo e flussi di dati estratti.