Calcolatore di circonferenza

Invia un numero e ne riceve uno, nella stessa unità di partenza: se inserisce millimetri ottiene millimetri, se inserisce miglia ottiene miglia. Non c'è alcuna politica di arrotondamento da configurare né approssimazioni nascoste oltre al valore di pi greco in doppia precisione presente in ogni runtime moderno, quindi il risultato è deterministico e riproducibile ovunque. Lo stesso codice che gira sul nostro edge gira gratis nel suo browser: lo strumento web gratuito e l'API a pagamento non possono mai discordare. Lo usi per componenti, ruote, anelli, tubi, piste e per qualsiasi oggetto di cui conosce la misura nel mezzo e di cui le serve il perimetro.

Perché il diametro e non il raggio

La maggior parte delle formule scolastiche scrive la circonferenza come due pi greco r, basata sul raggio. In officina e sul campo, però, quasi nessuno misura direttamente un raggio: si misura da un lato all'altro del cerchio con un calibro, un metro a nastro o un laser, perché il diametro è la dimensione che si può davvero toccare. Il calcolatore di circonferenza è costruito su questa realtà. Accetta il diametro così com'è misurato e lo moltiplica per pi greco, il che è algebricamente identico alla forma due pi greco r ma salta la divisione per due, che aggiunge un punto in più dove sbagliare. Se invece ha in mano un raggio, lo raddoppi prima di chiamare il servizio, oppure usi uno strumento basato sul raggio. Se ha la circonferenza e vuole risalire al 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 la lunghezza del contorno, e tutto il resto — zero, un valore negativo, un campo mancante, una stringa che non è un numero — viene rifiutato come input non valido prima di qualsiasi calcolo.

Come viene calcolato il numero

Il calcolo è un'unica moltiplicazione: il diametro, validato come numero positivo e finito, per Math.PI, la costante in doppia precisione disponibile in ogni motore JavaScript. Non ci sono sviluppi in serie, tabelle di consultazione né approssimazioni iterative, quindi il risultato 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 moltiplicazione in virgola mobile può produrre oscillazioni sull'ultima cifra da una CPU all'altra, e un esempio di riferimento confrontato byte per byte fallirebbe su una macchina diversa per un motivo che non ha nulla a che vedere con la correttezza. Sei decimali vanno ben oltre ciò che qualsiasi misura fisica di un diametro giustifichi: un calibro preciso al centesimo di millimetro vincola la circonferenza molto più di quanto faccia pi greco. Le unità passano inalterate: lo strumento non converte mai, quindi l'unità del suo diametro è l'unità della risposta, e convertire prima le unità è una sua scelta.

Dove si inserisce nel lavoro reale

La geometria a valore singolo sembra banale finché non finisce dentro una pipeline che consuma migliaia di misurazioni. Una stazione di taglio che trasforma le letture dei diametri in lunghezze di nastri o strisce, uno strumento di preventivazione che calcola il prezzo del materiale circolare in base al perimetro, un controllo di tolleranza che confronta un albero misurato con una fascia espressa come circonferenza: tutti chiamano questo endpoint come un passo deterministico che non devono mai reimplementare né ritestare. Poiché la capability è un worker puro di parsing, senza chiamate di rete, segreti o stato condiviso, si comporta in modo identico con una richiesta o con diecimila, e il suo costo è fisso: $0.002 a richiesta, senza sovrapprezzi per unità. La versione gratuita nel browser esegue lo stesso modulo, quindi un tecnico può verificare manualmente un valore prima di collegare l'API in produzione, con la certezza 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 attendibili.