Círculo de pernos

El número de taladros debe ser un entero positivo; un cero, una fracción o un valor negativo falla con invalid_input y no se factura.

Qué es un círculo de pernos y cómo se forman las coordenadas

Dado un centro (center_x, center_y), un diámetro de circunferencia, un número de taladros n y un ángulo inicial en grados, el radio r es la mitad del diámetro y el paso angular son 360 grados divididos entre n. El agujero i, contado desde cero, queda en el ángulo polar theta igual a start_angle más i veces 360 entre n. Las coordenadas cartesianas siguen la identidad x igual a center_x más r por el coseno de theta e y igual a center_y más r por el seno de theta, con theta convertido a radianes solo dentro de la llamada trigonométrica. Esa es la convención de la mayoría de sistemas CAD y de la conversión polar a cartesiana; si su plano coloca el agujero uno a las doce, envíe start_angle como noventa. Un patrón de cuatro taladros sobre un diámetro de cien con centro en el origen y start_angle cero produce agujeros en (50, 0), (0, 50), (−50, 0) y (0, −50), la cruz clásica que el maquinista usa como comprobación.

Contrato de entrada, forma de la respuesta y errores

Un diámetro no positivo se rechaza porque un círculo de pernos con diámetro nulo o negativo no puede colocar taladros a un radio real. Una cadena de fórmula reescribe la identidad polar para que pueda auditar una coordenada sin leer el código. Combine la respuesta con su propio escritor DXF o G-code si necesita un archivo de dibujo; este extremo solo devuelve coordenadas y no emite gráficos, trayectorias ni listas de fijaciones. Envíe por POST un cuerpo JSON con cinco números. center_x y center_y sitúan el centro de la circunferencia en su plano de dibujo; pueden ser cero, negativos o grandes, y aceptan los alias cx, centre_x y cy, centre_y. diameter es el diámetro de círculo de paso que pasa por los centros de los taladros, no el diámetro de los agujeros, y debe ser un número finito estrictamente positivo; los alias incluyen d, pcd, bcd, circle_diameter y pitch_diameter. hole_count es el número de taladros igualmente espaciados y debe ser un entero positivo de uno a mil; los alias incluyen n, count, holes y num_holes. start_angle es el ángulo polar del agujero uno en grados, con alias angle, theta, start y starting_angle. El campo opcional precision, con alias decimals y dp, elige los decimales de cada campo numérico de la respuesta, con valor por defecto ocho y tope quince para que los goldens JSON se mantengan estables. Los campos ausentes, las cadenas vacías, los valores no finitos y las magnitudes por encima del techo admitido fallan con invalid_input nombrando el campo. Un hole_count que no sea un entero positivo —cero, un número negativo, una fracción como cuatro punto cinco o una cadena no numérica— falla con un mensaje que nombra hole_count y exige un entero positivo; esos fallos no se facturan. En el éxito el cuerpo repite el centro analizado, el diámetro, el radio, hole_count, start_angle y angle_step, y luego lista los agujeros como objetos con índice desde uno, ángulo envuelto en grados, x e y.

Dónde resulta útil una calculadora de círculo de pernos

Los programadores CNC emiten un círculo de pernos como lista de destinos XY para un ciclo de taladrado, y una API determinista gana a una hoja con unidades mezcladas y una celda oculta que aún dice cuatro taladros y medio. Como la implementación es parse de nivel A, cada llamada exitosa cuesta el precio base publicado $0.002 sin tokens de modelo y sin red de salida, y la validación fallida no consume saldo. En esta página el trabajo corre por completo en su navegador; a través de la API cada consulta exitosa cuesta $0.002, no se guarda nada tras devolver la respuesta y el resultado matemático es idéntico.